Difference between revisions of "LlDetectedTouchST"

From Second Life Wiki
Jump to: navigation, search
m
 
(17 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{LSL_Function/detected|index|TouchST|simple=*}}{{LSL_Function
+
{{LSL_Function
 +
|inject-2={{LSL_Function/detected|index|touchST|simple=*}}
 
|func_id=342|func_sleep=0.0|func_energy=10.0
 
|func_id=342|func_sleep=0.0|func_energy=10.0
 
|func=llDetectedTouchST
 
|func=llDetectedTouchST
|return_type=vector|return_text=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 ('''{{NoWrap|{{LSL_VR|s|t|0.0}}}}'''). Each component is in the interval [0.0, 1.0] with the origin in the bottom left corner.
+
|return_type=vector|return_text=that is the surface coordinates for where the prim was touched. The {{LSLP|x}} & {{LSLP|y}} vector positions contain the horizontal ({{LSLP|s}}) & vertical ({{LSLP|t}}) face coordinates respectively (<code>{{NoWrap|{{LSL_VR|{{LSLPT|s}}|{{LSLPT|t}}|0.0}}}}</code>). Each component is usually in the interval {{Interval|gte=0.0|center=component|lte=1.0}} with the origin in the bottom left corner.{{Interval/Footnote}} With some mesh objects, values of less than 0.0 and higher than 1.0 have been observed.
  
 
{{LSL Const|TOUCH_INVALID_TEXCOORD|vector|{{LSL_VR|-1.0|-1.0|0.0}}}} is returned when the surface coordinates cannot be determined. See [[#Caveats|Caveats]] for further details.
 
{{LSL Const|TOUCH_INVALID_TEXCOORD|vector|{{LSL_VR|-1.0|-1.0|0.0}}}} is returned when the surface coordinates cannot be determined. See [[#Caveats|Caveats]] for further details.
Line 17: Line 18:
 
** The event triggered is not a {{LSLGC|Touch|touch}} event.
 
** The event triggered is not a {{LSLGC|Touch|touch}} event.
 
|examples=
 
|examples=
<lsl>default {
+
<source lang="lsl2">
+
default
     touch_start(integer num_detected) {
+
{
         integer i = 0;
+
     touch_start(integer total_number)
         for(; i < num_detected; ++i ) {
+
    {
            vector touchedpos = llDetectedTouchST(i);     
+
         integer touchFace = llDetectedTouchFace(0);
           
+
         vector touchST  = llDetectedTouchST(0);
            if (llDetectedTouchFace(i) == -1) {
+
                llWhisper(0, "Sorry, your viewer doesn't support touched faces.");
+
            }
+
            else if ( touchedpos == TOUCH_INVALID_TEXCOORD ) {
+
                llWhisper(0, "Sorry, the surface touch position could not be determined.");
+
            }
+
            else {
+
                llWhisper(0, (string) touchedpos);
+
            }
+
        } // while ...
+
    } // touch_start
+
  
}</lsl>
+
//      ZERO_VECTOR (<0.0, 0.0, 0.0> ... the origin) is in the bottom left corner of the face
<lsl>vector touchedLoc;
+
//      touchST.x goes across the face from the left to the right
 +
//      touchST.y goes up the face from the bottom to the top
  
default {
+
        if (touchFace == -1)
//Draws a cross-hair at the detected Location on the detected face.
+
            llWhisper(PUBLIC_CHANNEL, "Sorry, your viewer doesn't support touched faces.");
 
+
         else if (touchST == TOUCH_INVALID_TEXCOORD)
    touch(integer num_detected) {
+
             llWhisper(PUBLIC_CHANNEL, "Sorry, the touch position upon the face could not be determined.");
        integer i;
+
        else
         for (i = 0; i < num_detected; i++) {
+
             llSay(PUBLIC_CHANNEL, "llDetectedTouchST(0) = " + (string)touchST
             touchedLoc = llDetectedTouchST(i); //What location has been touched?
+
                    + "\ntouchST.x = " + (string)touchST.x
             llSetPrimitiveParams([PRIM_TEXTURE, llDetectedTouchFace(i), "5ac7995c-4c24-8b60-ae61-6a837619dc75",
+
                    + "\ntouchST.y = " + (string)touchST.y);
                          <1.0,1.0,0.0>, touchedLoc, 180*DEG_TO_RAD]); //Set the Texture Location at the touched location
+
        }
+
 
     }
 
     }
 
 
}
 
}
</lsl>
+
</source>
<lsl>
+
<source lang="lsl2">
// Sets a grid of WIDTH by HEIGHT and returns a unique number.
+
integer numberOfRows    = 12;
// The cases of the grid are numbered line by line, left to right,
+
integer numberOfColumns = 12;
// starting from the bottom.
+
 
+
integer WIDTH = 12;
+
integer HEIGHT = 12;
+
// With a grid of 12x12 (144 cases), you get a number from 0 to 143.
+
  
 
default
 
default
Line 66: Line 49:
 
     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 y = llFloor(st.y * HEIGHT);
+
//      ZERO_VECTOR (<0.0, 0.0, 0.0> ... the origin) is in the bottom left corner of the face
         integer button = (y * WIDTH) + x;      
+
//      touchST.x goes across the face from the left to the right
         llOwnerSay("(" + (string)x + "," + (string)y + ") --> " + (string)button);
+
//      touchST.y goes up the face from the bottom to the top
 +
 
 +
         integer columnIndex = (integer) (touchST.x * numberOfColumns);
 +
         integer rowIndex    = (integer) (touchST.y * numberOfRows);
 +
         integer cellIndex  = (rowIndex * numberOfColumns) + columnIndex;
 +
 
 +
         llSay(PUBLIC_CHANNEL, "ST grid (" + (string)columnIndex + ", " + (string)rowIndex
 +
                            + ") --> cell " + (string)cellIndex);
 
     }
 
     }
 
}
 
}
</lsl>
+
</source>
 +
<source lang="lsl2">
 +
//  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, 0,
 +
            PRIM_FULLBRIGHT, ALL_SIDES, TRUE]);
 +
    }
 +
}
 +
</source>
 
|helpers
 
|helpers
 
|related
 
|related
Line 90: Line 106:
 
|also_articles
 
|also_articles
 
|notes
 
|notes
|history=Introduced in Viewer {{SVN|870|rev=92872|branch=Release|anchor=file14|date=Wednesday, 23 July 2008}}, Supported by Beta Server 1.24.0.93754 (Wenesday 6th August 2008), and viewer binary 1.20.15 (93532).
+
|history=*Introduced in Viewer {{SVN|870|rev=92872|branch=Release|anchor=file14|date=Wednesday, 23 July 2008}}, Supported by Beta Server 1.24.0.93754 (Wenesday 6th August 2008), and viewer binary 1.20.15 (93532).
 +
*Date of Release Server [[ Release_Notes/Second_Life_Beta_Server/1.24#Release_Notes_for_Second_Life_Beta_Server_1.24.3_.28August_29th.2C_2008.29 | 29-08-2008 ]]
 +
*Date of Release Client  [[ Release_Notes/Second_Life_Release/1.21 | 16-10-2008 ]]
 
|cat1=Touch
 
|cat1=Touch
 
|cat2
 
|cat2

Latest revision as of 00:00, 22 January 2015

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 usually in the interval [0.0, 1.0] with the origin in the bottom left corner.[1] With some mesh objects, values of less than 0.0 and higher than 1.0 have been observed.

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

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 up 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);
    }
}
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 up the face from the bottom to the top
 
        integer columnIndex = (integer) (touchST.x * numberOfColumns);
        integer rowIndex    = (integer) (touchST.y * numberOfRows);
        integer cellIndex   = (rowIndex * numberOfColumns) + columnIndex;
 
        llSay(PUBLIC_CHANNEL, "ST grid (" + (string)columnIndex + ", " + (string)rowIndex
                            + ") --> cell " + (string)cellIndex);
    }
}
//  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, 0,
            PRIM_FULLBRIGHT, ALL_SIDES, TRUE]);
    }
}

See Also

Deep Notes

History

Search JIRA for related Issues

Footnotes

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

Signature

function vector llDetectedTouchST( integer index );