Difference between revisions of "LlSetSitText"

From Second Life Wiki
Jump to navigation Jump to search
(Added Caveat and kinda tidied up (I think) ... not much of a wiki editor yet.)
m (Improved my previous comment and tidied caveats)
Line 6: Line 6:
|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.
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.
|caveats=*'''Text''' cannot be set by a script (calling this function) 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=
|examples=
===Usage===
===Usage===

Revision as of 11:36, 18 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

  • Text cannot be set by a script (calling this function) 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 );