LlSetText - Revision history

Frionil Fang: clarified the floating text uses UTF-8 encoding, and multibyte characters are just deleted if they cross the boundary instead of resulting in garbage

2024-05-26T21:19:29Z

clarified the floating text uses UTF-8 encoding, and multibyte characters are just deleted if they cross the boundary instead of resulting in garbage

← Older revision		Revision as of 14:19, 26 May 2024
Line 14:		Line 14:
	\|caveats=		\|caveats=
	*If more than one [[llSetText]] is called (By reset,interaction or script state) within a prim the latest call will take priority over the previous.		*If more than one [[llSetText]] is called (By reset,interaction or script state) within a prim the latest call will take priority over the previous.
	*{{LSLP\|text}} is limited to 254 [[bytes]] (compare [[Limits#Building]])~~, if~~ the [[string]] is longer it will be truncated to 254 [[bytes]], ~~even if that means the truncation~~ will ~~chop a character in half~~.		*{{LSLP\|text}} is limited to 254 [[bytes]] (compare [[Limits#Building]]) in UTF-8 encoding. If the [[string]] is longer it will be truncated to 254 [[bytes]], and any multibyte characters getting split will be removed entirely.
	*An unbroken line of text of a great length may be broken automatically into two lines (one above the other).		*An unbroken line of text of a great length may be broken automatically into two lines (one above the other).
	*{{LSLP\|text}} can be seen through walls and other object. Be considerate of neighbors in malls and apartment buildings.		*{{LSLP\|text}} can be seen through walls and other object. Be considerate of neighbors in malls and apartment buildings.

ObviousAltIsObvious Resident at 01:06, 30 January 2016

2016-01-30T01:06:45Z

← Older revision		Revision as of 18:06, 29 January 2016
Line 250:		Line 250:
	{{LSL DefineRow\|\|[[:Category:LSL Examples\|Examples]]: [[SplitLine]]\|Insert 'new line' escape codes at certain positions of a string}}		{{LSL DefineRow\|\|[[:Category:LSL Examples\|Examples]]: [[SplitLine]]\|Insert 'new line' escape codes at certain positions of a string}}
	{{LSL DefineRow\|\|Useful snippet: [[llGetObjectPermMask]]\|Label an object with text and newlines to give away or sell}}		{{LSL DefineRow\|\|Useful snippet: [[llGetObjectPermMask]]\|Label an object with text and newlines to give away or sell}}
			{{LSL DefineRow\|\|[[escape codes]]\|for details on how and when they work}}

	\|notes=To actually display text on a prim, see [[XyzzyText]], or consider using parcel prim [[:Category:LSL_Media\|Media]] options (useful only if you have control over the land's media settings.)		\|notes=To actually display text on a prim, see [[XyzzyText]], or consider using parcel prim [[:Category:LSL_Media\|Media]] options (useful only if you have control over the land's media settings.)
	----		----

Digimbyte Resident: Undo revision 1199000 by Digimbyte Resident (talk)

2016-01-29T23:59:51Z

Undo revision 1199000 by Digimbyte Resident (talk)

@@ Line 19: / Line 19: @@
 **Visibility distance increases with prim size.
 *Removing the script or deactivating it '''will not remove''' a prim's {{LSLP|text}} property. Floating {{LSLP|text}} is not dependent on a script for its continued existence but only when wanting to change it.
 *To remove a prim's {{LSLP|text}}, use the following:
 {{{!}} class="sortable" width="100%" {{Prettytable}}

Digimbyte Resident: Undo revision 1199001 by Digimbyte Resident (talk)

2016-01-29T23:58:36Z

Undo revision 1199001 by Digimbyte Resident (talk)

← Older revision		Revision as of 16:58, 29 January 2016
Line 19:		Line 19:
	**Visibility distance increases with prim size.		**Visibility distance increases with prim size.
	*Removing the script or deactivating it '''will not remove''' a prim's {{LSLP\|text}} property. Floating {{LSLP\|text}} is not dependent on a script for its continued existence but only when wanting to change it.		*Removing the script or deactivating it '''will not remove''' a prim's {{LSLP\|text}} property. Floating {{LSLP\|text}} is not dependent on a script for its continued existence but only when wanting to change it.
			*If setting text Via [[llGetDesc]] you need to parse it like so:
			{{{!}} class="sortable" width="100%" {{Prettytable}}
			{{!}}- {{Hl2}}
			! '''Preferred method to remove a prim's floating {{LSLP\|text}}'''
			{{!}}-
			{{!!}}
			<syntaxhighlight lang="lsl2">
			// Get Description and use it as a String (Get Description does not return a true string)
			llSetText(llDumpList2String(llParseStringKeepNulls(llGetObjectDesc(),["\\n"],[]),"\n"),<1.0,1.0,1.0>,1.0);
			</syntaxhighlight>
			{{!!}}
	*To remove a prim's {{LSLP\|text}}, use the following:		*To remove a prim's {{LSLP\|text}}, use the following:
	{{{!}} class="sortable" width="100%" {{Prettytable}}		{{{!}} class="sortable" width="100%" {{Prettytable}}

Digimbyte Resident at 23:57, 29 January 2016

2016-01-29T23:57:41Z

← Older revision		Revision as of 16:57, 29 January 2016
Line 19:		Line 19:
	**Visibility distance increases with prim size.		**Visibility distance increases with prim size.
	*Removing the script or deactivating it '''will not remove''' a prim's {{LSLP\|text}} property. Floating {{LSLP\|text}} is not dependent on a script for its continued existence but only when wanting to change it.		*Removing the script or deactivating it '''will not remove''' a prim's {{LSLP\|text}} property. Floating {{LSLP\|text}} is not dependent on a script for its continued existence but only when wanting to change it.
	*If setting text Via [[llGetDesc]] you need to parse it like so:
	~~{{{!}} class="sortable" width="100%" {{Prettytable}}~~
	~~{{!}}- {{Hl2}}~~
	~~! '''Preferred method to remove a prim's floating {{LSLP\|text}}'''~~
	~~{{!}}-~~
	~~{{!!}}~~
	~~<syntaxhighlight lang="lsl2">~~
	~~// Get Description and use it as a String (Get Description does not return a true string)~~
	~~llSetText(llDumpList2String(llParseStringKeepNulls(llGetObjectDesc(),["\\n"],[]),"\n"),<1.0,1.0,1.0>,1.0);~~
	~~</syntaxhighlight>~~
	~~{{!!}}~~
	*To remove a prim's {{LSLP\|text}}, use the following:		*To remove a prim's {{LSLP\|text}}, use the following:
	{{{!}} class="sortable" width="100%" {{Prettytable}}		{{{!}} class="sortable" width="100%" {{Prettytable}}

Digimbyte Resident at 23:55, 29 January 2016

2016-01-29T23:55:42Z

@@ Line 19: / Line 19: @@
 **Visibility distance increases with prim size.
 *Removing the script or deactivating it '''will not remove''' a prim's {{LSLP|text}} property. Floating {{LSLP|text}} is not dependent on a script for its continued existence but only when wanting to change it.
 *To remove a prim's {{LSLP|text}}, use the following:
 {{{!}} class="sortable" width="100%" {{Prettytable}}

Haravikk Mistral at 10:27, 29 December 2015

2015-12-29T10:27:24Z

← Older revision		Revision as of 03:27, 29 December 2015
Line 1:		Line 1:
	{{LSL_Function		{{LSL_Function
	\|inject-2={{:PRIM_TEXT\|set}}{{Issues/SVC-4539}}		\|inject-2={{:PRIM_TEXT\|set}}{{Issues/SVC-4539}}{{Issues/BUG-11077}}
	\|func_id=152		\|func_id=152
	\|func_sleep=0.0		\|func_sleep=0.0

WayneScott Resident: The word under is entirely misleading - it appears to offer the option to move the hovertext BELOW the prim. replacing to clarify.

2015-03-22T04:50:51Z

The word under is entirely misleading - it appears to offer the option to move the hovertext BELOW the prim. replacing to clarify.

← Older revision		Revision as of 21:50, 21 March 2015
Line 227:		Line 227:
	}		}
	</syntaxhighlight>		</syntaxhighlight>
	To make hovertext ~~under~~ linked prims you can use this simple function:		To make hovertext when using linked prims you can use this simple function:
	<syntaxhighlight lang="lsl2">		<syntaxhighlight lang="lsl2">
	mySetLinkText(integer linknum, string text, vector color, float alpha) {		mySetLinkText(integer linknum, string text, vector color, float alpha) {

ObviousAltIsObvious Resident: trying

2015-01-22T02:13:28Z

trying <syntaxhighlight>

← Older revision		Revision as of 19:13, 21 January 2015
Line 26:		Line 26:
	{{!}}-		{{!}}-
	{{!!}}		{{!!}}
	<~~lsl~~>		<syntaxhighlight lang="lsl2">
	// empty string & black & transparent		// empty string & black & transparent
	llSetText("", ZERO_VECTOR, 0);		llSetText("", ZERO_VECTOR, 0);
	</~~lsl~~>		</syntaxhighlight>
	{{!!}}		{{!!}}
	<~~lsl~~>		<syntaxhighlight lang="lsl2">
	// empty string & black & transparent		// empty string & black & transparent
	llSetText("", <0.0, 0.0, 0.0>, 0.0);		llSetText("", <0.0, 0.0, 0.0>, 0.0);
	</~~lsl~~>		</syntaxhighlight>
	{{!}}}		{{!}}}
	*Vertical whitespace is removed from the end of the {{LSLP\|text}} string, so if you want vertical whitespace put any character (like a space) on the last line.		*Vertical whitespace is removed from the end of the {{LSLP\|text}} string, so if you want vertical whitespace put any character (like a space) on the last line.
Line 44:		Line 44:
	{{!}}-		{{!}}-
	{{!!}}		{{!!}}
	<~~lsl~~>		<syntaxhighlight lang="lsl2">
	vector COLOR_WHITE = <1.0, 1.0, 1.0>;		vector COLOR_WHITE = <1.0, 1.0, 1.0>;
	float OPAQUE = 1.0;		float OPAQUE = 1.0;

	llSetText("Monkeys\n \n \n \n \n ", COLOR_WHITE, OPAQUE);		llSetText("Monkeys\n \n \n \n \n ", COLOR_WHITE, OPAQUE);
	</~~lsl~~>		</syntaxhighlight>
	{{!!}}		{{!!}}
	<~~lsl~~>		<syntaxhighlight lang="lsl2">
	vector COLOR_WHITE = <1.0, 1.0, 1.0>;		vector COLOR_WHITE = <1.0, 1.0, 1.0>;
	float OPAQUE = 1.0;		float OPAQUE = 1.0;

	llSetText("Monkeys\n\n\n\n\n", COLOR_WHITE, OPAQUE);		llSetText("Monkeys\n\n\n\n\n", COLOR_WHITE, OPAQUE);
	</~~lsl~~>		</syntaxhighlight>
	{{!}}}		{{!}}}
	*'''Measurements showed a high impact of process time when doing numerous iterations in a while loop'''. For approx. 65 thousand iterations the process times are ca. 5 seconds without floating text, 24 seconds with [[llSetText]] and 96 seconds when using [[llSetPrimitiveParams#llSetLinkPrimitiveParamsFast]] in combination with [[PRIM_TEXT]]. Thats why you are '''not advised''' to make excessive use of changing a prim's {{LSLP\|text}} within such iterations.		*'''Measurements showed a high impact of process time when doing numerous iterations in a while loop'''. For approx. 65 thousand iterations the process times are ca. 5 seconds without floating text, 24 seconds with [[llSetText]] and 96 seconds when using [[llSetPrimitiveParams#llSetLinkPrimitiveParamsFast]] in combination with [[PRIM_TEXT]]. Thats why you are '''not advised''' to make excessive use of changing a prim's {{LSLP\|text}} within such iterations.
	\|examples=		\|examples=
	Example of how [[llSetText]] could be used to show prim's name in green {{LSLP\|text}}:		Example of how [[llSetText]] could be used to show prim's name in green {{LSLP\|text}}:
	<~~lsl~~>		<syntaxhighlight lang="lsl2">
	default		default
	{		{
Line 76:		Line 76:
	}		}
	}		}
	</~~lsl~~>		</syntaxhighlight>
	By default the floating {{LSLP\|text}} will appear on a single line. However, it can be spread over multiple lines by using a line break <code>"\n"</code> (read [[SplitLine]] in section 'See Also').		By default the floating {{LSLP\|text}} will appear on a single line. However, it can be spread over multiple lines by using a line break <code>"\n"</code> (read [[SplitLine]] in section 'See Also').

Line 147:		Line 147:

	The x, y & z [[Vector#Components\|components of the vector]] are used to represent red, green, and blue respectively. The range is <span style="background-color: yellow">different from traditional RGB</span>, instead of being 0 -> 255, LSL uses 0 -> 1. <code><1.0, 1.0, 1.0></code> represents "white" and <code><0.0, 0.0, 0.0></code> represents "black":		The x, y & z [[Vector#Components\|components of the vector]] are used to represent red, green, and blue respectively. The range is <span style="background-color: yellow">different from traditional RGB</span>, instead of being 0 -> 255, LSL uses 0 -> 1. <code><1.0, 1.0, 1.0></code> represents "white" and <code><0.0, 0.0, 0.0></code> represents "black":
	<~~lsl~~>		<syntaxhighlight lang="lsl2">
	// white & opaque		// white & opaque
	llSetText("I am white", <1.0, 1.0, 1.0>, 1.0);		llSetText("I am white", <1.0, 1.0, 1.0>, 1.0);
	</~~lsl~~>		</syntaxhighlight>
	<~~lsl~~>		<syntaxhighlight lang="lsl2">
	vector myColor;// defaults to ZERO_VECTOR or <0.0, 0.0, 0.0> which is black		vector myColor;// defaults to ZERO_VECTOR or <0.0, 0.0, 0.0> which is black

Line 160:		Line 160:

	llSetText("I am now red and 10% transparent.", myColor, 0.9);		llSetText("I am now red and 10% transparent.", myColor, 0.9);
	</~~lsl~~>		</syntaxhighlight>
	If {{LSLP\|alpha}} is 1.0 it means the {{LSLP\|text}} is fully opaque (alpha), 0.0 would make it completely transparent (invisible):		If {{LSLP\|alpha}} is 1.0 it means the {{LSLP\|text}} is fully opaque (alpha), 0.0 would make it completely transparent (invisible):
	<~~lsl~~>		<syntaxhighlight lang="lsl2">
	llSetText("green text with alpha 0.7", <0.0, 1.0, 0.0>, 0.7);		llSetText("green text with alpha 0.7", <0.0, 1.0, 0.0>, 0.7);

Line 171:		Line 171:
	llSetText("invisible black text with alpha 0.0\nfully transparent", ZERO_VECTOR, 0);		llSetText("invisible black text with alpha 0.0\nfully transparent", ZERO_VECTOR, 0);
	llSetText("invisible black text with alpha 0.0\nfully transparent", <0.0, 0.0, 0.0>, 0.0);		llSetText("invisible black text with alpha 0.0\nfully transparent", <0.0, 0.0, 0.0>, 0.0);
	</~~lsl~~>		</syntaxhighlight>
	===Multiple lines===		===Multiple lines===
	<~~lsl~~>		<syntaxhighlight lang="lsl2">
	// two lines of orange text		// two lines of orange text

	llSetText("I am\non two lines!", <1.0, 0.4, 0.0>, 1.0);		llSetText("I am\non two lines!", <1.0, 0.4, 0.0>, 1.0);
	</~~lsl~~>		</syntaxhighlight>
	\|helpers=		\|helpers=
	Drag this script out of inventory onto an object to erase its set text:		Drag this script out of inventory onto an object to erase its set text:
	<~~lsl~~>		<syntaxhighlight lang="lsl2">
	// http://wiki.secondlife.com/wiki/llSetText		// http://wiki.secondlife.com/wiki/llSetText

Line 194:		Line 194:
	}		}
	}		}
	</~~lsl~~>		</syntaxhighlight>
	Code to easily specify appearance of hovertext:		Code to easily specify appearance of hovertext:
	<~~lsl~~>		<syntaxhighlight lang="lsl2">
	vector NAVY = <0, 0.122, 0.247>;		vector NAVY = <0, 0.122, 0.247>;
	vector BLUE = <0, 0.455, 0.851>;		vector BLUE = <0, 0.455, 0.851>;
Line 226:		Line 226:
	}		}
	}		}
	</~~lsl~~>		</syntaxhighlight>
	To make hovertext under linked prims you can use this simple function:		To make hovertext under linked prims you can use this simple function:
	<~~lsl~~>		<syntaxhighlight lang="lsl2">
	mySetLinkText(integer linknum, string text, vector color, float alpha) {		mySetLinkText(integer linknum, string text, vector color, float alpha) {
	llSetLinkPrimitiveParamsFast(linknum, [PRIM_TEXT, text, color, alpha]);		llSetLinkPrimitiveParamsFast(linknum, [PRIM_TEXT, text, color, alpha]);
Line 242:		Line 242:
	}		}
	}		}
	</~~lsl~~>		</syntaxhighlight>
	\|also		\|also
	\|also_functions		\|also_functions

Strife Onizuka at 17:08, 16 July 2014

2014-07-16T17:08:56Z

← Older revision		Revision as of 10:08, 16 July 2014
Line 143:		Line 143:
	{{!}}-		{{!}}-
	{{!}} style="color: white; background: #111111" {{!}}BLACK		{{!}} style="color: white; background: #111111" {{!}}BLACK
	{{!}}<code><0.00, 0.000, 0.000></code>		{{!}}<code><0.000, 0.000, 0.000></code>
	{{!}}}		{{!}}}

← Older revision		Revision as of 18:06, 29 January 2016
Line 250:		Line 250:
	{{LSL DefineRow\|\|[[:Category:LSL Examples\|Examples]]: [[SplitLine]]\|Insert 'new line' escape codes at certain positions of a string}}		{{LSL DefineRow\|\|[[:Category:LSL Examples\|Examples]]: [[SplitLine]]\|Insert 'new line' escape codes at certain positions of a string}}
	{{LSL DefineRow\|\|Useful snippet: [[llGetObjectPermMask]]\|Label an object with text and newlines to give away or sell}}		{{LSL DefineRow\|\|Useful snippet: [[llGetObjectPermMask]]\|Label an object with text and newlines to give away or sell}}
			{{LSL DefineRow\|\|[[escape codes]]\|for details on how and when they work}}

	\|notes=To actually display text on a prim, see [[XyzzyText]], or consider using parcel prim [[:Category:LSL_Media\|Media]] options (useful only if you have control over the land's media settings.)		\|notes=To actually display text on a prim, see [[XyzzyText]], or consider using parcel prim [[:Category:LSL_Media\|Media]] options (useful only if you have control over the land's media settings.)
	----		----