Difference between revisions of "LlSetSitText"
Jump to navigation
Jump to search
Upon your having done so, the text that appears will revert to "Sit Here."
Fred Gandt (talk | contribs) m (Improved my previous comment and tidied caveats) |
Lady Sumoku (talk | contribs) m (Replaced old <LSL> block with <source lang="lsl2">) |
||
| (4 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
{{LSL_Function | {{Issues/SVC-4870}}{{LSL_Function | ||
|func_id=242|func_sleep=0.0|func_energy=10.0 | |func_id=242|func_sleep=0.0|func_energy=10.0 | ||
|func=llSetSitText|p1_type=string|p1_name=text | |func=llSetSitText|p1_type=string|p1_name=text | ||
|func_footnote | |func_footnote | ||
|func_desc=Displays '''text''' rather than the default "Sit Here" in the | |func_desc=Displays '''text''' rather than the default "Sit Here" in the right-click menu. | ||
|return_text | |return_text | ||
|spec= | |spec= | ||
|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'''. | ||
*'''Text''' is limited to 9 characters. | |||
|examples= | |examples= | ||
===Usage=== | ===Usage=== | ||
< | <source lang="lsl2">default | ||
{ | { | ||
state_entry() | state_entry() | ||
| Line 19: | Line 19: | ||
llSetSitText("Be Seated"); | llSetSitText("Be Seated"); | ||
} | } | ||
}</ | }</source> | ||
=== Removing Sit Text === | === Removing Sit Text === | ||
| Line 26: | Line 26: | ||
To remove custom text that you have placed there, set the text as an empty string like this: "". | To remove custom text that you have placed there, set the text as an empty string like this: "". | ||
< | <source lang="lsl2">default | ||
{ | { | ||
state_entry() | state_entry() | ||
| Line 32: | Line 32: | ||
llSetSitText(""); | llSetSitText(""); | ||
} | } | ||
}</ | }</source> | ||
Upon your having done so, the text that appears will revert to "Sit Here." | Upon your having done so, the text that appears will revert to "Sit Here." | ||
| Line 44: | Line 44: | ||
|also_articles | |also_articles | ||
|notes | |notes | ||
|cat1=Pie Menu | |cat1=Pie Menu | ||
|cat2=Prim | |cat2=Prim | ||
Latest revision as of 14:03, 22 January 2015
| 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 right-click menu.
| • string | 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.
- You have no control over the face, size or colour of the displayed text.
- Text is limited to 9 characters.
Important Issues
~ All Issues ~ Search JIRA for related Bugs
|
|
SVC-4870 | A | llSetSitText does not apply for child prims, only the main prims sit text gets displayed |
Examples
Usage
default
{
state_entry()
{
llSetSitText("Be Seated");
}
}
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: "".
default
{
state_entry()
{
llSetSitText("");
}
}
See Also
Functions
| • | llSitTarget | |||
| • | llSetTouchText |
Deep Notes
All Issues
~ Search JIRA for related Issues|
|
|
SVC-4870 | A | llSetSitText does not apply for child prims, only the main prims sit text gets displayed |
Signature |
|---|
function void llSetSitText( string text ); |