llDetectedGrab

From Second Life Wiki
Jump to navigation Jump to search

Summary

Function: vector llDetectedGrab( integer number );

Returns a vector that is the grab offset of the user touching the object; only works in the touch event.

• integer number Index of detection information

number does not support negative indexes. Returns <0.0, 0.0, 0.0> if number is out of range or if called from an event other than the touch event.

Caveats

  • If number is out of bounds the script continues to execute without an error message.
All Issues ~ Search JIRA for related Bugs

Examples

<lsl> default {

   state_entry()
   {
       llSetStatus(PRIM_PHYSICS,TRUE);//This allows the object to be "grabbed" and dragged
   }
   touch(integer num_detected)
   {
       llSay(0,(string)llDetectedGrab(0));//Be prepared for a great amount of chatted info.
                                          //The faster you move the mouse while grabbing the object the greater the offset becomes.
                                          //This is not due to the speed but the reaction time of the turn around of the physical prim,
                                          //thus an offset (distance from grab to prim center) is created and measured by this function.
   }

}

</lsl>

See Also

Events

•  touch_start
•  touch
•  touch_end

Functions

•  llPassTouches
•  llSetStatus - STATUS_BLOCK_GRAB Enable / Disable object grabbing

Articles

•  Detected
•  Grab

Deep Notes

Search JIRA for related Issues

Signature

function vector llDetectedGrab( integer number );