int aw_avatar_set (int session_id)

DESCRIPTION

Set a users avatar and gesture.

CALLBACK

None (returns immediately)

NOTES

This method is new in Active Worlds 3.4 and requires at least SDK build 27 and world server build 44.

The argument session_id specifies the user to set.   The users avatar and gesture are set to the values specified by AW_AVATAR_TYPE and AW_AVATAR_GESTURE.

AW_EVENT_AVATAR_CHANGE is used to determine when your own avatar is set. During this event, AW_AVATAR_SESSION should be compared to aw_session () to determine if it is your own session.

The calling instance must be owned by a caretaker in order to use aw_avatar_set.

EXAMPLE

/* set a users avatar & gesture */
void set_avatar (int session, int type, int gesture)
{

  aw_int_set (AW_AVATAR_TYPE, type);
  aw_int_set (AW_AVATAR_GESTURE, gesture);
  if (aw_avatar_set (session))
    printf ("Unable to set avatar for session %d\n", session);
  else
    printf ("Set avatar for session %d\n", session);

}

SEE ALSO

AW_EVENT_AVATAR_CHANGE