AW_EVENT_OBJECT_SELECT

DESCRIPTION

Event called when a user selects an object in your area.

NOTES

This event requires at least SDK build 14 and world server build 21.  Also, users must be running Active Worlds Browser build 296 or later in order to trigger this event.

In order to receive this event, you must first announce your position by calling aw_state_change at least once.

This event is triggered whenever a nearby user selects an object (by right-clicking on the object with the mouse.)   It will also be triggered if another nearby SDK application calls aw_object_select.

During this event, the following attributes are defined:

AW_AVATAR_SESSION
AW_AVATAR_NAME
AW_CELL_X
AW_CELL_Z
AW_OBJECT_NUMBER

AW_AVATAR_SESSION and AW_AVATAR_NAME indicate the user that selected the object.  The selected object is uniquely identified by AW_CELL_X, AW_CELL_Z, and AW_OBJECT_NUMBER.

EXAMPLE

void handle_object_select (void)
{

  printf ("%s has selected object #%d in cell (%d,%d)\n", 
    aw_string (AW_AVATAR_NAME), aw_int (AW_OBJECT_NUMBER), 
    aw_int (AW_CELL_X), aw_int (AW_CELL_Z));

}

aw_event_set (AW_EVENT_OBJECT_SELECT, handle_object_select);

SEE ALSO

aw_object_click
aw_object_select