llSetFaceText

Template:Needs Translation/LSL/de Template:Needs Translation/LSL/es Template:Needs Translation/LSL/el Template:Needs Translation/LSL/fr Template:Needs Translation/LSL/he Template:Needs Translation/LSL/it Template:Needs Translation/LSL/ja Template:Needs Translation/LSL/ko Template:Needs Translation/LSL/nl Template:Needs Translation/LSL/hu Template:Needs Translation/LSL/no Template:Needs Translation/LSL/da Template:Needs Translation/LSL/sv Template:Needs Translation/LSL/tr Template:Needs Translation/LSL/pl Template:Needs Translation/LSL/pt Template:Needs Translation/LSL/ru Template:Needs Translation/LSL/th Template:Needs Translation/LSL/uk Template:Needs Translation/LSL/zh-Hans Template:Needs Translation/LSL/zh-Hant

/LSL

SetFaceText

llSetFaceText

	LSL Feature Request
	The described function does not exist. This article is a feature request.

Summary

Function: llSetFaceText( integer face, string text, integer chars_per_line, vector color, integer font );

0.0	Forced Delay
10.0	Energy

Will display text on face in the specified color as a regular texture would, using the assigned font, and wrapping lines at the end of chars_per_line.

• integer	face	–	the face number of the prim
• string	text	–	text to display
• integer	chars_per_line	–	number of characters until wrapping lines
• vector	color	–	RBG color at which text will be displayed
• integer	font	–	the font used

Caveats

• Text is limited to 1024 bytes, if the string is longer it will be truncated to 1024 bytes.
• Text will stretch across the face of the prim as a texture would, while following the chars_per_line rule only in changing the textual structure.
• To remove face text from face, use the following:

llSetFaceText(face, "", 0, <1.0, 1.0, 1.0>, 0);

• The font type will be based on any font built-in to the release client and available as LSL constants, such as:
  • FACE_FONT_TIMES_NEW_ROMAN
  • FACE_FONT_SANS_SERIF
  • etc
• Use -1 for chars_per_line to disable word wrapping

Examples

Example of using the function on a prim saying "Hello World":

default
{
    state_entry()
    {
        llSetFaceText(0, "Hello World!", -1, <1.0, 1.0, 1.0>, 1);
    }
}

Deep Notes

Signature
//function void llSetFaceText( integer face, string text, integer chars_per_line, vector color, integer font );