llSetText

From Second Life Wiki
Revision as of 14:55, 6 February 2007 by Bleevo Plessis (talk | contribs) (fixed example code)
Jump to navigation Jump to search

Summary

Function: llSetText( string text, vector color, float alpha );

This function is used to set text to display over an object in SL.

• string text
• vector color
• float alpha

Specification

Displays text placed over object -- programmer specifies text, color and visibility/transparency.

Caveats

Expression error: Unexpected > operator.The floating text is a property of the prim and not the script, thus the text will remain if the script is deactivated or removed. To remove floating text, one must assign an empty string with llSetText("", <1.0, 1.0, 1.0>, 1.0);

Examples

Example colors:

vector white = <1.0, 1.0, 1.0>;
vector red = <1.0, 0.0, 0.0>;
vector green = <0.0, 1.0, 0.0>;
vector blue = <0.0, 0.0, 1.0>;
vector grey = <0.5, 0.5, 0.5>;
vector black = <0.0, 0.0, 0.0>;
llSetText("I am on", <1.0, 1.0, 1.0>, 1.0);

<1.0, 1.0, 1.0> represents the values for red, green, and blue. <1.0, 1.0, 1.0>, means "white" and <0.0, 0.0, 0.0> means "black".

llSetText("I am off", <0.0, 0.0, 0.0>, 1.0);

The 1.0 is the alpha setting. 1.0 means fully opaque, and 0.0 would be completely transparent (invisible).

Example of how llSetText could be included in default code:

default
{
    state_entry()
    {
         llSay(0, "Hello, Avatar!");
         llSetText("Prize Box", <0.0, 1.0, 0.0>, 1.0);
    }

    touch_start(integer total_number)
    {
         llSay(0, "Touched.");
    }
}

Notes

Most commonly, this is included in the default code for an object (see example above).

Deep Notes

Signature

function void llSetText( string text, vector color, float alpha );