Difference between revisions of "LlDetectedTouchST"

From Second Life Wiki
Jump to navigation Jump to search
m
m (changed texture uuid in example script and comments)
Line 19: Line 19:
|examples=
|examples=
<lsl>
<lsl>
//  whisper touched location upon face
default
default
{
{
Line 25: Line 27:
         integer detectedFace = llDetectedTouchFace(0);
         integer detectedFace = llDetectedTouchFace(0);
         vector detectedTouchST = llDetectedTouchST(0);
         vector detectedTouchST = llDetectedTouchST(0);
        // PUBLIC_CHANNEL has the integer value 0


         if (detectedFace == -1)
         if (detectedFace == -1)
//      {
//          PUBLIC_CHANNEL has the integer value 0
             llWhisper(PUBLIC_CHANNEL, "Sorry, your viewer doesn't support touched faces.");
             llWhisper(PUBLIC_CHANNEL, "Sorry, your viewer doesn't support touched faces.");
 
//      }
        // TOUCH_INVALID_TEXCOORD has the vector value <-1.0, -1.0, 0.0>
//     TOUCH_INVALID_TEXCOORD has the vector value <-1.0, -1.0, 0.0>
         else if (detectedTouchST == TOUCH_INVALID_TEXCOORD)
         else if (detectedTouchST == TOUCH_INVALID_TEXCOORD)
//      {
             llWhisper(PUBLIC_CHANNEL, "Sorry, the surface touch position could not be determined.");
             llWhisper(PUBLIC_CHANNEL, "Sorry, the surface touch position could not be determined.");
 
//      }
         else
         else
//      {
             llWhisper(PUBLIC_CHANNEL, (string)detectedTouchST);
             llWhisper(PUBLIC_CHANNEL, (string)detectedTouchST);
//      }
     }
     }
}
}
</lsl>
</lsl>
<lsl>
<lsl>
// Draws a cross-hair at the detected Location on the detected face.
// with friendly permission of Supremius Maximus
//  who made the texture used in this script
//
//  click&hold the mouse while dragging across
//  the face of the prim


default
default
Line 50: Line 59:
         vector touchST = llDetectedTouchST(0);
         vector touchST = llDetectedTouchST(0);


        // uuid of the texture applied
         string uuid = "23badbe7-6d8c-639b-0131-bb321f8e9db5";
         string uuid = "5ac7995c-4c24-8b60-ae61-6a837619dc75";


         llSetLinkPrimitiveParamsFast(LINK_THIS,
         llSetLinkPrimitiveParamsFast(LINK_THIS, [
             [PRIM_TEXTURE, face, uuid, <1.0, 1.0, 0.0>, touchST, 180*DEG_TO_RAD]);
             PRIM_TEXTURE, face, uuid, <1.0, 1.0, 0.0>, touchST, (float)FALSE,
            PRIM_FULLBRIGHT, ALL_SIDES, TRUE]);
     }
     }
}
}
</lsl>
</lsl>
<lsl>
<lsl>
// Sets a grid of WIDTH by HEIGHT and returns a unique number.
// touchST.x goes across from the left to the right
// The cases of the grid are numbered line by line, left to right,
// touchST.y goes up from the bottom to the top
// starting from the bottom.
//  <0.0, 0.0, 0.0> is in the bottom left corner


integer WIDTH = 12;
integer numberOfRows = 12;
integer HEIGHT = 12;
integer numberOfColumns = 12;
// With a grid of 12x12 (144 cases), you get a number from 0 to 143.


default
default
Line 71: Line 79:
     touch_start(integer total_number)
     touch_start(integer total_number)
     {
     {
         vector st = llDetectedTouchST(0);
         vector touchST = llDetectedTouchST(0);
         integer x = llFloor(st.x * WIDTH);
         integer columnIndex = llFloor(touchST.x * numberOfColumns);
         integer y = llFloor(st.y * HEIGHT);
         integer rowIndex = llFloor(touchST.y * numberOfRows);
         integer button = (y * WIDTH) + x;      
         integer cellIndex = (rowIndex * numberOfColums) + columnIndex;
         llOwnerSay("(" + (string)x + "," + (string)y + ") --> " + (string)button);
 
         llSay(PUBLIC_CHANNEL, "(" + (string)columnIndex + ", " + (string)rowIndex + ") --> " + (string)cellIndex);
     }
     }
}
}

Revision as of 12:46, 8 November 2012

Summary

Function: vector llDetectedTouchST( integer index );
0.0 Forced Delay
10.0 Energy

Returns a vector that is the surface coordinates for where the prim was touched. The x & y vector positions contain the horizontal (s) & vertical (t) face coordinates respectively (<s, t, 0.0>). Each component is in the interval [0.0, 1.0] with the origin in the bottom left corner.[1]

TOUCH_INVALID_TEXCOORD is returned when the surface coordinates cannot be determined. See Caveats for further details.

• integer index – Index of detection information

index does not support negative indexes. For the touch category of events only. The prim that was touched may not be the prim receiving the event, use llDetectedLinkNumber to check for this; likewise you can use llDetectedTouchFace to determine which face was touched.

Caveats

  • If index is out of bounds the script continues to execute without an error message.
  • TOUCH_INVALID_TEXCOORD is returned when...
    • The avatar's viewer does not support face touch detection.
    • The touch has moved off the surface of the prim.
    • The touch happened too close to the edge of the face to determine a location.
    • The event triggered is not a touch event.

Examples

<lsl> // whisper touched location upon face

default { 

   touch_start(integer num_detected)
   {
       integer detectedFace = llDetectedTouchFace(0);
       vector detectedTouchST = llDetectedTouchST(0);

       if (detectedFace == -1)

// { // PUBLIC_CHANNEL has the integer value 0 

           llWhisper(PUBLIC_CHANNEL, "Sorry, your viewer doesn't support touched faces.");

// } // TOUCH_INVALID_TEXCOORD has the vector value <-1.0, -1.0, 0.0> 

       else if (detectedTouchST == TOUCH_INVALID_TEXCOORD)

// { 

           llWhisper(PUBLIC_CHANNEL, "Sorry, the surface touch position could not be determined.");

// } 

       else

// { 

           llWhisper(PUBLIC_CHANNEL, (string)detectedTouchST);

// } 

   }

} </lsl> <lsl> // with friendly permission of Supremius Maximus // who made the texture used in this script // // click&hold the mouse while dragging across // the face of the prim

default { 

   touch(integer num_detected)
   {
       integer face = llDetectedTouchFace(0);
       vector touchST = llDetectedTouchST(0);

       string uuid = "23badbe7-6d8c-639b-0131-bb321f8e9db5";

       llSetLinkPrimitiveParamsFast(LINK_THIS, [
           PRIM_TEXTURE, face, uuid, <1.0, 1.0, 0.0>, touchST, (float)FALSE,
           PRIM_FULLBRIGHT, ALL_SIDES, TRUE]);
   }

} </lsl> <lsl> // touchST.x goes across from the left to the right // touchST.y goes up from the bottom to the top // <0.0, 0.0, 0.0> is in the bottom left corner

integer numberOfRows = 12; integer numberOfColumns = 12;

default { 

   touch_start(integer total_number)
   {
       vector touchST = llDetectedTouchST(0);
       integer columnIndex = llFloor(touchST.x * numberOfColumns);
       integer rowIndex = llFloor(touchST.y * numberOfRows);
       integer cellIndex = (rowIndex * numberOfColums) + columnIndex;

       llSay(PUBLIC_CHANNEL, "(" + (string)columnIndex + ", " + (string)rowIndex + ") --> " + (string)cellIndex);
   }

}

</lsl>

See Also

Deep Notes

History

Introduced in Viewer SVN:870 r92872 Branch:Release Wednesday, 23 July 2008, Supported by Beta Server 1.24.0.93754 (Wenesday 6th August 2008), and viewer binary 1.20.15 (93532).

Footnotes

  1. ^ The ranges in this article are written in Interval Notation.

Signature

function vector llDetectedTouchST( integer index );
Retrieved from "https://wiki.secondlife.com/w/index.php?title=LlDetectedTouchST&oldid=1174345"