Text Scroller - Revision history

ObviousAltIsObvious Resident: tag to

2015-01-25T16:30:11Z

← Older revision		Revision as of 09:30, 25 January 2015
Line 15:		Line 15:
	*Create a fresh new prim and drop this script onto/into it. The prim will form the shape needed plus change the texturing etc. (you can do what you like to the texturing afterwards)		*Create a fresh new prim and drop this script onto/into it. The prim will form the shape needed plus change the texturing etc. (you can do what you like to the texturing afterwards)

	<~~lsl~~>default		<source lang="lsl2">default
	{		{
	state_entry()		state_entry()
Line 28:		Line 28:
	llRemoveInventory(llGetScriptName()); // Remove the script when done		llRemoveInventory(llGetScriptName()); // Remove the script when done
	}		}
	}</~~lsl~~>		}</source>

	*When the script has worked its magic, [[How_to_use_the_building_grid_-_Video_Tutorial \| Snap the prim to the grid]] with a grid size of .5 meters.		*When the script has worked its magic, [[How_to_use_the_building_grid_-_Video_Tutorial \| Snap the prim to the grid]] with a grid size of .5 meters.
Line 44:		Line 44:
	*'''DO NOT CREATE A FRESH SCRIPT IN EACH PRIM. DROP THE SAME SCRIPT FROM YOUR INVENTORY INTO EACH PRIM.'''		*'''DO NOT CREATE A FRESH SCRIPT IN EACH PRIM. DROP THE SAME SCRIPT FROM YOUR INVENTORY INTO EACH PRIM.'''

	<~~lsl~~>string font = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz1234567890(){}[]<>\|\\/.,;:'!?\"£$%^&*_+-=~#@ ";		<source lang="lsl2">string font = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz1234567890(){}[]<>\|\\/.,;:'!?\"£$%^&*_+-=~#@ ";
	// A accurate representation of the characters featured on the texture used to display the text.		// A accurate representation of the characters featured on the texture used to display the text.

Line 76:		Line 76:
	17, 6, id, <0.1, 0.1, 0.0>, GetOffset(llGetSubString(msg, my_ss_6, my_ss_6)), 0.0]);		17, 6, id, <0.1, 0.1, 0.0>, GetOffset(llGetSubString(msg, my_ss_6, my_ss_6)), 0.0]);
	} // Set the texture to the correct offset to display the correct characters		} // Set the texture to the correct offset to display the correct characters
	}</~~lsl~~>		}</source>
	}}		}}
	{{box\|Control Script\|		{{box\|Control Script\|
Line 86:		Line 86:
	*Drop this script into the root.		*Drop this script into the root.

	<~~lsl~~>integer count; // Used to keep track of itterations		<source lang="lsl2">integer count; // Used to keep track of itterations

	integer length; // A measure of string length		integer length; // A measure of string length
Line 140:		Line 140:
	llResetScript(); // So reset the script to read the new card		llResetScript(); // So reset the script to read the new card
	}		}
	}</~~lsl~~>		}</source>

	*The object should be set with the text "Touch Start Scroll.". If you get something else, you haven't followed these instructions.		*The object should be set with the text "Touch Start Scroll.". If you get something else, you haven't followed these instructions.

Fred Gandt: Trying to use "red lettering" in a box broke the box. I used '''bold''' instead.

2010-04-29T17:34:34Z

Trying to use "<font style="color:red;">red lettering</font>" in a box broke the box. I used '''bold''' instead.

@@ Line 77: / Line 77: @@
      } // Set the texture to the correct offset to display the correct characters
 }</lsl>
 }}
 {{box|The Charsheet Texture|

Fred Gandt: nope it broke the page..continuing to try to fix.

2010-04-29T17:23:10Z

nope it broke the page..continuing to try to fix.

@@ Line 77: / Line 77: @@
      } // Set the texture to the correct offset to display the correct characters
 }</lsl>
 }}
 {{box|The Charsheet Texture|

Fred Gandt: Attempting to add new contents to a box but, the preview is showing the box as empty. Seeing if a true save fixes this.

2010-04-29T17:19:55Z

Attempting to add new contents to a box but, the preview is showing the box as empty. Seeing if a true save fixes this.

← Older revision		Revision as of 10:19, 29 April 2010
Line 80:		Line 80:
	{{box\|Control Script\|		{{box\|Control Script\|
	*One possible way amongst many to feed the text to the script is by notecard. That is the way [[User:Fred_Gandt\|I]] set this script. As such, you need a notecard in the root containing the text you wish to display. Only one notecard will be read. If you add more notecards (without altering the script) it will read the first it finds alphabetically.		*One possible way amongst many to feed the text to the script is by notecard. That is the way [[User:Fred_Gandt\|I]] set this script. As such, you need a notecard in the root containing the text you wish to display. Only one notecard will be read. If you add more notecards (without altering the script) it will read the first it finds alphabetically.
			*There is a [[LlGetNotecardLine#Caveats caveat]] regarding the length of the lines of text in the notecard. If the line is longer then 255 bytes the [[dataserver]] will return the first 255 bytes of the line. Taken from one of Shakespeare's Hamlet's soliloques (To be, or not to be?...) this line is too long by the red lettering -
			**"For who would bear the whips and scorns of time, th'oppressor's wrong, the proud man's contumely, the pangs of despised love, the law's delay, the insolence of office, and the spurns that patient merit of th'unworthy takes, when he himself might his quiet<font style="color:red;">us make with a bare bodkin?</font>"
	*Add your text notecard to the root.		*Add your text notecard to the root.
	*Drop this script into the root.		*Drop this script into the root.

Fred Gandt: Added note that these scripts should be mono

2010-04-25T06:51:37Z

Added note that these scripts should be mono

← Older revision		Revision as of 23:51, 24 April 2010
Line 6:		Line 6:

	Updated: 24 April 2010 by The Creator [[User:Fred_Gandt\|Fred Gandt]]		Updated: 24 April 2010 by The Creator [[User:Fred_Gandt\|Fred Gandt]]

			'''All these scripts should be compiled as MONO'''

	A simple text display object that scrolls text (applied as a texture) from right to left (like ''those'' LED signs) in a continuous loop.		A simple text display object that scrolls text (applied as a texture) from right to left (like ''those'' LED signs) in a continuous loop.

Fred Gandt: Minor edits to notes.

2010-04-24T13:41:24Z

Minor edits to notes.

← Older revision		Revision as of 06:41, 24 April 2010
Line 36:		Line 36:

	*Link the set.		*Link the set.
			*'''DO NOT LINK THE OBJECT TO ANYTHING ELSE. IT MUST BE A STAND ALONE OBJECT''' (unless you feel like editing the scripts to compensate)
	}}		}}
	{{box\|Display Script\|		{{box\|Display Script\|
Line 109:		Line 110:
	{		{
	length = llStringLength(text); // Establish the length of our text		length = llStringLength(text); // Establish the length of our text
			// The number 19 is 1 less than the number of faces (2 per prim) that display text. Change that number accordingly if...
			// ...you have a larger or smaller number of prims in your object.
	llMessageLinked(-1, 0, llGetSubString("Touch start scroll.", count, (count + 19)), "b6349d2d-56bf-4c18-4859-7db0771990a5");		llMessageLinked(-1, 0, llGetSubString("Touch start scroll.", count, (count + 19)), "b6349d2d-56bf-4c18-4859-7db0771990a5");
	} // Message the display scripts that we are ready to function		} // Message the display scripts that we are ready to function

Fred Gandt: Adding this script to the LSL Library since I think it is quite a good demo.

2010-04-24T13:16:49Z

Adding this script to the LSL Library since I think it is quite a good demo.

New page

{{LSL Header}}

{{RightToc|right;}}

= Text Scroller ( V1 ) =

Updated: 24 April 2010 by The Creator [[User:Fred_Gandt|Fred Gandt]]

A simple text display object that scrolls text (applied as a texture) from right to left (like ''those'' LED signs) in a continuous loop.
*Touch start/stop.

{{box|Create The Object|
*Create a fresh new prim and drop this script onto/into it. The prim will form the shape needed plus change the texturing etc. (you can do what you like to the texturing afterwards)

<lsl>default
{
state_entry()
{
llSetPrimitiveParams([7, <0.5, 0.01, 0.25>, // Set the size
8, <0.0, 0.0, 0.0, 1.0>, // Set to ZERO_ROTATION
9, 0, 0, <0.375, 0.875, 0.0>, 0.0, <0.0, 0.0, 0.0>, <1.0, 1.0, 0.0>, <0.0, 0.0, 0.0>, // Shape the prim
17, -1, "5748decc-f629-461c-9a36-a35a221fe21f", <1.0, 1.0, 0.0>, <0.0, 0.0, 0.0>, 0.0, // Apply the blank texture
18, -1, <1.0, 0.65, 0.1>, 1.0, // Color the prim (kinda orange)
20, -1, 1, // Make fullbright
25, -1, 0.05]); // Slight glow
llRemoveInventory(llGetScriptName()); // Remove the script when done
}
}</lsl>

*When the script has worked its magic, [[How_to_use_the_building_grid_-_Video_Tutorial | Snap the prim to the grid]] with a grid size of .5 meters.
*Shift-Drag-Copy the prim, snapping each to the grid positively along the X axis until you have 10 prims in a continuous strip.
*You can actually make the object as long or short as you like. 1 prim will work. 100 prims will work (although large linksets have been a problem for [[link_message]]s in the past). Just follow the same basic build plan.
*Select each of the prims from the end that has the greatest X axis position, one at a time (negatively along the X axis) until ALL are selected.

[[Image:Text Scroller How It Should Look jpg.jpg|600px]]

*Link the set.
}}
{{box|Display Script|
*Check "Edit Linked parts" and select one prim at a time, dropping this script in each.
*'''DO NOT CREATE A FRESH SCRIPT IN EACH PRIM. DROP THE SAME SCRIPT FROM YOUR INVENTORY INTO EACH PRIM.'''

<lsl>string font = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz1234567890(){}[]<>|\\/.,;:'!?\"£$%^&*_+-=~#@ ";
// A accurate representation of the characters featured on the texture used to display the text.

vector GetOffset(string s)
{
if(s == "") // If there is no text
s = " "; // Use a space
integer i = llSubStringIndex(font, s); // Find the character
if(i == -1) // If we can't find it
i = 94; // Use a space
return <(-0.45 + ((i % 10) * 0.1)), (0.45 - (llRound(i / 10) * 0.1)), 0.0>;
} // Return the offset needed to display the correct section of the texture by doing the mathematics *coughs*

integer me; // Used to store the Link number

integer my_ss_5; // Used to store the index of the feed text we display on face 5

integer my_ss_6; // Used to store the index of the feed text we display on face 6

default
{
state_entry()
{
me = llGetLinkNumber();
my_ss_6 = ((me - 1) * 2); // Whatever link we are (in a correctly built object) establish the index to grab
my_ss_5 = (my_ss_6 + 1); // And also grab the next
}
link_message(integer sender, integer num, string msg, key id)
{
llSetLinkPrimitiveParamsFast(me, [17, 5, id, <0.1, 0.1, 0.0>, GetOffset(llGetSubString(msg, my_ss_5, my_ss_5)), 0.0,
17, 6, id, <0.1, 0.1, 0.0>, GetOffset(llGetSubString(msg, my_ss_6, my_ss_6)), 0.0]);
} // Set the texture to the correct offset to display the correct characters
}</lsl>
}}
{{box|Control Script|
*One possible way amongst many to feed the text to the script is by notecard. That is the way [[User:Fred_Gandt|I]] set this script. As such, you need a notecard in the root containing the text you wish to display. Only one notecard will be read. If you add more notecards (without altering the script) it will read the first it finds alphabetically.
*Add your text notecard to the root.
*Drop this script into the root.

<lsl>integer count; // Used to keep track of itterations

integer length; // A measure of string length

string text = " "; // Adding this creates a gap between beginning and end of text

integer NCC; // NoteCardCount for tracking which line to read

string NC; // NoteCard name

integer on; // Are we on or off?

default
{
state_entry()
{
NC = llGetInventoryName(INVENTORY_NOTECARD, 0); // Establish the name of our NC
llGetNotecardLine(NC, NCC); // Ask for the first line
}
dataserver(key q, string data)
{
if(data != EOF) // If the data is useful
{
text += (data + " "); // Store it
llGetNotecardLine(NC, (++NCC)); // And get the next line
}
else // If not useful we are at the end of the NC
{
length = llStringLength(text); // Establish the length of our text
llMessageLinked(-1, 0, llGetSubString("Touch start scroll.", count, (count + 19)), "b6349d2d-56bf-4c18-4859-7db0771990a5");
} // Message the display scripts that we are ready to function
}
timer()
{
if(count == length) // If we have gone full circle
count = 0; // Start again
llMessageLinked(-1, 0, llGetSubString(text, count, (count + 19)), "b6349d2d-56bf-4c18-4859-7db0771990a5");
++count; // Message the display scripts with a chunk of text
}
touch_end(integer nd)
{
if(on) // Are we running?
llSetTimerEvent(0.0); // Stop the timer
else // No?
llSetTimerEvent(0.15); // Start the timer
on = (!on); // Remember what we did
}
changed(integer change)
{
if(change & CHANGED_INVENTORY) // If the inventory has changed the NC may have
llResetScript(); // So reset the script to read the new card
}
}</lsl>

*The object should be set with the text "Touch Start Scroll.". If you get something else, you haven't followed these instructions.
}}
{{box|The Charsheet Texture|
*[[User:Fred_Gandt|I]] am a scriptor, not a texturizerer. I created a very simple Charsheet (Character Sheet) to get you going but, it isn't very good *grins*. You will probably want to replace it.

*The texture MUST be 10 characters by 10 characters (you may have empty spaces so, 56 chars is fine so long as the grid is the full 100 spaces).
*Unlike the texture I have supplied...ALL the chars should be perfectly evenly spaced and not spreading into the neighboring spaces.
*This is the texture supplied. You don't need to copy this. The script already has the [[UUID]] in it.

[[Image:Charsheet Mono Black on White jpg.jpg|500px]]

*The display scripts contain a string that is in the exact same order the chars are read from top left to bottom right (row by row, not column by column).
*'''HAVING THE SAME ORDER OF CHARS IN THE TEXTURE AND STRING IS VITAL.'''
*The order you choose is entirely up to you as long as the strings in ALL the display scripts match the order of chars in the texture.
*Don't forget to include a blank grid space on your 10 x 10 texture for a space "character". There also needs to be an empty space (in the correct place) in the scripts.
*In the display script strings there are two characters that must be treated unusually. The \ and the " must have a \ placed before them.
**Example "ABCabc123.,:\"\\/<nowiki>|</nowiki> " Note the included space and the way the \ and " have a \ before them.
}}
{{box|Functions Used|
#[[llSetPrimitiveParams]] - Set shapes, colors, textures and other parameters of the prim the script is in.
#[[llRemoveInventory]] - Remove the named inventory from the prim contents.
#[[llGetScriptName]] - Returns the name of the script that calls the function.
#[[llSubStringIndex]] - Searches a string for a test and returns the index (or -1 if not found)
#[[llRound]] - Returns a classically rounded (up or down; whichever is closest) float as an integer.
#[[llGetLinkNumber]] - Establish the link number of the prim the script is in.
#[[llGetSubString]] - Returns the part of the source string specified.
#[[llSetLinkPrimitiveParamsFast]] - Set parameters in any prim in a link-set without enforced delay.
#[[llGetInventoryName]] - Returns the name of the specified inventory type at index.
#[[llStringLength]] - Establish how many characters make up the source string.
#[[llGetNotecardLine]] - Requests the string data on line of named notecard and (if successful) [[dataserver]] returns the result.
#[[llMessageLinked]] - Send a message to defined links (or self) which are picked up by [[link_message]]
#[[llSetTimerEvent]] - Establish a repeating time frame that on each pass will trigger [[timer]]
#[[llResetScript]] - Wipe the memory and start from the word "default".
}}
{{box|Events Used|
#[[state_entry]] - Triggered when entering the state this event is in.
#[[link_message]] - Triggered if [[llMessageLinked]] sends a message to the link containing this event.
#[[dataserver]] - Triggered with responses to requests for data made by various functions.
#[[timer]] - Triggered if a set time has elapsed then again after that time elapses again ad infinitum until the set time is zero.
#[[touch_end]] - Triggered by an agent left clicking the object containing the script.
#[[changed]] - Triggered by various changes that the script can sense.
}}
{{LSLC|Library}}