AW_EVENT_OBJECT_DELETE

DESCRIPTION

Event called when an object has been changed or deleted 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_DELETE event followed immediately by an AW_EVENT_OBJECT_ADD event.  In other words, object changes are actually implemented as a deletion of the old object followed by an addition of the object in its new state.

During this event the following attributes are defined:

AW_OBJECT_SESSION
AW_CELL_SEQUENCE
AW_CELL_X
AW_CELL_Z
AW_OBJECT_NUMBER

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_delete (void)
{

  printf ("Session %d has changed or deleted something nearby", 
    aw_int (AW_OBJECT_SESSION));

}

aw_event_set (AW_EVENT_OBJECT_DELETE, object_delete);

SEE ALSO

aw_query
aw_object_add
aw_object_change
aw_object_delete
AW_EVENT_OBJECT_ADD