Difference between revisions of "LlSetTouchText"

From Second Life Wiki
Jump to navigation Jump to search
m
Line 4: Line 4:
|func_id=241|func_sleep=0.0|func_energy=10.0
|func_id=241|func_sleep=0.0|func_energy=10.0
|p1_type=string|p1_name=text
|p1_type=string|p1_name=text
|func_footnote=This is very similar to [[LlSetSitText]]
|func_footnote=This is very similar to [[LlSetSitText]].<br/>
To restore the default value, use an empty string for '''text'''.<br/>
To make it appear as if there is no text, use some combination of whitespace characters for '''text'''.
|func_desc=Displays '''text''' rather than the default "Touch" in the pie menu
|func_desc=Displays '''text''' rather than the default "Touch" in the pie menu
|return_text
|return_text
|spec=
|spec
The '''text''' is limited to 9 characters. A tab (\t) counts as 4 characters. The newline character (\n) will count as 1 character, though it is a bit of a waste, as it will have no effect on how the text is displayed. Aside from counting toward the limit, it will otherwise be ignored.
|caveats=*The '''text''' is limited to 9 bytes.
 
**A tab (\t) counts as 4 bytes (four spaces).
Note that like particles, and the other set text functions, all text set via llSetTouchText becomes a property of a  prim, not a script. For that reason, the text will remain if the script that set it is deactivated or even removed.
**The newline character (\n) will count as 1 byte, but will have no effect on how the text is rendered (so don't use it).
 
**The byte count for each Unicode character is equal to the number of bytes needed to represent it in UTF-8.
You have no control over the face face, size or colour of the displayed text.
|examples=
 
 
==Usage==
<lsl>default{
<lsl>default{
     state_entry(){
     state_entry(){
Line 24: Line 23:
     }
     }
}</lsl>
}</lsl>
== Removing Touch Text ==
There is no way to stop a pie menu from having a "Touch" space reserved on it.
To remove custom text that you have placed there, set the text as space: "&nbsp;".
<lsl>default{
    state_entry(){
        llSetTouchText(" ");
    }
}</lsl>
Upon your having done so, the text that appears will revert to "Touch."
|caveats
|caveats
|constants
|constants
|helpers
|helpers
|also_functions=*{{LSLG|llSetSitText}}
|also_functions={{LSL DefineRow||[[llSetSitText]]}}
|also_events
|also_events
|also_tests
|also_tests
|also_articles=*{{LSLGC|Touch}}
|also_articles={{LSL DefineRow||{{LSLGC|Touch}}}}
|notes
|notes
|permission
|permission
Line 55: Line 37:
|cat2=Touch
|cat2=Touch
|cat3=Text
|cat3=Text
|cat4
|cat4=Prim
|cat5=Effect
}}
}}

Revision as of 18:19, 9 July 2008

Summary

Function: llSetTouchText( string text );
0.0 Forced Delay
10.0 Energy

Displays text rather than the default "Touch" in the pie menu

• string text

This is very similar to LlSetSitText.
To restore the default value, use an empty string for text.
To make it appear as if there is no text, use some combination of whitespace characters for text.

Caveats

  • The text is limited to 9 bytes.
    • A tab (\t) counts as 4 bytes (four spaces).
    • The newline character (\n) will count as 1 byte, but will have no effect on how the text is rendered (so don't use it).
    • The byte count for each Unicode character is equal to the number of bytes needed to represent it in UTF-8.

Examples

<lsl>default{

   state_entry(){
       llSetTouchText("Touch me!");
   }
   touch_start(integer detected){
       llSay(0, "you touched me!");
   }
}</lsl>

See Also

Functions

•  llSetSitText

Articles

•  Touch

Deep Notes

Signature

function void llSetTouchText( string text );