Difference between revisions of "LlDetectedTouchUV"

From Second Life Wiki
Jump to navigation Jump to search
m
m (Replaced <source> with <syntaxhighlight> and added haiku generated by www.poem-generator.org.uk)
 
(10 intermediate revisions by 6 users not shown)
Line 3: Line 3:
|func_id=337|func_sleep=0.0|func_energy=10.0
|func_id=337|func_sleep=0.0|func_energy=10.0
|func=llDetectedTouchUV
|func=llDetectedTouchUV
|return_type=vector|return_text=that is the texture coordinates for where the prim was touched. The {{LSLP|x}} & {{LSLP|y}} vector positions contain the {{LSLP|u}} & {{LSLP|v}} texture coordinates respectively (<code>{{NoWrap|{{LSL_VR|{{LSLPT|u}}|{{LSLPT|v}}|0.0}}}}</code>). Like [[llDetectedTouchST]], the interval of each component will be {{Interval|gte=0.0|center=component|lte=1.0}} unless the texture repeats are set to a non-default value. Increasing or decreasing the texture repeats of the face will change this interval accordingly.
|return_type=vector|return_text=that is the texture coordinates for where the prim was touched. The {{LSLP|x}} & {{LSLP|y}} vector positions contain the horizontal ({{LSLP|u}}) & vertical ({{LSLP|v}}) texture coordinates respectively (<code>{{NoWrap|{{LSL_VR|{{LSLPT|u}}|{{LSLPT|v}}|0.0}}}}</code>). Like [[llDetectedTouchST]], the interval of each component will be {{Interval|gte=0.0|center=component|lte=1.0}} unless the texture repeats are set to a non-default value. Increasing or decreasing the texture repeats of the face will change this interval accordingly. Additionally,  unlike with [[llDetectedTouchST]], changing a texture's rotation will change the results of this function.


{{LSL Const|TOUCH_INVALID_TEXCOORD|vector|{{LSL_VR|-1.0|-1.0|0.0}}}} is returned when the touch UV 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 touch UV coordinates cannot be determined. See [[#Caveats|Caveats]] for further details.
Line 18: 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>
<syntaxhighlight lang="lsl2">
default
default
{
{
     touch_start(integer num_detected)
     touch_start(integer total_number)
     {
     {
         // PUBLIC_CHANNEL has the integer value 0
         integer face = llDetectedTouchFace(0);
        vector  touchUV  = llDetectedTouchUV(0);


         llWhisper(PUBLIC_CHANNEL,
//      ZERO_VECTOR (<0.0, 0.0, 0.0> ... the origin) is in the bottom left corner of the texture
             "UV clicked: " + (string)llDetectedTouchUV(0));
//      touchUV.x goes across the texture from left to right
//      touchUV.y goes up the texture from bottom to top
 
         if (face == TOUCH_INVALID_FACE)
            llWhisper(PUBLIC_CHANNEL, "Sorry, your viewer doesn't support touched faces.");
        else if (touchUV == TOUCH_INVALID_TEXCOORD)
             llWhisper(PUBLIC_CHANNEL, "Sorry, the touch position upon the texture could not be determined.");
        else
            llSay(PUBLIC_CHANNEL, "llDetectedTouchUV(" + (string)touchUV + ")"
                    + "\ntouchUV.x = " + (string)touchUV.x
                    + "\ntouchUV.y = " + (string)touchUV.y);
     }
     }
}
}
</lsl>
</syntaxhighlight>
<lsl>
<syntaxhighlight lang="lsl2">
integer numberOfRows    = 12;
integer numberOfColumns = 12;
 
default
default
{
{
     touch_start(integer num_detected)
     touch_start(integer num_detected)
     {
     {
         vector UV = llDetectedTouchUV(0);
         vector touchUV = llDetectedTouchUV(0);


        float U = UV.x;
//      ZERO_VECTOR (<0.0, 0.0, 0.0> ... the origin) is in the bottom left corner of the texture
        float V = UV.y;
//      touchUV.x goes across the texture from left to right
//      touchUV.y goes up the texture from bottom to top


         // Now you can report U and V separately, or you can compare them separately with IF statements.
         integer columnIndex = (integer) (touchUV.x * numberOfColumns);
         // You of course do not need to store the vector components to separate variables,
         integer rowIndex    = (integer) (touchUV.y * numberOfRows);
         // you can access them from the vector that used as an intermediate, like this:
         integer cellIndex  = rowIndex * numberOfColumns + columnIndex;


        // PUBLIC_CHANNEL has the integer value 0
         llSay(PUBLIC_CHANNEL, "UV grid (" + (string)columnIndex + ", " + (string)rowIndex + ") --> cell " + (string)cellIndex);
         llSay(PUBLIC_CHANNEL, "UV.x: " + (string)U);
        llSay(PUBLIC_CHANNEL, "UV.y: " + (string)V);
     }
     }
}
}
</lsl>
</syntaxhighlight>
|helpers
|helpers
|related
|related
Line 66: Line 79:
|notes
|notes
|history=*Introduced in {{SVN|870|rev=92872|trunk=*|anchor=file14|date=Wednesday, 23 July 2008}}.
|history=*Introduced in {{SVN|870|rev=92872|trunk=*|anchor=file14|date=Wednesday, 23 July 2008}}.
*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 ]]
*Server support available in Second Life Server 1.24.7.98039, client support in Release Candidate viewer 1.21.4 (98167).
*Server support available in Second Life Server 1.24.7.98039, client support in Release Candidate viewer 1.21.4 (98167).
|cat1=Touch
|cat1=Touch
Line 71: Line 86:
|cat3
|cat3
|cat4
|cat4
|haiku={{Haiku|Early aurora|A single face gently touched|in front of a cube}}
}}
}}

Latest revision as of 00:20, 30 May 2023

Summary

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

Returns a vector that is the texture coordinates for where the prim was touched. The x & y vector positions contain the horizontal (u) & vertical (v) texture coordinates respectively (<u, v, 0.0>). Like llDetectedTouchST, the interval of each component will be [0.0, 1.0] unless the texture repeats are set to a non-default value. Increasing or decreasing the texture repeats of the face will change this interval accordingly. Additionally, unlike with llDetectedTouchST, changing a texture's rotation will change the results of this function.

TOUCH_INVALID_TEXCOORD is returned when the touch UV 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

default
{
    touch_start(integer total_number)
    {
        integer face = llDetectedTouchFace(0);
        vector  touchUV   = llDetectedTouchUV(0);

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

        if (face == TOUCH_INVALID_FACE)
            llWhisper(PUBLIC_CHANNEL, "Sorry, your viewer doesn't support touched faces.");
        else if (touchUV == TOUCH_INVALID_TEXCOORD)
            llWhisper(PUBLIC_CHANNEL, "Sorry, the touch position upon the texture could not be determined.");
        else
            llSay(PUBLIC_CHANNEL, "llDetectedTouchUV(" + (string)touchUV + ")"
                    + "\ntouchUV.x = " + (string)touchUV.x
                    + "\ntouchUV.y = " + (string)touchUV.y);
    }
}

integer numberOfRows    = 12;
integer numberOfColumns = 12;

default
{
    touch_start(integer num_detected)
    {
        vector touchUV = llDetectedTouchUV(0);

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

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

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

See Also

Deep Notes

History

Footnotes

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

Signature

function vector llDetectedTouchUV( integer index );

Haiku

Early aurora
A single face gently touched
in front of a cube

Retrieved from "https://wiki.secondlife.com/w/index.php?title=LlDetectedTouchUV&oldid=1213973"