Second Life Wiki - User contributions [en]

LlGetNotecardLine

2012-12-17T00:17:17Z

Filomena Firelyte: "If the requested line is longer then" to "If the requested line is longer than"

{{LSL_Function
|inject-2={{LSL_Function/negative_index|false|line}}{{LSL_Function/notecard|name|uuid=true}}
|func_id=217|func_sleep=0.1|func_energy=10.0
|sort=GetNotecardLine
|func=llGetNotecardLine
|return_type=key
|p1_type=string|p1_name=name
|p2_type=integer|p2_name=line|p2_desc=Line number in a notecard (the index starts at zero).
|func_desc=Requests the line {{LSLP|line}} of the notecard {{LSLP|name}} from the dataserver.
|return_text=that is the handle for a [[dataserver]] event response.
|func_footnote=If {{LSLP|line}} is past the end of the notecard [[EOF]] is returned by the [[dataserver]].
|spec
|caveats=* If notecard contains embedded inventory items (such as textures and landmarks), [[EOF]] will be returned, regardless of the line requested.
*If the requested line is longer than 255 bytes the [[dataserver]] will return the first 255 bytes of the line.
|constants
|examples=
<lsl>
key notecardQueryId;
string notecardName = "name of notecard as in object's contents";

// first notecard line is line 0
integer notecardLine;

say(string inputString)
{
llSay(PUBLIC_CHANNEL, inputString);
}

default
{
state_entry()
{
// say("reading notecard named '" + notecardName + "'.");
notecardQueryId = llGetNotecardLine(notecardName, notecardLine);
}

dataserver(key query_id, string data)
{
if (query_id == notecardQueryId)
{
if (data == EOF)
say("Done reading notecard, read " + (string)(notecardLine + 1) + " notecard lines.");
else
{
// the first line is line 0, the second line is line 1, etc.
say(data);

++notecardLine;
notecardQueryId = llGetNotecardLine(notecardName, notecardLine);
}
}
}
}
</lsl>
|helpers=
<lsl>
/////
// Generic Multi Notecard reader by Brangus Weir
// Given freely and published on wiki.secondlife.com
//
// This script will read three note cards and store the results into three lists.
// It can be modified and extended to as many (or few) cards as you'd like to read.
//

list gOneCard; // All the lines from from the first card
list gTwoCard; // All the lines from from the second card
list gThreeCard; // All the lines from from the third card

string gsCardOneName = "One"; //Set these to the name of the invetory item.
string gsCardTwoName = "Two";
string gsCardThreeName = "Three";

//Temporary variables for processing
string g_sNoteCardName; // Name of the card to be read.
list g_lTempLines; // The resulting data pushed into a list
integer g_iLine; // The line count for the card reader
key g_kQuery; // The key of the card being read

initialize(string _action) {
// Due to the execution order when using dataserver, this function sets the first card to
// be read, and the excetuion finishes when called again with the _action set to "finish".
if (_action == "") {
loadNoteCard(gsCardOneName);
} else if (_action == "finish") {
// All cards have been read into the lists... now you can do any kind of string
// manipulations to get the data you need to set your script.
// But here we will prove that the cards have been read with a loop

g_lTempLines = []; // lets not forget to delete this global, or it will be dead weight.

integer len = llGetListLength(gOneCard); //Always evaluate this once, don't do it
//INSIDE the for loop like noob programers will.
//Reduce lag, THINK ABOUT MACHINE CYCLES!
integer i = 0;
for (; i< len; ++i)
llSay(0, llList2String(gOneCard,i));

len = llGetListLength(gTwoCard);
for (i = 0; i< len; ++i)
llSay(0, llList2String(gTwoCard,i));

len = llGetListLength(gThreeCard);
for (i = 0; i< len; ++i)
llSay(0, llList2String(gThreeCard,i));
}

}

loadNoteCard( string _notecard ) {
g_lTempLines = []; //clear the temp lines
g_sNoteCardName = _notecard;
g_iLine = 0;
g_kQuery = llGetNotecardLine(g_sNoteCardName, g_iLine);

}

notecardFinished(string _notecard){
// Called at the end of each notecard as it is read. The temp results are stored
// and the next card is commanded to be read.
if (_notecard == gsCardOneName) {
gOneCard = g_lTempLines;
loadNoteCard(gsCardTwoName);
} else if (_notecard == gsCardTwoName) {
gTwoCard = g_lTempLines;
loadNoteCard(gsCardThreeName);
} else if (_notecard == gsCardThreeName) {
gThreeCard = g_lTempLines;
initialize("finish"); // Finally pass execution to finish the initialization.
}
}

default
{
state_entry()
{
}

touch_start(integer _num_det){
initialize("");
}

dataserver(key _query_id, string _data)
{
if (_query_id == g_kQuery) {
// this is a line of our notecard
if (_data != EOF) {
g_lTempLines += _data;
//request a next line
++g_iLine; // increment line count
g_kQuery = llGetNotecardLine(g_sNoteCardName, g_iLine);
} else {
//The notecard has been read
//notify end of read
notecardFinished(g_sNoteCardName);
}
}
}
}
</lsl>

<lsl>
/////
// Generic Multi Notecard reader by Randur Source
// Given freely and published on wiki.secondlife.com
//
// This script will read all note cards in sequence and dump the results into chat as an example.
// It can be modified and extended to do other things to the data.
//

integer inventorycnt;
integer notecardlinecnt;
integer notecardlinenumber;
string notecardname;
key linenumberid;
key lineid;

getnextnotecardlinenumber()
{
// first get the number of lines from the notecard
inventorycnt++;
if (inventorycnt < llGetInventoryNumber(INVENTORY_NOTECARD))
{
notecardname = llGetInventoryName(INVENTORY_NOTECARD,inventorycnt);
linenumberid = llGetNumberOfNotecardLines(notecardname);
}
else
llOwnerSay("Done.");
}

getnextnotecardline()
{
// get the next line from the notecard or skip to the next notecard
notecardlinecnt++;
if (notecardlinecnt < notecardlinenumber)
lineid = llGetNotecardLine(notecardname,notecardlinecnt);
else
getnextnotecardlinenumber();
}

default
{
touch_start(integer total_number)
{
if (llDetectedKey(0) != llGetOwner()) return; // allow owner only

inventorycnt = -1;
getnextnotecardlinenumber();
}

dataserver(key queryid,string data)
{
if (queryid == linenumberid) // this was a line number lookup
{
linenumberid = NULL_KEY;
notecardlinenumber = (integer)data;
if (notecardlinenumber == 0)
getnextnotecardlinenumber();
else
{
notecardlinecnt = -1;
getnextnotecardline();
}
}
else if (queryid == lineid) // this was a data line lookup
{
lineid = NULL_KEY;

// Example of what to do with the data:
// Test for valid avatar names, possibly multiple names on each line, separated by ,
// and say them in chat to the owner
list names = llParseString2List(data,[","],[]); // split lines on ,
integer len = llGetListLength(names); // I wouldn't dare to put this inside the for loop
integer cnt;
for (cnt = 0; cnt < len; cnt++)
{
string name = llDumpList2String(llParseString2List(llList2String(names,cnt),[" "],[])," "); // remove extra spaces
if (llGetListLength(llParseString2List(name,[" "],[])) == 2) // check for first + lastname
llOwnerSay(notecardname + ": " + name);
}

getnextnotecardline();
}
}
}

</lsl>
|also_functions={{LSL DefineRow||[[llGetNumberOfNotecardLines]]|}}
|also_events={{LSL DefineRow||[[dataserver]]|}}
|also_articles
|also_tests
|notes=The notecard read can be no modify, or no modify/no copy.
|permission
|cat1=Notecard
|cat2=Dataserver
|cat3=
|cat4=
}}

LSL3

2012-12-02T23:10:30Z

Filomena Firelyte: /* Types */ added const suggestion

{{RightToc}}
== Purpose ==
The purpose of the LSL3 project is to design a new programing language that would replace LSL2 in Second Life.

== Design Ideals ==
*It should be designed to enable expression and not hinder expression with complex or over burdensome syntax requirements.
*C style syntax and order of operations
*Type safety
*Strongly Typed

== Goal ==
* Address the shortcomings of LSL2 and add new functionality while limiting the increase of language complexity.
* Design LSL3 with Hierarchical Linking in mind {{Jira|MISC-2237}}

== Proposed Changes for LSL2 ==
Here are some proposed changes to LSL2. Please add new changes, if they cannot be summed up in a single sentence please create a subpage to this article and put a link in the appropriate section.

=== Major changes ===
* Object model
* Get rid of get and set functions, use getters and setters instead where possible (syntax sugar).
* Persistent storage/memory

=== Syntax ===
* Fix quaternion ordering
* Provide quaternion-scalar multiplication
* Provide quaternion exponentiation q^a where a is a float. (Useful for interpolating rotations to achieve smoothness)
* Object model for base types
* Array indexer
* continue and break keywords.
* switch statement.

=== Types ===
* User defined class & structures
** Duck Typing (LinFu?)
** Anonymous classes?
* bool type
* pointers
* Remove restriction on lists containing lists
* const

=== Functions ===
* Organized into static classes?
* Or keep the namespace flat to keep the syntax simple.

=== States & Events ===
* State variables.
* User defined events that can be triggered by external scripts.
* Functions that are only available to specific states.

=== Libraries ===
* Script libraries that can be sold and passed around.
* Natural syntax which can be used instead of link_message

== Flaws with LSL2 ==
Here is a list of flaws with LSL2 that should be fixed.
=== Combining Quaternions ===
* See {{JIRA|SVC-1047}} for a full description of this.

=== Evaluation order ===
* Given the code <code>f(a) + g(a)</code>, currently <code>g(a)</code> gets executed before <code>f(a)</code>.
** Changing this so <code>f(a)</code> gets executed first should improve performance on Mono.

===Comparisons of lists===
*Only length is compared.
*The result of a list equality is the difference of the lengths.

==='if else' syntax===
* <code>if([1])</code> evaluates to false.
* <code>if !(STRING)</code> gives syntax error, forcing <code>if (STRING == "")</code> Applies to all types in which ! cannot be put directly in front.

=== [[PRIM_ROTATION]] ===
* For child prims this requires dividing out the root prims rotation.

=== [[llInsertString]] ===
* Does not support negative indexes.

=== {{LSLGC|Detected|llDetected*}} Functions ===
* Do not support negative indexes.

== Resources ==
*{{Jira|SVC-1657}}

LSL3

2012-12-02T23:09:20Z

Filomena Firelyte: /* States & Events */ Added suggestion

{{RightToc}}
== Purpose ==
The purpose of the LSL3 project is to design a new programing language that would replace LSL2 in Second Life.

== Design Ideals ==
*It should be designed to enable expression and not hinder expression with complex or over burdensome syntax requirements.
*C style syntax and order of operations
*Type safety
*Strongly Typed

== Goal ==
* Address the shortcomings of LSL2 and add new functionality while limiting the increase of language complexity.
* Design LSL3 with Hierarchical Linking in mind {{Jira|MISC-2237}}

== Proposed Changes for LSL2 ==
Here are some proposed changes to LSL2. Please add new changes, if they cannot be summed up in a single sentence please create a subpage to this article and put a link in the appropriate section.

=== Major changes ===
* Object model
* Get rid of get and set functions, use getters and setters instead where possible (syntax sugar).
* Persistent storage/memory

=== Syntax ===
* Fix quaternion ordering
* Provide quaternion-scalar multiplication
* Provide quaternion exponentiation q^a where a is a float. (Useful for interpolating rotations to achieve smoothness)
* Object model for base types
* Array indexer
* continue and break keywords.
* switch statement.

=== Types ===
* User defined class & structures
** Duck Typing (LinFu?)
** Anonymous classes?
* bool type
* pointers
* Remove restriction on lists containing lists

=== Functions ===
* Organized into static classes?
* Or keep the namespace flat to keep the syntax simple.

=== States & Events ===
* State variables.
* User defined events that can be triggered by external scripts.
* Functions that are only available to specific states.

=== Libraries ===
* Script libraries that can be sold and passed around.
* Natural syntax which can be used instead of link_message

== Flaws with LSL2 ==
Here is a list of flaws with LSL2 that should be fixed.
=== Combining Quaternions ===
* See {{JIRA|SVC-1047}} for a full description of this.

=== Evaluation order ===
* Given the code <code>f(a) + g(a)</code>, currently <code>g(a)</code> gets executed before <code>f(a)</code>.
** Changing this so <code>f(a)</code> gets executed first should improve performance on Mono.

===Comparisons of lists===
*Only length is compared.
*The result of a list equality is the difference of the lengths.

==='if else' syntax===
* <code>if([1])</code> evaluates to false.
* <code>if !(STRING)</code> gives syntax error, forcing <code>if (STRING == "")</code> Applies to all types in which ! cannot be put directly in front.

=== [[PRIM_ROTATION]] ===
* For child prims this requires dividing out the root prims rotation.

=== [[llInsertString]] ===
* Does not support negative indexes.

=== {{LSLGC|Detected|llDetected*}} Functions ===
* Do not support negative indexes.

== Resources ==
*{{Jira|SVC-1657}}

LlMinEventDelay

2012-11-30T19:36:31Z

Filomena Firelyte: Removed event category for this is not an event but a mere function.

{{LSL_Function
|func_id=125|func_sleep=0.0|func_energy=10.0
|sort=MinEventDelay
|func=llMinEventDelay
|p1_type=float|p1_name=delay|p1_desc=time in seconds
|func_footnote
|func_desc=Set the minimum time between events being handled.

Defaults and minimums vary by the event type, see [[LSL Delay]].
|return_text
|spec
|caveats
|constants
|examples=
<lsl>default
{
state_entry()
{
llMinEventDelay(5.0);
}
touch(integer detected)
{
llSay(0, "Touched.");//Without the event delay set touch would cause the screen to fill
//with the word "Touched" in a split second if you held the mouse button down.
}
}</lsl>

Where as, if in one object you place this script (for the sake of fun call the object "Sandy Powell"). -

<lsl>default
{
touch(integer detected)
{
llSay(0, "Can you hear me mother?");//Northern English accent. Catch phase of Sandy Powell (comedian).
}
}</lsl>

and this in another object called "Mother" -

<lsl>default
{
state_entry()
{
llMinEventDelay(5.0);
llListen(0, "Sandy Powell", "", "");
}
listen(integer chan, string name, key id, string msg)
{
llSay(0, "Eh?");
}
}</lsl>

the result in chat is as follows -

<pre>
[12:51] Sandy Powell: Can you hear me mother?
[12:51] Mother: Eh?
[12:51] Sandy Powell: Can you hear me mother?
[12:51] Sandy Powell: Can you hear me mother?
[12:51] Sandy Powell: Can you hear me mother?
[12:51] Sandy Powell: Can you hear me mother?
[12:51] Sandy Powell: Can you hear me mother?
[12:51] Sandy Powell: Can you hear me mother?
[12:51] Sandy Powell: Can you hear me mother?
[12:51] Sandy Powell: Can you hear me mother?
[12:51] Sandy Powell: Can you hear me mother?
[12:51] Sandy Powell: Can you hear me mother?
[12:51] Sandy Powell: Can you hear me mother?
[12:51] Sandy Powell: Can you hear me mother?
[12:51] Sandy Powell: Can you hear me mother?
[12:51] Sandy Powell: Can you hear me mother?
[12:51] Sandy Powell: Can you hear me mother?
[12:51] Sandy Powell: Can you hear me mother?
[12:51] Sandy Powell: Can you hear me mother?
[12:51] Sandy Powell: Can you hear me mother?
[12:51] Sandy Powell: Can you hear me mother?
[12:51] Sandy Powell: Can you hear me mother?
[12:51] Sandy Powell: Can you hear me mother?
[12:51] Sandy Powell: Can you hear me mother?
[12:51] Sandy Powell: Can you hear me mother?
[12:51] Sandy Powell: Can you hear me mother?
[12:51] Sandy Powell: Can you hear me mother?
[12:51] Sandy Powell: Can you hear me mother?
[12:51] Sandy Powell: Can you hear me mother?
[12:51] Sandy Powell: Can you hear me mother?
[12:51] Sandy Powell: Can you hear me mother?
[12:51] Mother: Eh?
[12:51] Mother: Eh?
[12:51] Mother: Eh?
[12:51] Mother: Eh?
[12:51] Mother: Eh?
[12:51] Mother: Eh?
[12:52] Mother: Eh?
[12:52] Mother: Eh?
[12:52] Mother: Eh?
[12:52] Mother: Eh?
[12:52] Mother: Eh?
[12:52] Mother: Eh?
[12:52] Mother: Eh?
</pre>
and no more events are triggered. This is an example of lost transferred info because of [[llMinEventDelay]] so be careful with it.
|helpers
|also_functions
|also_events
|also_articles=
{{LSL DefineRow||[[LSL Delay]] |for default values}}
|also_tests
|notes
|permission
|negative_index
|cat1=Script
|cat2
|cat3
|cat4
}}