Difference between revisions of "LlSetText"

From Second Life Wiki
Jump to navigation Jump to search
m
Line 6: Line 6:
|func=llSetText
|func=llSetText
|sort=SetText
|sort=SetText
|p1_type=String
|p1_type=string
|p1_name=text
|p1_name=text
|p1d = text to display between the quotes
|p1d = text to display between the quotes
|p2_type=Vector
|p2_type=vector
|p2_name=color
|p2_name=color
|p2d = color in RGB enclosed between <> signs, as in <0.0, 0.0, 0.0> = black, <1.0, 1.0, 1.0> = white.
|p2d = color in RGB enclosed between <> signs, as in <0.0, 0.0, 0.0> = black, <1.0, 1.0, 1.0> = white.
|p3_type=Float
|p3_type=float
|p3_name=alpha
|p3_name=alpha
|p3d = visibility, 0.0 is fully transparent and 1.0 is fully visible.
|p3d = visibility, 0.0 is fully transparent and 1.0 is fully visible.
Line 22: Line 22:
|caveats=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);
|caveats=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=
|examples=
 
Example colors:
<pre>
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>;
</pre>
<pre>
llSetText("I am on", <1.0, 1.0, 1.0>, 1.0);
llSetText("I am on", <1.0, 1.0, 1.0>, 1.0);
 
</pre>
<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".  
<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".  
 
<pre>
llSetText("I am off", <0.0, 0.0, 0.0>, 1.0);
llSetText("I am off", <0.0, 0.0, 0.0>, 1.0);
 
</pre>
The 1.0 is the alpha setting. 1.0 means fully opaque, and 0.0 would be completely transparent (invisible).  
The 1.0 is the alpha setting. 1.0 means fully opaque, and 0.0 would be completely transparent (invisible).  



Revision as of 15:54, 6 February 2007

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);

All Issues ~ Search JIRA for related Bugs

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

Search JIRA for related Issues

Signature

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