AW_EVENT_OBJECT_ADD

DESCRIPTION

Event called when an object has been added or changed in your area.

NOTES

This event is only called when you are already fully up to date in this area.

Changes to existing objects are sent to your application as an AW_EVENT_OBJECT_ADD event followed immediately by an AW_EVENT_OBJECT_DELETE  event.  In other words, object changes are actually implemented as an addition of the object in its new state followed by a deletion of the old object.

During this event the following attributes are defined:

AW_OBJECT_SESSION
AW_CELL_SEQUENCE
AW_CELL_X
AW_CELL_Z
AW_OBJECT_NUMBER
AW_OBJECT_OWNER
AW_OBJECT_BUILD_TIMESTAMP
AW_OBJECT_X
AW_OBJECT_Y
AW_OBJECT_Z
AW_OBJECT_YAW
AW_OBJECT_TILT
AW_OBJECT_ROLL
AW_OBJECT_MODEL
AW_OBJECT_DESCRIPTION
AW_OBJECT_ACTION

Note that if your application is maintaining a sequence array for this zone (see aw_query), it should update the sequence array using the values of AW_CELL_X, AW_CELL_Z, and AW_CELL_SEQUENCE to avoid re-downloading this same object on future calls to aw_query.

See Property for a complete description of property in Active Worlds.

EXAMPLE

void object_add (void)
{

  printf ("Session %d has added a %s nearby", aw_int (AW_OBJECT_SESSION),
    aw_string (AW_OBJECT_MODEL));

}

aw_event_set (AW_EVENT_OBJECT_ADD, object_add);

SEE ALSO

aw_query
aw_object_add
aw_object_change
aw_object_delete
AW_EVENT_OBJECT_DELETE