Vp object click: Difference between revisions

From Virtual Paradise Wiki
Jump to navigation Jump to search
Sleepy E (talk | contribs)
Basic layout
 
Sleepy E (talk | contribs)
No edit summary
 
Line 4: Line 4:
   {{sdk parameter row|int  |object_id  |Id of the clicked object}}
   {{sdk parameter row|int  |object_id  |Id of the clicked object}}
   {{sdk parameter row|int  |session_to |Session ID to send an object click event to, or 0 to send to everyone}}
   {{sdk parameter row|int  |session_to |Session ID to send an object click event to, or 0 to send to everyone}}
   {{sdk parameter row|float |hit_x      |X coordinate of hit (absolute)}}
   {{sdk parameter row|float |hit_x      |X coordinate of hit (world coordinates)}}
   {{sdk parameter row|float |hit_y      |Y coordinate of hit (absolute)}}
   {{sdk parameter row|float |hit_y      |Y coordinate of hit}}
   {{sdk parameter row|float |hit_z      |Z coordinate of hit (absolute)}}
   {{sdk parameter row|float |hit_z      |Z coordinate of hit}}
|attributes=
|attributes=
|returncodes=
|returncodes=

Latest revision as of 19:43, 13 December 2016

Method call snippet vp_object_click(instance, object_id, session_to, hit_x, hit_y, hit_z);

Sends an object click event to other users in the world.

Parameters

These are the parameters that this method requires:

Parameter Usage
VPInstance
instance
Pointer to the instance this method call is intended for
int
object_id
Id of the clicked object
int
session_to
Session ID to send an object click event to, or 0 to send to everyone
float
hit_x
X coordinate of hit (world coordinates)
float
hit_y
Y coordinate of hit
float
hit_z
Z coordinate of hit

Returns

This method returns a return code integer, which indicates whether the call was successful or errored for any reason:

Return code Cause
VP_RC_SUCCESS Successful call (for methods that have a registered callback, it only means the request has been sent)
VP_RC_NOT_IN_WORLD Bot is not currently in a world

Behavior

  • Upon successfully clicking an object, VP_EVENT_OBJECT_CLICK is sent to those who have subscribed to it. If session_to is set to that of a user, then only it will receive the event.

Caveats

  • Coordinates are absolute, not relative to the position to the object.

Examples

This method has no usage examples; please add at least one to this page

See also