Difference between revisions of "LlSetSitText"
Jump to navigation
Jump to search
All Issues ~ Search JIRA for related Bugs
Fred Gandt (talk | contribs) m (Improved my previous comment and tidied caveats) |
Fred Gandt (talk | contribs) m (Fixed the caveat since Strife drew attention to my error.) |
||
Line 7: | Line 7: | ||
|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. | 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=*'''Text''' | |caveats=*'''Text''' will only be displayed if set by a script calling this function in the root. If '''text''' is set by a script in a child the '''text''' will only be displayed after unlinking it or relinking it as the root. If either a child or the root is selected as an individual prim and right clicked, the '''text''' displayed will be the default even if a script in the root has set '''text'''. More simply - The '''text''' property displayed on right click will always be that of the root unless, right clicking a prim under individual edit when it will always be the LL default. | ||
*Note that like particles, and the other set text functions, all '''text''' set via llSetSitText 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. | *Note that like particles, and the other set text functions, all '''text''' set via llSetSitText 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. | ||
*You have no control over the face, size or colour of the displayed '''text'''. | *You have no control over the face, size or colour of the displayed '''text'''. |
Revision as of 09:00, 19 March 2010
LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: llSetSitText( string text );242 | Function ID |
0.0 | Forced Delay |
10.0 | Energy |
Displays text rather than the default "Sit Here" in the pie menu
• string | text |
Specification
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
- Text will only be displayed if set by a script calling this function in the root. If text is set by a script in a child the text will only be displayed after unlinking it or relinking it as the root. If either a child or the root is selected as an individual prim and right clicked, the text displayed will be the default even if a script in the root has set text. More simply - The text property displayed on right click will always be that of the root unless, right clicking a prim under individual edit when it will always be the LL default.
- Note that like particles, and the other set text functions, all text set via llSetSitText 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.
- You have no control over the face, size or colour of the displayed text.
Examples
Usage
<lsl>default {
state_entry() { llSetSitText("Be Seated"); }
}</lsl>
Removing Sit Text
There is no way to stop a pie menu from having a "Sit Here" space reserved on it. Although by setting the string to a space no text will be shown.
To remove custom text that you have placed there, set the text as an empty string like this: "".
<lsl>default {
state_entry() { llSetSitText(""); }
}</lsl>
Upon your having done so, the text that appears will revert to "Sit Here."See Also
Functions
• | llSitTarget | |||
• | llSetTouchText |