Touch

Inspect touch positions, faces, and texture coordinates.

Feature: Input

What do you want to do?

vector llDetectedTouchPos(integer index)Returns the vector position where the object was touched (specified by index) in region coordinates, or in screen-space coordinates if the object is attached as a HUD.integer llDetectedTouchFace(integer index)Returns the integer index of the face clicked by the avatar in the touch event specified by index.vector llDetectedTouchUV(integer index)Returns the texture coordinates (<u, v, 0.0>) where the prim was touched, specified by index. X and Y contain the horizontal (u) and vertical (v) texture coordinates, typically in the interval [0.0, 1.0] (affected by repeats and rotation). Returns TOUCH_INVALID_TEXCOORD if coordinates cannot be determined.

Reference

Find topic entries

13 topic entries

• vector llDetectedGrab(integer number)function

  Returns a vector representing the grab offset of the user touching the object. Only works in touch events and returns <0.0, 0.0, 0.0> if number is not a valid index.

• vector llDetectedTouchBinormal(integer index)function

  Returns the surface binormal vector (tangent to the surface, pointing along the positive T (V) direction of tangent space) at the touched location specified by index. Can be used with llDetectedTouchNormal to determine the tangent space.

• integer llDetectedTouchFace(integer index)function

  Returns the integer index of the face clicked by the avatar in the touch event specified by index.

• vector llDetectedTouchNormal(integer index)function

  Returns the surface normal vector (perpendicular to the surface) at the touched location specified by index. Can be used with llDetectedTouchBinormal to determine the tangent space.

• vector llDetectedTouchPos(integer index)function

  Returns the vector position where the object was touched (specified by index) in region coordinates, or in screen-space coordinates if the object is attached as a HUD.

• vector llDetectedTouchST(integer index)function

  Returns the surface coordinates (<s, t, 0.0>) where the prim was touched, specified by index. X and Y contain the horizontal (s) and vertical (t) face coordinates, typically in the interval [0.0, 1.0]. Returns TOUCH_INVALID_TEXCOORD if coordinates cannot be determined.

• vector llDetectedTouchUV(integer index)function

  Returns the texture coordinates (<u, v, 0.0>) where the prim was touched, specified by index. X and Y contain the horizontal (u) and vertical (v) texture coordinates, typically in the interval [0.0, 1.0] (affected by repeats and rotation). Returns TOUCH_INVALID_TEXCOORD if coordinates cannot be determined.

• llPassTouches(integer pass)function

  Sets the pass-touches attribute. If pass is TRUE, touch events are passed from child prims to the root; if FALSE (default), they only trigger events in the affected child prim.

• llSetClickAction(integer action)function

  Sets the action (a CLICK_ACTION_* flag) performed when an avatar left-clicks the prim.

• llSetTouchText(string text)function

  Displays the string text instead of 'Touch' in the right-click context menu.

• touch_start(integer num_detected)event

  Triggered when an avatar first touches the object. Passes num_detected, representing the number of touching agents.

• touch(integer num_detected)event

  Triggered continuously while an avatar touches the object. Passes num_detected, representing the number of touching agents.

• touch_end(integer num_detected)event

  Triggered when an avatar stops touching the object. Passes num_detected, representing the number of touching agents.