Difference between revisions of "LlDetectedTouchST"

From Second Life Wiki
Jump to navigation Jump to search
m
m
Line 19: Line 19:
|examples=
|examples=
<lsl>
<lsl>
//  touchST.x goes across the face from the left to the right
//  touchST.y goes across the face from the bottom to the top
//  ZERO_VECTOR (<0.0, 0.0, 0.0> ... the origin) is in the bottom left corner of the face
default
default
{
{
Line 28: Line 24:
     {
     {
         integer touchFace = llDetectedTouchFace(0);
         integer touchFace = llDetectedTouchFace(0);
         vector touchST = llDetectedTouchST(0);
         vector touchST   = llDetectedTouchST(0);
        float touchS = touchST.x;
 
        float touchT = touchST.y;
//      ZERO_VECTOR (<0.0, 0.0, 0.0> ... the origin) is in the bottom left corner of the face
//      touchST.x goes across the face from the left to the right
//      touchST.y goes across the face from the bottom to the top


         if (touchFace == -1)
         if (touchFace == -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>
         else if (touchST == TOUCH_INVALID_TEXCOORD)
         else if (touchST == TOUCH_INVALID_TEXCOORD)
//      {
//      {
Line 44: Line 40:
         else
         else
//      {
//      {
             llSay(PUBLIC_CHANNEL, "llDetectedTouchST(" + (string)touchST + ")"
             llSay(PUBLIC_CHANNEL, "llDetectedTouchST(0) = " + (string)touchST
                     + "\ntouchST.x = " + (string)touchS
                     + "\ntouchST.x = " + (string)touchST.x
                     + "\ntouchST.y = " + (string)touchT);
                     + "\ntouchST.y = " + (string)touchST.y);
//      }
//      }
     }
     }
Line 52: Line 48:
</lsl>
</lsl>
<lsl>
<lsl>
//  touchST.x goes across the face from the left to the right
integer numberOfRows   = 12;
//  touchST.y goes across the face from the bottom to the top
//  ZERO_VECTOR (<0.0, 0.0, 0.0> ... the origin) is in the bottom left corner of the face
 
integer numberOfRows = 12;
integer numberOfColumns = 12;
integer numberOfColumns = 12;


Line 63: Line 55:
     touch_start(integer total_number)
     touch_start(integer total_number)
     {
     {
         vector touchST = llDetectedTouchST(0);
         vector touchST     = llDetectedTouchST(0);
 
//      ZERO_VECTOR (<0.0, 0.0, 0.0> ... the origin) is in the bottom left corner of the face
//      touchST.x goes across the face from the left to the right
//      touchST.y goes across the face from the bottom to the top
 
         integer columnIndex = llFloor(touchST.x * numberOfColumns);
         integer columnIndex = llFloor(touchST.x * numberOfColumns);
         integer rowIndex = llFloor(touchST.y * numberOfRows);
         integer rowIndex   = llFloor(touchST.y * numberOfRows);
         integer cellIndex = (rowIndex * numberOfColumns) + columnIndex;
         integer cellIndex   = (rowIndex * numberOfColumns) + columnIndex;


         llSay(PUBLIC_CHANNEL, "ST (" + (string)columnIndex + ", " + (string)rowIndex + ") --> " + (string)cellIndex);
         llSay(PUBLIC_CHANNEL, "ST grid (" + (string)columnIndex + ", " + (string)rowIndex
                            + ") --> cell " + (string)cellIndex);
     }
     }
}
}
</lsl>
</lsl>
<lsl>
<lsl>
//  touchST.x goes across the face from the left to the right
//  touchST.y goes across the face from the bottom to the top
//  ZERO_VECTOR (<0.0, 0.0, 0.0> ... the origin) is in the bottom left corner of the face
//
//  with friendly permission of Supremius Maximus
//  with friendly permission of Supremius Maximus
//  who made the texture used in this script
//  who made the texture used in this script
Line 87: Line 81:
     touch(integer num_detected)
     touch(integer num_detected)
     {
     {
         integer face = llDetectedTouchFace(0);
        integer link    = llDetectedLinkNumber(0);
         vector touchST = llDetectedTouchST(0);
         integer face   = llDetectedTouchFace(0);
         vector touchST = llDetectedTouchST(0);
 
//      ZERO_VECTOR (<0.0, 0.0, 0.0> ... the origin) is in the bottom left corner of the face
//      touchST.x goes across the face from the left to the right
//      touchST.y goes across the face from the bottom to the top


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


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

Revision as of 23:29, 8 October 2013

Summary

Function: vector llDetectedTouchST( integer index );

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.
All Issues ~ Search JIRA for related Bugs

Examples

<lsl> default { 

   touch_start(integer total_number)
   {
       integer touchFace = llDetectedTouchFace(0);
       vector  touchST   = llDetectedTouchST(0);

// ZERO_VECTOR (<0.0, 0.0, 0.0> ... the origin) is in the bottom left corner of the face // touchST.x goes across the face from the left to the right // touchST.y goes across the face from the bottom to the top 

       if (touchFace == -1)

// { 

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

// } 

       else if (touchST == TOUCH_INVALID_TEXCOORD)

// { 

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

// } 

       else

// { 

           llSay(PUBLIC_CHANNEL, "llDetectedTouchST(0) = " + (string)touchST
                   + "\ntouchST.x = " + (string)touchST.x
                   + "\ntouchST.y = " + (string)touchST.y);

// } 

   }

} </lsl> <lsl> integer numberOfRows = 12; integer numberOfColumns = 12;

default { 

   touch_start(integer total_number)
   {
       vector  touchST     = llDetectedTouchST(0);

// ZERO_VECTOR (<0.0, 0.0, 0.0> ... the origin) is in the bottom left corner of the face // touchST.x goes across the face from the left to the right // touchST.y goes across the face from the bottom to the top 

       integer columnIndex = llFloor(touchST.x * numberOfColumns);
       integer rowIndex    = llFloor(touchST.y * numberOfRows);
       integer cellIndex   = (rowIndex * numberOfColumns) + columnIndex;

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

} </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 link    = llDetectedLinkNumber(0);
       integer face    = llDetectedTouchFace(0);
       vector  touchST = llDetectedTouchST(0);

// ZERO_VECTOR (<0.0, 0.0, 0.0> ... the origin) is in the bottom left corner of the face // touchST.x goes across the face from the left to the right // touchST.y goes across the face from the bottom to the top 

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

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

}

</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).
Search JIRA for related Issues

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=1182330"