int aw_object_select (void)

DESCRIPTION

Triggers an object-select event.

CALLBACK

None (returns immediately)

NOTES

This method requires at least SDK build 14 and world server build 21.

aw_object_select triggers the event AW_EVENT_OBJECT_SELECT in all nearby SDK applications which have subscribed to the event.  It is intended for use by the Active Worlds Browser to indicate when a user selects an object (by right-clicking on it with the mouse), however it is also available for use by SDK applications which may wish to simulate user mouse actions for the purposes of testing, etc.

The selected object  is uniquely identified by the attributes AW_OBJECT_X, AW_OBJECT_Z, and AW_OBJECT_NUMBER.

EXAMPLE

void select_object (int x, int z, int number)
{

  int		rc;

  /* simulate a user right-click on an object */
  aw_int_set (AW_OBJECT_NUMBER, number);
  aw_int_set (AW_OBJECT_X, x);
  aw_int_set (AW_OBJECT_Z, z);
  if (rc = aw_object_select ())
    printf ("Object select failed (reason %d)\n", rc);

}

SEE ALSO

aw_object_click
aw_avatar_click