Difference between revisions of "LlSetSitText"

From Second Life Wiki
Jump to navigation Jump to search
(We generally do not go through and change the whitespace of scripts unless its ugly. On the wiki we accept only K&R and Allman style (but not others) http://en.wikipedia.org/wiki/Indent_style)
(Added Caveat and kinda tidied up (I think) ... not much of a wiki editor yet.)
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=*Cannot be set by a script in a child prim.
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.
|examples=
 
===Usage===
===Usage===



Revision as of 13:48, 17 March 2010

Summary

Function: llSetSitText( string text );

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

  • Cannot be set by a script in a child prim.
  • 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.
All Issues ~ Search JIRA for related Bugs

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

Deep Notes

Search JIRA for related Issues

Signature

function void llSetSitText( string text );