Triggers an object-click event.
None (returns immediately)
This method requires at least SDK build 14 and world server build 21.
aw_object_click triggers the event AW_EVENT_OBJECT_CLICK 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 left-clicks on an object 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 clicked object is uniquely identified by the attributes AW_OBJECT_X, AW_OBJECT_Z, and AW_OBJECT_NUMBER.
void click_object (int x, int z, int number)
{
int rc;
/* simulate a user left-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_click ())
printf ("Object click failed (reason %d)\n", rc);
}