Second Life Wiki - User contributions [en]

LlGetLinkName

2007-09-27T13:41:34Z

Core Taurog:

{{LSL_Function/link|linknum|}}
{{LSL_Function
|func_id=145|func_sleep=0.0|func_energy=10.0
|func=llGetLinkName
|return_type=string|p1_type=integer|p1_name=linknum
|func_footnote
|func_desc
|return_text=that is the name of '''linknum''' in link set
|spec
|caveats=*The prim name attribute is limited to 255 bytes, any string longer then that will be truncated. This truncation does not always happen when the attribute is set or read.
|constants
|examples=Listen on channel 10 for a name; check if a prim with that name is part of this object
<Pre>
integer check_for_prim(string name)
{
integer i = llGetNumberOfPrims();
for (; i >= 0; --i)
{
if (llGetLinkName(i) == name)
{
return TRUE;
}
}
return FALSE;
}
default
{
state_entry()
{
llListen(10, "", llGetOwner(), "");
}
listen(integer chan, string obj, key id, string msg)
{
if (check_for_prim(msg))
{
llOwnerSay("found a linked prim named \"" + msg + "\"");
}
else
{
llOwnerSay("this object does not have any linked prims named \"" + msg + "\"");
}
}
}
</Pre>
|helpers
|also_functions=
{{LSL DefineRow||[[llGetLinkKey]]|Gets the instance UUID of the link}}
{{LSL DefineRow||[[llGetObjectName]]|Get the prims name}}
{{LSL DefineRow||[[llSetObjectName]]|Set the prims name}}
{{LSL DefineRow||[[llGetObjectDesc]]|Get the prims description}}
{{LSL DefineRow||[[llSetObjectDesc]]|Get the prims description}}
{{LSL DefineRow||[[llGetObjectDetails]]}}
|also_tests
|also_events
|also_articles=
{{LSL DefineRow||[[Prim Attribute Overloading]]}}
|notes
|cat1=Link
|cat2
|cat3
|cat4
}}

LlGetListLength

2007-09-27T13:33:31Z

Core Taurog:

{{LSL_Function
|func_id=185|func_sleep=0.0|func_energy=10.0
|func=llGetListLength|return_type=integer|p1_type=list|p1_name=src
|func_footnote
|func_desc
|return_text=that is the number of elements in the list '''src'''.
|spec
|caveats
|constants
|examples=
<Pre>
default
{
state_entry()
{
list l = ["one", "two", "three"];
integer i = llGetListLength(l);
llOwnerSay("there are " + (string)i + " entries in the list");
}
}
</Pre>
|notes=A faster and lighter (in bytecode) way to determine the length of a script is to do a not-equals compare with a null list. This works because the list not-equals compare returns the difference between the lengths.
<pre>
list in;
integer len_in = llGetListLength(in);
integer flen_in = (in != []);
//flen_in and len_in will be the same

integer neg_len_in = -llGetListLength(in);
integer fneg_len_in = ([] != in);
//fneg_len_in and neg_len_in will be the same
</pre>
|helpers
|also_functions=
{{LSL DefineRow||[[llListStatistics]]|[[LIST_STAT_NUM_COUNT]] – Returns the number of [[integer]]s and [[float]]s in the list}}
{{LSL DefineRow||[[llStringLength]]|Returns the number of characters in a string.}}
|also_events
|also_tests
|also_articles
|permission
|location=
'linden\indra\lscript\lscript_library\lscript_alloc.cpp' @ lsa_cmp_lists 
'linden\indra\lscript\lscript_execute\lscript_execute.cpp' @ list_list_operation
|cat1=List
|cat2
|cat3
|cat4
}}

LlGetNumberOfNotecardLines

2007-09-27T13:33:19Z

Core Taurog:

{{LSL_Function/inventory|name|uuid=false|type=notecard}}{{LSL_Function
|func_id=276|func_sleep=0.1|func_energy=10.0
|func=llGetNumberOfNotecardLines
|return_type=key
|p1_type=string|p1_name=name
|func_footnote
|func_desc=Requests number of lines in notecard '''name''' via the {{LSLG|dataserver}} event (cast dataserver value to integer)
|return_text=that is the handle for a {{LSLG|dataserver}} event response.
|spec
|caveats=* If notecard contains embedded inventory items (such as textures and landmarks), invalid data will be returned.
|constants
|examples=
<Pre>
string NOTECARD_NAME = "config"; // name of the card we are going to read
integer notecard_line = 0;
integer num_notecard_lines = 0;
key notecard_request = NULL_KEY;
list card_data; // the data in the card

integer
check_card(string name) // check that that the named inventory item is a notecard
{
integer i = llGetInventoryType(name);
return i == INVENTORY_NOTECARD;
}

default
{
state_entry()
{
state init;
}
}

state ready
{
touch_start(integer detected)
{
llOwnerSay("the notecard contained the following data:");
llOwnerSay(llDumpList2String(card_data, "\n"));
}
changed(integer change)
{
if (change & (CHANGED_INVENTORY)) // if someone edits the card, reset the script
{
llResetScript();
}
}
}

state init
{
state_entry()
{
if (!check_card(NOTECARD_NAME)) // check the card exists
{
state error;
}
llSetText("initialising...", <1, 1, 1>, 0);
notecard_request = NULL_KEY;
notecard_line = 0;
num_notecard_lines = 0;
notecard_request = llGetNumberOfNotecardLines(NOTECARD_NAME); // ask for the number of lines in the card
llSetTimerEvent(5.0); // if we don't hear back in 5 secs, then the card might have been empty
}
timer() // if we time out, it meant something went wrong - the notecard was probably empty
{
llSetTimerEvent(0.0);
state error;
}
dataserver(key query_id, string data)
{
if (query_id == notecard_request) // make sure it's an answer to a question we asked - this should be an unnecessary check
{
llSetTimerEvent(0.0); // at least one line, so don't worry any more
if (data == EOF) // end of the notecard, change to ready state
{
state ready;
}
else if (num_notecard_lines == 0) // first request is for the number of lines
{
num_notecard_lines = (integer)data;
notecard_request = llGetNotecardLine(NOTECARD_NAME, notecard_line); // now get the first line
}
else
{
if (data != "" && llGetSubString(data, 0, 0) != "#") // ignore empty lines, or lines beginning with "#"
{
card_data = (card_data = []) + card_data + data;
}
++notecard_line;
notecard_request = llGetNotecardLine(NOTECARD_NAME, notecard_line); // ask for the next line
}
}
// update the hover-text with the progress
llSetText("read " + (string)(notecard_line) + " of " + (string)num_notecard_lines + " lines", <1, 1, 1>, 1);
}

state_exit()
{
llSetText("", <0, 0, 0>, 0);
}
}

state error
{
state_entry()
{
llOwnerSay("something went wrong; try checking that the notecard [ " + NOTECARD_NAME + " ] exists and contains data");
}
changed(integer change)
{
if (change & CHANGED_INVENTORY)
{
llResetScript();
}
}
}</Pre>
|helpers
|also_functions={{LSL DefineRow||[[llGetNotecardLine]]|}}
|also_events={{LSL DefineRow||[[dataserver]]|}}
|also_tests
|also_articles
|notes
|permission
|negative_index
|sort=GetNumberOfNotecardLines
|cat1=Notecard
|cat2=Dataserver
|cat3=
|cat4
}}

LlGetListLength

2007-09-27T13:33:16Z

Core Taurog:

{{LSL_Function
|func_id=185|func_sleep=0.0|func_energy=10.0
|func=llGetListLength|return_type=integer|p1_type=list|p1_name=src
|func_footnote
|func_desc
|return_text=that is the number of elements in the list '''src'''.
|spec
|caveats
|constants
|examples=
<Pre>
default
{
state_entry()
{
list l = ["one", "two", "three"];
integer i = llGetListLength(l);
llOwnerSay("there are " + (string)i + " entries in the list";
}
}
</Pre>
|notes=A faster and lighter (in bytecode) way to determine the length of a script is to do a not-equals compare with a null list. This works because the list not-equals compare returns the difference between the lengths.
<pre>
list in;
integer len_in = llGetListLength(in);
integer flen_in = (in != []);
//flen_in and len_in will be the same

integer neg_len_in = -llGetListLength(in);
integer fneg_len_in = ([] != in);
//fneg_len_in and neg_len_in will be the same
</pre>
|helpers
|also_functions=
{{LSL DefineRow||[[llListStatistics]]|[[LIST_STAT_NUM_COUNT]] – Returns the number of [[integer]]s and [[float]]s in the list}}
{{LSL DefineRow||[[llStringLength]]|Returns the number of characters in a string.}}
|also_events
|also_tests
|also_articles
|permission
|location=
'linden\indra\lscript\lscript_library\lscript_alloc.cpp' @ lsa_cmp_lists 
'linden\indra\lscript\lscript_execute\lscript_execute.cpp' @ list_list_operation
|cat1=List
|cat2
|cat3
|cat4
}}

LlGetNumberOfPrims

2007-09-27T13:02:27Z

Core Taurog:

{{LSL_Function
|func_id=275|func_sleep=0.0|func_energy=10.0
|func=llGetNumberOfPrims|sort=GetNumberOfPrims
|return_type=integer
|func_footnote
|func_desc
|return_text=that is the number of prims in a link set the script is attached to.
|spec
|caveats
|constants
|examples=Returns the number of agents on the object
<Pre>
integer GetNumberOfAgents()
{//count avatars
integer a = llGetNumberOfPrims();
integer b = a;
while(llGetAgentSize(llGetLinkKey(a)))
--a;
return b - a;
}
</Pre>
|helpers=<pre>
//Returns the number of agents on the object
integer GetNumberOfAgents()
{//count avatars
integer a = llGetNumberOfPrims();
integer b = a;
while(llGetAgentSize(llGetLinkKey(a)))
--a;
return b - a;
}

//Returns the number of prims in the object
integer GetNumberOfPrims()
{//ignores avatars
integer a = llGetNumberOfPrims();
while(llGetAgentSize(llGetLinkKey(a)))
--a;
return a;
}
</pre>
|also_functions=
{{LSL DefineRow||{{LSLG|llGetObjectPrimCount}}|Returns the number of prims in any object.}}
{{LSL DefineRow||{{LSLG|llGetLinkNumber}}|Returns the link number of the prim the script is in.}}
|also_tests
|also_events
|also_articles
|notes
|cat1=Link
|cat2
|cat3
|cat4
}}

At target

2007-09-27T12:59:40Z

Core Taurog:

{{LSL_Event|event_id=16|event_delay|event=at_target
|p1_type=integer|p1_name=tnum|p1_desc=[[llTarget]] return
|p2_type=vector|p2_name=targetpos|p2_desc=[[llTarget]] position parameter
|p3_type=vector|p3_name=ourpos|p3_desc=current position (similar to [[llGetPos]])
|event_desc=Result of {{LSLG|llTarget}} library function call
|constants
|spec
|caveats
|examples=
<Pre>
integer target_id;
vector target_pos;

default
{
state_entry()
{
target_pos = llGetPos() + <1.0, 0.0, 0.0>;
target_id = llTarget(target_pos, 0.5);
}
at_target(integer tnum, vector targetpos, vector ourpos)
{
if (tnum == target_id)
{
llOwnerSay("object is within range of target");
llOwnerSay("target position: " + (string)targetpos + ", object is now at: " + (string)ourpos);
llOwnerSay("this is " + (string)llVecDist(targetpos, ourpos) + " meters from the target");
llTargetRemove(target_id);
}
}
not_at_target()
{
llOwnerSay(
"not there yet - object is at " + (string)llGetPos() +
", which is " + (string)llVecDist(target_pos, llGetPos()) +
" meters from the target (" + (string)target_pos + ")"
);
}
}
</Pre>
|helpers
|also_header
|also_events={{LSL DefineRow||[[not_at_target]]|}}
{{LSL DefineRow||[[at_rot_target]]|}}
{{LSL DefineRow||[[not_at_rot_target]]|}}
|also_functions={{LSL DefineRow||[[llTarget]]|Setup a target position}}
{{LSL DefineRow||[[llTargetRemove]]|Stop a target position}}
{{LSL DefineRow||[[llRotTarget]]|Setup a target rotation}}
{{LSL DefineRow||[[llRotTargetRemove]]|Stop a target rotation}}
|also_articles
|also_footer
|notes
|mode
|deprecated
|cat1=Target
|cat2
|cat3
|cat4
}}

LlGetScriptName

2007-09-27T12:54:46Z

Core Taurog:

{{LSL_Function
|func_id=167|func_sleep=0.0|func_energy=10.0
|func=llGetScriptName
|func_footnote
|func_desc
|return_type=string
|return_text=that is the script name.
|spec
|caveats
|constants
|examples=Remove the current script from the object
<Pre>
default
{
state_entry()
{
llRemoveInventory(llGetScriptName());
}
}
</Pre>
|helpers
|also_functions
|also_events
|also_tests
|also_articles
|notes
|permission
|negative_index
|sort=GetScriptName
|cat1=Inventory
|cat2=Script
|cat3
|cat4
}}

LlGetStartParameter

2007-09-27T12:54:09Z

Core Taurog:

{{LSL_Function
|func_id=134|func_sleep=0.0|func_energy=10.0
|sort=GetStartParameter
|func=llGetStartParameter|return_type=integer
|func_footnote=
*If the script was loaded with [[llRemoteLoadScriptPin]] then that start parameter is returned.
*If the containing object was rezzed by [[llRezObject]] or [[llRezAtRoot]] then the return is the [[on_rez]] parameter.
|func_desc
|return_text=that is the script start/rez parameter.
|spec
|caveats
|constants
|examples=
<Pre>
default
{
on_rez(integer param)
{
llOwnerSay("rezzed with the number " + (string)param);
}
state_entry()
{
integer i = llGetStartParameter();
if (i == 0)
{
llOwnerSay("rezzed from inventory (or llRezObject with 0)");
}
else
{
llOwnerSay("I was given the number " + (string)i + " when I was rezzed");
}
}
}
</Pre>
|helpers
|also_functions=
{{LSL DefineRow||[[llRemoteLoadScriptPin]]|Used to load a script into a remote prim}}
{{LSL DefineRow||[[llRezObject]]|Used to rez an object at the center of mass}}
{{LSL DefineRow||[[llRezAtRoot]]|Used to rez an object at the root}}
|also_events=
{{LSL DefineRow||[[on_rez]]|}}
|also_articles
|notes
|cat1=Script
|cat2
|cat3
|cat4
}}

LlGetSubString

2007-09-27T12:52:04Z

Core Taurog:

{{LSL_Function/negative index|true|start|end}}{{LSL_Function
|func_id=94|func_sleep=0.0|func_energy=10.0
|func=llGetSubString|return_type=string|p1_type=string|p1_name=src|p2_type=integer|p2_name=start|p3_type=integer|p3_name=end
|func_footnote
|func_desc
|return_text=that is the substring of '''src''' from '''start''' to '''end'''.
|spec
|caveats
|constants
|examples=
<Pre>
default
{
state_entry()
{
string word = "Hello!";
llOwnerSay(llGetSubString(word, 0, 0));
// Object: H
llOwnerSay(llGetSubString(word, -1, -1));
// Object: !
llOwnerSay(llGetSubString(word, 2, 3));
// Object: ll
}
}
</Pre>
|helpers
|also_functions=*{{LSLG|llDeleteSubString}}
*{{LSLG|llInsertString}}
*[[User:Anylyn_Hax#str_replace()|str_replace()]]
|also_events
|also_tests
|also_articles
|notes
|sort=GetSubString
|cat1=String
|cat2
|cat3
|cat4
}}

LlListFindList

2007-09-27T12:49:01Z

Core Taurog:

{{LSL_Function
|func=llListFindList
|sort=ListFindList
|func_id=201|func_sleep=0.0|func_energy=10.0
|return_type=integer|p1_type=list|p1_name=src|p2_type=list|p2_name=test
|func_footnote=If '''test''' is not found in '''src''', {{HoverText|-1|negative one, 0x{{LSL_Hex/Write|-1}}}} is returned. 
The index of the first entry in the list is {{HoverText|0|zero}}
|func_desc
|return_text=that is the index of the first instance of '''test''' in '''src'''.
|spec
|caveats=*Strict type matching is enforced.
|constants
|examples=
<Pre>
list numbers = [1, 2, 3, 4, 5];
default
{
state_entry()
{
integer index = llListFindList(numbers, [3]);
if (index != -1)
{
list three_four = llList2List(numbers, index, index + 1);
llOwnerSay(llDumpList2String(three_four, ","));
// Object: 3,4
}
}
}
</Pre>
|helpers=
An easy way to see if an item exists in a list...
<pre>
if(~llListFindList(myList, (list)item))
{//it exists
//This works because ~(-1) == 0
//It saves bytecode and is faster then doing != -1
}
</pre>
|also_functions=
{{LSL DefineRow||[[llSubStringIndex]]|Find a string in another string}}
|also_events
|also_tests
|also_articles
|notes
|permission
|negative_index
|sort=ListFindList
|cat1=List
|cat2
|cat3
|cat4
}}

LlList2List

2007-09-27T12:48:38Z

Core Taurog:

{{LSL_Function/negative index|true|start|end}}
{{LSL_Function
|func_id=192|func_sleep=0.0|func_energy=10.0
|sort=List2List
|func=llList2List|return_type=list|p1_type=list|p1_name=src|p2_type=integer|p2_name=start|p3_type=integer|p3_name=end
|func_footnote
|func_desc
|return_text=that is a slice of '''src''' from '''start''' to '''end'''.
|spec
|caveats
|constants
|examples=
<Pre>
list numbers = [1, 2, 3, 4, 5];
default
{
state_entry()
{
integer index = llListFindList(numbers, [3]);
if (index != -1)
{
list three_four = llList2List(numbers, index, index + 1);
llOwnerSay(llDumpList2String(three_four, ","));
// Object: 3,4
}
}
}
</Pre>
|helpers
|also_functions
|also_events
|also_articles
|notes
|permission
|cat1=List
|cat2
|cat3
|cat4
}}

LlListInsertList

2007-09-27T12:44:29Z

Core Taurog:

{{#vardefine:spec_between|If '''start''' is past the end of '''dest''', then '''src''' is appended to '''dest''', it will not add null entries. To avoid this, create empty elements in the list first. A similar outcome occurs when using {{LSLGC|Negative Index|negative indexes}}.}}
{{LSL_Function/negative index|true|start}}{{LSL_Function
|func_id=200|func_sleep=0.0|func_energy=10.0
|func=llListInsertList|return_type=list|p1_type=list|p1_name=dest|p2_type=list|p2_name=src|p3_type=integer|p3_name=start
|func_footnote
|func_desc
|return_text=that is '''src''' inserted into '''dest''' at position '''start'''.
|spec
|caveats
|constants
|examples=
<Pre>
list numbers = [3, "three", 2, "two", 1, "one"];
default
{
state_entry()
{
llOwnerSay(llDumpList2String(numbers, ","));
// Object: 3,three,2,two,1,one
integer index = llListFindList(numbers, [2]);
if (index != -1)
{
numbers = llListInsertList(numbers, [2.5, "two and a half"], index);
llOwnerSay(llDumpList2String(numbers, ","));
// Object: 3,three,2.500000,two and a half,2,two,1,one
}
}
}
</Pre>
|helpers
|also_functions={{LSL DefineRow|[[llDeleteSubList]]}}
{{LSL DefineRow|[[llList2List]]}}
{{LSL DefineRow|[[llListReplaceList]]}}
|also_events
|also_tests
|also_articles
|notes
|permission
|sort=ListInsertList
|cat1=List
|cat2
|cat3
|cat4
}}

LlListInsertList

2007-09-27T12:43:27Z

Core Taurog:

{{#vardefine:spec_between|If '''start''' is past the end of '''dest''', then '''src''' is appended to '''dest''', it will not add null entries. To avoid this, create empty elements in the list first. A similar outcome occurs when using {{LSLGC|Negative Index|negative indexes}}.}}
{{LSL_Function/negative index|true|start}}{{LSL_Function
|func_id=200|func_sleep=0.0|func_energy=10.0
|func=llListInsertList|return_type=list|p1_type=list|p1_name=dest|p2_type=list|p2_name=src|p3_type=integer|p3_name=start
|func_footnote
|func_desc
|return_text=that is '''src''' inserted into '''dest''' at position '''start'''.
|spec
|caveats
|constants
|examples=
<Pre>
list numbers = [3, "three", 2, "two", 1, "one"];
default
{
state_entry()
{
llOwnerSay(llDumpList2String(numbers, ","));
// Object: 3,three,2,two,1,one
integer index = llListFindList(numbers, [2]);
numbers = llListInsertList(numbers, [2.5, "two and a half"], index);
llOwnerSay(llDumpList2String(numbers, ","));
// Object: 3,three,2.500000,two and a half,2,two,1,one
}
}
</Pre>
|helpers
|also_functions={{LSL DefineRow|[[llDeleteSubList]]}}
{{LSL DefineRow|[[llList2List]]}}
{{LSL DefineRow|[[llListReplaceList]]}}
|also_events
|also_tests
|also_articles
|notes
|permission
|sort=ListInsertList
|cat1=List
|cat2
|cat3
|cat4
}}

LlListSort

2007-09-27T12:41:14Z

Core Taurog:

{{LSL_Function
|func_id=184|func_sleep=0.0|func_energy=10.0
|func=llListSort|return_type=list
|p1_type=list|p1_name=src|p1_desc=List to be sorted.
|p2_type=integer|p2_name=stride|p2_desc=number of entries per stride, if less then 1 it is assumed to be 1.
|p3_type=integer|p3_name=ascending|p3_desc=if {{LSLG|FALSE}} then the sort order is desending, otherwise the order is assending.
|func_footnote
|func_desc
|return_text=that is '''src''' sorted by '''stride'''.
|spec=A bubble sort is employed to perform the sort. 
The sort order is effected by type. 
Each type is sorted individually and then feathered to have the same order of types.
<pre>llListSort([1, "C", 3, "A", 2, "B"], 1, TRUE) == [1, "A", 2, "B", 3, "C"]
llListSort([1, 3, 2, "C", "A", "B"], 1, TRUE) == [1, 2, 3, "A", "B", "C"]

llListSort([1, "C", 3, "A", 2, "B"], 2, TRUE) == [1, "C", 2, "B", 3, "A"]</pre>
|caveats=A bubble sort is a sorting algorithm with a Big O of N*N. Why Linden Labs did not use a N*log(N) sorting algorithm such as [http://en.wikipedia.org/wiki/Heapsort Heap Sort] or [http://en.wikipedia.org/wiki/Mergesort Merge Sort] is unkown...
|constants
|examples=
<Pre>
list numbers = [3, "three", 2, "two", 1, "one"];
default
{
state_entry()
{
llOwnerSay(llDumpList2String(numbers, ","));
// Object: 3,three,2,two,1,one
numbers = llListSort(numbers, 2, TRUE);
llOwnerSay(llDumpList2String(numbers, ","));
// Object: 1,one,2,two,3,three
}
}
</Pre>
|helpers
|also_functions
|also_events
|also_tests
|also_articles
|notes
|permission
|negative_index
|sort=ListSort
|cat1=List
|cat2
|cat3
|cat4
|location=lsa_bubble_sort(): 'linden\indra\lscript\lscript_alloc.h'
}}

LlList2ListStrided

2007-09-27T12:37:18Z

Core Taurog:

{{LSL_Function/negative index|true|start|end|stride}}{{LSL_Function
|func_id=198|func_sleep=0.0|func_energy=10.0
|func=llList2ListStrided|return_type=list|p1_type=list|p1_name=src|p2_type=integer|p2_name=start|p3_type=integer|p3_name=end|p4_type=integer|p4_name=stride
|func_footnote
|func_desc
|return_text=of all the entries whose index is a multiple of '''stride''' in the range '''start''' to '''end'''.
|spec
|caveats
|constants
|examples=
<Pre>
list menu = ["1", "one", "2", "two", "3", "three"];
default
{
state_entry()
{
llListen(10, "", llGetOwner(), "");
}
touch_start(integer detected)
{
list buttons = llList2ListStrided(menu, 0, -1, 2);
llDialog(llDetectedKey(0), "choose a number", buttons, 10);
}
listen(integer channel, string obj, key id, string message)
{
integer index = llListFindList(menu, [message]);
if (index != -1)
{
llOwnerSay("you chose " + llList2String(menu, index + 1) + " (" + message + ")");
}
}
}
</Pre>
|helpers
|also_functions
|also_events
|also_tests
|also_articles
|notes
|permission
|negative_index
|sort=List2ListStrided
|cat1=List
|cat2
|cat3
|cat4
}}

LlRequestPermissions

2007-09-27T12:29:42Z

Core Taurog:

{{LSL_Function
|func=llRequestPermissions|sort=RequestPermissions
|func_id=136|func_sleep=0.0|func_energy=10.0
|p1_type=key|p1_name=agent|p1_desc=Avatar key
|p2_type=integer|p2_name=perm|p2_desc=Permission mask (bitfield containing the permissions to request).
|func_desc=Ask agent for permission to run certain classes of functions.
|return_text
|spec
|caveats=
*Permissions do not accumulate.
**If a permission was requested with a previous call to this function and granted, then in subsequent call was not requested, that permission is released (lost).
*Scripts may hold permissions for only one agent at a time. To hold permissions for multiple agents you must use more then one script.
|examples=Request permission to animate an avatar
<Pre>
default
{
touch_start(integer detected)
{
llRequestPermissions(llDetectedKey(0), PERMISSION_TRIGGER_ANIMATION);
}
run_time_permissions(integer perm)
{
if (perm & PERMISSION_TRIGGER_ANIMATION)
{
llStartAnimation("sit");
llOwnerSay("animation will end in 5 seconds");
llSetTimerEvent(5.0);
}
}
timer()
{
llSetTimerEvent(0.0);
llStopAnimation("sit");
}
}
</Pre>
|helpers
|also_events={{LSL DefineRow||{{LSLG|run_time_permissions}}|Permission receiver event}}
|also_functions={{LSL DefineRow||{{LSLG|llGetPermissions}}|Get the permissions granted}}
{{LSL DefineRow||{{LSLG|llGetPermissionsKey}}|Get the avatar who granted permissions.}}
|also_articles={{LSL DefineRow||{{LSLGC|Permissions/Script|Script permissions}}|}}
|notes = A dialog is presented to the agent to grant these permissions except for a few cases:
* If agent is sitting on object - Control and Camera tracking permissions are granted without notification upon request.
* If object is attached to agent - Control and Attach permissions are granted without notification upon request.
Regardless if a dialog is displayed you should always use the {{LSLG|run_time_permissions}} event instead of depending upon this quirk.
|constants={{LSL Constants/Permissions}}
|cat1=Permissions/Script
|cat2=Dialog
|cat3
|cat4
|cat5
|cat6
}}

LlRemoveInventory

2007-09-27T12:27:30Z

Core Taurog:

{{LSL_Function/inventory|item|uuid=false|type}}{{LSL_Function
|func_id=151|func_sleep=0.0|func_energy=10.0
|func=llRemoveInventory|p1_type=string|p1_name=item
|func_footnote
|func_desc=Remove the named inventory '''item'''
|return_text
|spec
|caveats
|constants
|examples=Remove the current script from the object
<Pre>
default
{
state_entry()
{
llRemoveInventory(llGetScriptName());
}
}
</Pre>
|helpers
|also_functions
|also_events
|also_tests
|also_articles
|notes
|permission
|negative_index
|sort=RemoveInventory
|cat1=Inventory
|cat2
|cat3
|cat4
}}

LlSetLinkTexture

2007-09-27T12:19:38Z

Core Taurog:

{{LSL Function/inventory|texture|uuid=true|type=texture}}{{LSL Function/face|face}}{{LSL Function/link|linknumber|}}{{LSL_Function
|func_id=329|func_sleep=0.2|func_energy=10.0
|func=llSetLinkTexture
|p1_type=integer|p1_name=linknumber
|p2_type=string|p2_name=texture
|p3_type=integer|p3_name=face
|func_footnote
|func_desc=If a task exists in the link chain at '''linknumber''', set '''texture''' to '''face'''
|return_text
|spec
|sort=SetLinkTexture
|caveats
|constants
|examples=Cover a link set in bark (from the library)
<Pre>
default
{
touch_start(integer detected)
{
llSetLinkTexture(LINK_SET, "66bf4030-04f9-a808-43ab-b48b6aeb6456", ALL_SIDES);
}
}
</Pre>
|helpers
|also_functions=
{{LSL DefineRow||[[llSetLinkAlpha]]|}}
{{LSL DefineRow||[[llSetLinkColor]]|}}
{{LSL DefineRow||[[llSetLinkPrimitiveParams]]|}}
|also_tests
|also_events
|also_articles
|notes
|deprecated
|cat1=Texture
|cat2
|cat3
|cat4
}}

LlSetLinkColor

2007-09-27T12:17:34Z

Core Taurog:

{{LSL Function/color|color}}{{LSL_Function/face|face|}}{{LSL Function/link|linknumber|}}{{LSL_Function
|func_id=140|func_sleep=0.0|func_energy=10.0
|func=llSetLinkColor
|p1_type=integer|p1_name=linknumber
|p2_type=vector|p2_name=color
|p3_type=integer|p3_name=face
|func_footnote
|func_desc=If a task exists in the link chain at '''linknumber''', set '''face''' to '''color'''
|return_text
|spec
|caveats
|constants
|examples=Turn a link set green
<Pre>
default
{
touch_start(integer detected)
{
llSetLinkColor(LINK_SET, <0.0, 1.0, 0.0>, ALL_SIDES);
}
}
</Pre>
|helpers
|also_functions=
{{LSL DefineRow||[[llGetAlpha]]|Gets the prim's alpha}}
{{LSL DefineRow||[[llSetAlpha]]|Sets the prim's alpha}}
{{LSL DefineRow||[[llGetColor]]|Gets the prim's color}}
{{LSL DefineRow||[[llSetColor]]|Sets the prim's color}}
{{LSL DefineRow||[[llSetLinkAlpha]]|}}
{{LSL DefineRow||[[llSetLinkTexture]]|}}
{{LSL DefineRow||[[llSetLinkPrimitiveParams]]|}}
|also_tests
|also_events={{LSL DefineRow||[[changed]]|[[CHANGED_COLOR]]}}
|also_articles
|notes
|deprecated
|cat1
|cat2
|cat3
|cat4
}}

LlSetLinkAlpha

2007-09-27T12:14:51Z

Core Taurog:

{{LSL Function/face|face|}}{{LSL Function/link|linknumber|}}{{LSL_Function/alpha|alpha}}{{LSL_Function
|func_id=274|func_sleep=0.0|func_energy=10.0
|func=llSetLinkAlpha
|p1_type=integer|p1_name=linknumber
|p2_type=float|p2_name=alpha
|p3_type=integer|p3_name=face
|func_footnote
|func_desc=If a prim exists in the link chain at '''linknumber''', set '''face''' to '''alpha'''
|return_text
|spec
|caveats
|constants
|examples=Make the entire object disappear for 5 seconds
<Pre>
default
{
touch_start(integer detected)
{
llSetLinkAlpha(LINK_SET, 0.0, ALL_SIDES);
llSetTimerEvent(5.0);
}
timer()
{
llSetLinkAlpha(LINK_SET, 1.0, ALL_SIDES);
llSetTimerEvent(0.0);
}
}
</Pre>
|helpers
|also_functions=
{{LSL DefineRow||[[llGetAlpha]]|Gets the prim's alpha}}
{{LSL DefineRow||[[llSetAlpha]]|Sets the prim's alpha}}
{{LSL DefineRow||[[llGetColor]]|Gets the prim's color}}
{{LSL DefineRow||[[llSetColor]]|Sets the prim's color}}
{{LSL DefineRow||[[llSetLinkColor]]|}}
{{LSL DefineRow||[[llSetLinkTexture]]|}}
{{LSL DefineRow||[[llSetLinkPrimitiveParams]]|}}
|also_tests
|also_events={{LSL DefineRow||[[changed]]|[[CHANGED_COLOR]]}}
|also_articles
|notes
|deprecated
|cat1
|cat2
|cat3
|cat4
}}

LlSetLinkAlpha

2007-09-27T12:12:15Z

Core Taurog:

{{LSL Function/face|face|}}{{LSL Function/link|linknumber|}}{{LSL_Function/alpha|alpha}}{{LSL_Function
|func_id=274|func_sleep=0.0|func_energy=10.0
|func=llSetLinkAlpha
|p1_type=integer|p1_name=linknumber
|p2_type=float|p2_name=alpha
|p3_type=integer|p3_name=face
|func_footnote
|func_desc=If a prim exists in the link chain at '''linknumber''', set '''face''' to '''alpha'''
|return_text
|spec
|caveats
|constants
|examples=
<Pre>
default
{
touch_start(integer detected)
{
llSetLinkAlpha(LINK_SET, 0.0, ALL_SIDES);
llSetTimerEvent(5.0);
}
timer()
{
llSetLinkAlpha(LINK_SET, 1.0, ALL_SIDES);
llSetTimerEvent(0.0);
}
}
</Pre>
|helpers
|also_functions=
{{LSL DefineRow||[[llGetAlpha]]|Gets the prim's alpha}}
{{LSL DefineRow||[[llSetAlpha]]|Sets the prim's alpha}}
{{LSL DefineRow||[[llGetColor]]|Gets the prim's color}}
{{LSL DefineRow||[[llSetColor]]|Sets the prim's color}}
{{LSL DefineRow||[[llSetLinkColor]]|}}
{{LSL DefineRow||[[llSetLinkTexture]]|}}
{{LSL DefineRow||[[llSetLinkPrimitiveParams]]|}}
|also_tests
|also_events={{LSL DefineRow||[[changed]]|[[CHANGED_COLOR]]}}
|also_articles
|notes
|deprecated
|cat1
|cat2
|cat3
|cat4
}}

LlSetSitText

2007-09-27T12:00:56Z

Core Taurog:

{{LSL_Function
|func_id=242|func_sleep=0.0|func_energy=10.0
|func=llSetSitText|p1_type=string|p1_name=text
|func_footnote='''text''' is limited to 9 characters.
|func_desc=Displays '''text''' rather than sit in pie menu
|return_text
|spec
|caveats
|constants
|examples=
<Pre>
default
{
state_entry()
{
llSetSitText("Sit here");
}
}
</Pre>
|helpers
|also_functions=
{{LSL DefineRow||[[llSitTarget]]|}}
{{LSL DefineRow||[[llSetTouchText]]|}}
|also_events
|also_tests
|also_articles
|notes
|permission
|negative_index
|cat1=Pie Menu
|cat2=Prim
|cat3=Sit
|cat4
}}

LlSetTouchText

2007-09-27T12:00:04Z

Core Taurog:

{{LSL_Function
|func=llSetTouchText
|sort=SetTouchText
|func_id=241|func_sleep=0.0|func_energy=10.0
|p1_type=string|p1_name=text
|func_footnote='''text''' is limited to 9 characters. Changing the text does not effect the behavior.
|func_desc=Displays '''text''' in pie menu rather then Touch
|return_text
|spec
|caveats
|constants
|examples=
<Pre>
default
{
state_entry()
{
llSetTouchText("Touch me!");
}
touch_start(integer detected)
{
llSay(0, "you touched me!");
}
}
</Pre>
|helpers
|also_functions=*{{LSLG|llSetSitText}}
|also_events
|also_tests
|also_articles=*{{LSLGC|Touch}}
|notes
|permission
|negative_index
|sort=SetTouchText
|cat1=Pie Menu
|cat2
|cat3
|cat4
}}

LlStopAnimation

2007-09-27T11:57:43Z

Core Taurog:

{{LSL_Function/permission|PERMISSION_TRIGGER_ANIMATION}}{{LSL_Function/inventory|anim|uuid=true|type=animation}}{{LSL_Function
|func_id=130|func_sleep=0.0|func_energy=10.0
|func=llStopAnimation|sort=StopAnimation
|p1_type=string|p1_name=anim
|func_footnote
|func_desc=Stop animation '''anim''' for agent that granted [[PERMISSION_TRIGGER_ANIMATION]] if the permission has not been revoked.
|return_text
|spec
|caveats
|constants
|examples=
<Pre>
default
{
touch_start(integer detected)
{
llRequestPermissions(llDetectedKey(0), PERMISSION_TRIGGER_ANIMATION);
}
run_time_permissions(integer perm)
{
if (perm & PERMISSION_TRIGGER_ANIMATION)
{
llStartAnimation("sit");
llOwnerSay("animation will end in 5 seconds");
llSetTimerEvent(5.0);
}
}
timer()
{
llSetTimerEvent(0.0);
llStopAnimation("sit");
}
}
</Pre>
|helpers
|also_functions
|also_tests
|also_events
|also_articles
|notes
|inventory
|negative_index
|cat1=Animation
|cat2
|cat3
|cat4
}}

LlStartAnimation

2007-09-27T11:56:43Z

Core Taurog:

{{LSL_Function/permission|PERMISSION_TRIGGER_ANIMATION}}{{LSL_Function/inventory|anim|uuid=false|type}}{{LSL_Function
|func_id=129|func_sleep=0.0|func_energy=10.0
|func=llStartAnimation|sort=StartAnimation
|p1_type=string|p1_name=anim
|func_footnote
|func_desc=Start animation '''anim''' for agent that granted [[PERMISSION_TRIGGER_ANIMATION]] if the permission has not been revoked.
|return_text
|spec
|caveats
|constants
|examples=
<Pre>
default
{
touch_start(integer detected)
{
llRequestPermissions(llDetectedKey(0), PERMISSION_TRIGGER_ANIMATION);
}
run_time_permissions(integer perm)
{
if (perm & PERMISSION_TRIGGER_ANIMATION)
{
llStartAnimation("sit");
llOwnerSay("animation will end in 5 seconds");
llSetTimerEvent(5.0);
}
}
timer()
{
llSetTimerEvent(0.0);
llStopAnimation("sit");
}
}
</Pre>
|helpers
|also_functions={{LSL DefineRow||[[llStopAnimation]]|}}
|also_tests
|also_events
|also_articles={{LSL DefineRow||[[Internal_Animations]]|lists internal Animations always available}}
|notes
|cat1=Animation
|cat2
|cat3
|cat4
}}

State exit

2007-09-27T11:50:04Z

Core Taurog:

{{LSL_Event
|event_id=1|event_delay|event=state_exit
|event_desc=Triggered on any state transition
|constants
|spec
|caveats
|examples=
<Pre>
default
{
state_entry()
{
llOwnerSay("in default state");
}
touch_start(integer detected)
{
state other;
}
state_exit()
{
llOwnerSay("leaving default state");
}
}

state other
{
state_entry()
{
llOwnerSay("in state \"other\"");
}
touch_start(integer detected)
{
state default;
}
state_exit()
{
llOwnerSay("leaving state \"other\"");
}
}</Pre>
|helpers
|also_header
|also_events
|also_functions
|also_articles
|also_footer
|notes
|mode
|deprecated
|cat1=Script
|cat2
|cat3
|cat4
}}

LlTarget

2007-09-27T11:43:51Z

Core Taurog:

{{LSL_Function
|func_id=66|func_sleep=0.0|func_energy=10.0
|func=llTarget|sort=Target
|return_type=integer
|p1_type=vector|p1_name=position
|p2_type=float|p2_name=range
|func_footnote=A similar function exists for rotations: {{LSLG|llRotTarget}} This function does not move the object, to do that use {{LSLG|llSetPos}} or {{LSLG|llMoveToTarget}}.
|func_desc=This function is to have the script know when it has reached a position. It registers a '''position''' with a '''range''' that triggers {{LSLG|at_target}} and {{LSLG|not_at_target}} events continuously until unregistered.
|return_text=that is the handle to unregister the target with {{LSLG|llTargetRemove}}.
|spec
|caveats
|constants
|examples=
<Pre>
integer target_id;
vector target_pos;

default
{
state_entry()
{
target_pos = llGetPos() + <1.0, 0.0, 0.0>;
target_id = llTarget(target_pos, 0.5);
}
at_target(integer tnum, vector targetpos, vector ourpos)
{
if (tnum == target_id)
{
llOwnerSay("object is within range of target");
llOwnerSay("target position: " + (string)targetpos + ", object is now at: " + (string)ourpos);
llOwnerSay("this is " + (string)llVecDist(targetpos, ourpos) + " meters from the target");
llTargetRemove(target_id);
}
}
not_at_target()
{
llOwnerSay(
"not there yet - object is at " + (string)llGetPos() +
", which is " + (string)llVecDist(target_pos, llGetPos()) +
" meters from the target (" + (string)target_pos + ")"
);
}
}
</Pre>
|helpers
|also_functions=
{{LSL DefineRow||[[llTargetRemove]]|Stop a target position}}
{{LSL DefineRow||[[llRotTarget]]|Setup a target rotation}}
{{LSL DefineRow||[[llRotTargetRemove]]|Stop a target rotation}}
|also_tests
|also_events=
{{LSL DefineRow|[[at_target]]|[[not_at_target]]|positional target events}}
{{LSL DefineRow|[[at_rot_target]]|[[not_at_rot_target]]|rotational target events}}
|also_articles
|notes
|cat1=Target
|cat2=Physics
|cat3
|cat4
}}

State entry

2007-09-27T11:43:38Z

Core Taurog:

{{LSL_Event
|event_id=0|event_delay|event=state_entry
|event_desc=Triggered on any state transition and startup
|constants
|spec=
=== Triggered ===
#Script save or adding to object
#State change
#*A [[state_exit]] is triggered in the old state and the [[state_entry]] is triggered in the new state. All other events in the queue are lost as result of the state change.
#On script reset, either by client or [[llResetScript]]/[[llResetOtherScript]]
#When the object is rezzed ''without'' a saved script status
#*If it was a copy taken from inworld
#*If the event had not been triggered due to no-script land.

=== Not Triggered ===
#When the object is rezzed ''with'' saved script status
#*Use [[on_rez]] event in this situation
|caveats
|examples=
<Pre>
default
{
state_entry()
{
llSay(0, "Hello, Avatar!");
}
}
</Pre>
|helpers
|also_header
|also_events={{LSL DefineRow||[[on_rez]]|Triggered when the object is rezzed}}
{{LSL DefineRow||[[state_exit]]|Triggered when the state is exited at state change}}
|also_functions={{LSL DefineRow||[[llResetScript]]|Resets the script}}
{{LSL DefineRow||[[llResetOtherScript]]|Resets another script in the prim}}
{{LSL DefineRow||[[llGetStartParameter]]|The [[on_rez]] parameter (or [[llRemoteLoadScriptPin]] parameter)}}
|also_articles
|also_footer
|notes
|mode
|deprecated
|cat1=Script
|cat2
|cat3
|cat4
}}

LlTargetRemove

2007-09-27T11:42:22Z

Core Taurog:

{{LSL_Function
|func_id=67|func_sleep=0.0|func_energy=10.0
|func=llTargetRemove
|p1_type=integer|p1_name=number
|func_footnote
|func_desc=Removes positional target '''number''' registered with {{LSLG|llTarget}}
|return_text
|spec
|caveats
|constants
|examples=
<Pre>
integer target_id;
vector target_pos;

default
{
state_entry()
{
target_pos = llGetPos() + <1.0, 0.0, 0.0>;
target_id = llTarget(target_pos, 0.5);
}
at_target(integer tnum, vector targetpos, vector ourpos)
{
if (tnum == target_id)
{
llOwnerSay("object is within range of target");
llOwnerSay("target position: " + (string)targetpos + ", object is now at: " + (string)ourpos);
llOwnerSay("this is " + (string)llVecDist(targetpos, ourpos) + " meters from the target");
llTargetRemove(target_id);
}
}
not_at_target()
{
llOwnerSay(
"not there yet - object is at " + (string)llGetPos() +
", which is " + (string)llVecDist(target_pos, llGetPos()) +
" meters from the target (" + (string)target_pos + ")"
);
}
}
</Pre>
|helpers
|also_functions=*{{LSLG|llTarget}}
*{{LSLG|llRotTarget}}
*{{LSLG|llRotTargetRemove}}
|also_tests
|also_events=*{{LSLG|at_target}}
*{{LSLG|not_at_target}}
|also_articles
|notes
|cat1=Target
|cat2=Physics
|cat3
|cat4
}}

Not at target

2007-09-27T11:41:57Z

Core Taurog:

{{LSL_Event
|event_id=17
|event_delay
|event=not_at_target
|event_desc=Triggered if an object has not yet reached the the target set by the call to [[llTarget]].
|event_footnote=This event may be triggered multiple times if the target has not been reached.
|constants
|spec
|caveats
|examples=
<Pre>
integer target_id;
vector target_pos;

default
{
state_entry()
{
target_pos = llGetPos() + <1.0, 0.0, 0.0>;
target_id = llTarget(target_pos, 0.5);
}
at_target(integer tnum, vector targetpos, vector ourpos)
{
if (tnum == target_id)
{
llOwnerSay("object is within range of target");
llOwnerSay("target position: " + (string)targetpos + ", object is now at: " + (string)ourpos);
llOwnerSay("this is " + (string)llVecDist(targetpos, ourpos) + " meters from the target");
llTargetRemove(target_id);
}
}
not_at_target()
{
llOwnerSay(
"not there yet - object is at " + (string)llGetPos() +
", which is " + (string)llVecDist(target_pos, llGetPos()) +
" meters from the target (" + (string)target_pos + ")"
);
}
}
</Pre>
|helpers
|also_header
|also_events={{LSL DefineRow||[[at_target]]|}}
{{LSL DefineRow||[[at_rot_target]]|}}
{{LSL DefineRow||[[not_at_rot_target]]|}}
|also_functions={{LSL DefineRow||[[llTarget]]|Setup a target position}}
{{LSL DefineRow||[[llTargetRemove]]|Stop a target position}}
{{LSL DefineRow||[[llRotTarget]]|Setup a target rotation}}
{{LSL DefineRow||[[llRotTargetRemove]]|Stop a target rotation}}
|also_articles
|also_footer
|notes
|mode
|deprecated
|cat1=Target
|cat2
|cat3
|cat4
}}

LlToLower

2007-09-27T11:24:10Z

Core Taurog:

{{LSL_Function
|func_id=98|func_sleep=0.0|func_energy=10.0
|func=llToLower
|return_type=string|p1_type=string|p1_name=src
|func_footnote
|func_desc
|return_text=that is '''src''' with all lower-case letters
|spec
|caveats
|constants
|examples=<pre>
string msg = "I like CANDY!";
string p = llToLower(msg);
llOwnerSay(p);//Will say "i like candy!"
</pre>
|helpers
|also_functions={{LSL DefineRow||[[llToUpper]]}}
|also_tests
|also_events
|also_articles
|notes
|cat1=String
|cat2
|cat3
|cat4
}}

LlToUpper

2007-09-27T11:23:47Z

Core Taurog:

{{LSL_Function
|func_id=97|func_sleep=0.0|func_energy=10.0
|func=llToUpper
|return_type=string|p1_type=string|p1_name=src
|func_footnote
|func_desc
|return_text=that is '''src''' with all upper-case characters.
|spec
|caveats
|constants
|examples=<pre>
string msg = "I like candy!";
string p = llToUpper(msg);
llOwnerSay(p);//Will say "I LIKE CANDY!"
</pre>
|helpers
|also_functions={{LSL DefineRow||[[llToLower]]}}
|also_tests
|also_events
|also_articles
|notes=This may only work on characters in the ASCII7 range.
|cat1=String
|cat2
|cat3
|cat4
}}

Touch end

2007-09-27T11:23:26Z

Core Taurog:

{{LSL_Event|event_id=4|event_delay|event=touch_end
|p1_type=integer|p1_name=num_detected|p1_desc
|event_desc=Triggered when agent stops clicking on task
|constants
|spec
|caveats
|examples=You can use numbers 0 through num_detected - 1 to get detected agent keys:
<pre>
float t;

default
{
touch_start(integer num_detected)
{
t = llGetTime();
}
touch_end(integer num_detected)
{
llOwnerSay((string)(llGetTime() - t) + " seconds between touch_start and touch_end");
}
}
</pre>
|helpers
|also_header
|also_events=
{{LSL DefineRow||[[touch_start]]|}}
{{LSL DefineRow||[[touch]]|}}
|also_functions=
{{LSL DefineRow||[[llPassTouches]]|}}
|also_articles
|also_footer
|notes
|mode
|deprecated
|cat1=Touch
|cat2=Detected
|cat3
|cat4}}