LlGetUnixTime

2011-08-29T11:47:22Z

Kaluura Boa: To undo the corrections on the helper functions examples

{{Issues/SVC-6357}}{{LSL_Function
|func_id=316|func_sleep=0.0|func_energy=10.0
|sort=GetUnixTime|func=llGetUnixTime|return_type=integer
|func_footnote
|func_desc
|return_text=that is the number of seconds elapsed since 00:00 hours, Jan 1, 1970 {{Wikipedia|Coordinated_Universal_Time|UTC}} from the system clock.
|spec
|caveats=*{{Wikipedia|Year_2038_problem}}
|constants
|examples=<lsl>
// Reset tracker
integer BOOT_TIME;
default
{
state_entry()
{
BOOT_TIME = llGetUnixTime();
llSetTimerEvent(0.1);
}

timer()
{
llSetText((string)(llGetUnixTime() - BOOT_TIME) + " Seconds since boot.\n\n ", <1,0,0>, 1.0);
llSetTimerEvent(1);
}
}
</lsl>
|helpers=
=== Helper Functions ===
* [[Unix2StampLst]] - Converts Unix Time stamp to a list. ex: 1234567890 to [2009, 2, 13, 23, 31, 30]
* [[Stamp2UnixInt]] - Converts date to Unix Time stamp. ex: [2009, 2, 13, 23, 31, 30] to 1234567890
* [[Unix2WeekdayStr]] - Gets the weekday from a Unix Time stamp. ex: "Friday" from 1234567890
|also_functions=
{{LSL DefineRow||[[llGetTimestamp]]|Human Readable UTC Date and time}}
{{LSL DefineRow||[[llGetDate]]|Human Readable UTC Date}}
{{LSL DefineRow||[[llGetTime]]|Elapsed script-time.}}
|also_events
|also_tests={{LSL DefineRow||[[llGetUnixTime/test|llGetUnixTime Conformance Test]]|}}
|also_articles
|notes
|permission
|negative_index
|cat1=Time
|cat2
|cat3
|cat4
}}

LlGetUnixTime

2011-08-29T11:15:21Z

Kaluura Boa: Correction of the examples of the helper functions

{{Issues/SVC-6357}}{{LSL_Function
|func_id=316|func_sleep=0.0|func_energy=10.0
|sort=GetUnixTime|func=llGetUnixTime|return_type=integer
|func_footnote
|func_desc
|return_text=that is the number of seconds elapsed since 00:00 hours, Jan 1, 1970 {{Wikipedia|Coordinated_Universal_Time|UTC}} from the system clock.
|spec
|caveats=*{{Wikipedia|Year_2038_problem}}
|constants
|examples=<lsl>
// Reset tracker
integer BOOT_TIME;
default
{
state_entry()
{
BOOT_TIME = llGetUnixTime();
llSetTimerEvent(0.1);
}

timer()
{
llSetText((string)(llGetUnixTime() - BOOT_TIME) + " Seconds since boot.\n\n ", <1,0,0>, 1.0);
llSetTimerEvent(1);
}
}
</lsl>
|helpers=
=== Helper Functions ===
* [[Unix2StampLst]] - Converts Unix Time stamp to a list. ex: 1234567890 to [2009, 2, 14, 0, 31, 30]
* [[Stamp2UnixInt]] - Converts date to Unix Time stamp. ex: [2009, 2, 14, 0, 31, 30] to 1234567890
* [[Unix2WeekdayStr]] - Gets the weekday from a Unix Time stamp. ex: "Saturday" from 1234567890
|also_functions=
{{LSL DefineRow||[[llGetTimestamp]]|Human Readable UTC Date and time}}
{{LSL DefineRow||[[llGetDate]]|Human Readable UTC Date}}
{{LSL DefineRow||[[llGetTime]]|Elapsed script-time.}}
|also_events
|also_tests={{LSL DefineRow||[[llGetUnixTime/test|llGetUnixTime Conformance Test]]|}}
|also_articles
|notes
|permission
|negative_index
|cat1=Time
|cat2
|cat3
|cat4
}}

LlGetUnixTime

2011-08-29T11:08:22Z

Kaluura Boa: Added: Helper function Stamp2UnixInt

{{Issues/SVC-6357}}{{LSL_Function
|func_id=316|func_sleep=0.0|func_energy=10.0
|sort=GetUnixTime|func=llGetUnixTime|return_type=integer
|func_footnote
|func_desc
|return_text=that is the number of seconds elapsed since 00:00 hours, Jan 1, 1970 {{Wikipedia|Coordinated_Universal_Time|UTC}} from the system clock.
|spec
|caveats=*{{Wikipedia|Year_2038_problem}}
|constants
|examples=<lsl>
// Reset tracker
integer BOOT_TIME;
default
{
state_entry()
{
BOOT_TIME = llGetUnixTime();
llSetTimerEvent(0.1);
}

timer()
{
llSetText((string)(llGetUnixTime() - BOOT_TIME) + " Seconds since boot.\n\n ", <1,0,0>, 1.0);
llSetTimerEvent(1);
}
}
</lsl>
|helpers=
=== Helper Functions ===
* [[Unix2StampLst]] - Converts Unix Time stamp to a list. ex: 1234567890 to [2009, 2, 14, 0, 31, 30]
* [[Stamp2UnixInt]] - Converts date to Unix Time stamp. ex: [2009, 2, 14, 0, 31, 30] to 1234567890
* [[Unix2WeekdayStr]] - Gets the weekday from a Unix Time stamp. ex: "Friday" from 1234567890
|also_functions=
{{LSL DefineRow||[[llGetTimestamp]]|Human Readable UTC Date and time}}
{{LSL DefineRow||[[llGetDate]]|Human Readable UTC Date}}
{{LSL DefineRow||[[llGetTime]]|Elapsed script-time.}}
|also_events
|also_tests={{LSL DefineRow||[[llGetUnixTime/test|llGetUnixTime Conformance Test]]|}}
|also_articles
|notes
|permission
|negative_index
|cat1=Time
|cat2
|cat3
|cat4
}}

LlGetObjectPrimCount

2011-08-04T07:53:21Z

Kaluura Boa:

{{LSL_Function
|inject-1={{LSL_Function/prim|prim|sim=*|}}
|func_id=323|func_sleep=0.0|func_energy=10.0
|func=llGetObjectPrimCount
|return_type=integer
|p1_type=key|p1_name=prim|p1_desc
|func_footnote=Avatars sitting on the object are not counted{{Footnote|[[llGetNumberOfPrims]] on the other hand does count avatars sitting on the object.|llGetNumberOfPrims on the other hand does count avatars sitting on the object.}}. Zero is returned if '''prim''' {{HoverText|(1)|is not found}} is not found, {{HoverText|(2)|is part of an attachment}} is part of an attachment{{Footnote|Weather the attachment exception is a bug or a feature is unclear.|handle=attachment}}, or {{HoverText|(3)|is not a prim}} is not a prim.
|func_desc
|return_text=that is the total number of prims in the object that contains '''prim'''.
|spec
|caveats=
* This cannot be used to detect if an avatar is seated (by checking for a non-zero return), use [[llGetAgentInfo]] instead.
* The prim count for attachments are not returned{{Footnote|handle=attachment}}. If possible use [[llGetNumberOfPrims]] instead.
|constants
|examples=
<lsl>default
{
touch_start(integer num)
{
integer prims = llGetObjectPrimCount(llGetKey());
if (prims == 0)
{
// llGetObjectPrimCount returns zero for attachments.
prims = llGetNumberOfPrims();
// Avatars can't sit on attachments so this is ok.
}
llOwnerSay("This object has "
+ (string)prims
+ " prims and "
+ (string)(llGetNumberOfPrims() - prims)
+ " avatars.");
}
}</lsl>
|helpers
|also_functions=
{{LSL DefineRow||[[llGetNumberOfPrims]]|Returns the number of prims in the current object.}}
|also_tests
|also_events
|also_articles
|notes
|cat1=Object
|cat2
|cat3
|cat4
}}

LlGetObjectPrimCount

2011-08-04T07:52:43Z

Kaluura Boa:

{{LSL_Function
|inject-1={{LSL_Function/prim|prim|sim=*|}}
|func_id=323|func_sleep=0.0|func_energy=10.0
|func=llGetObjectPrimCount
|return_type=integer
|p1_type=key|p1_name=prim|p1_desc
|func_footnote=Avatars sitting on the object are not counted{{Footnote|[[llGetNumberOfPrims]] on the other hand does count avatars sitting on the object.|llGetNumberOfPrims on the other hand does count avatars sitting on the object.}}. Zero is returned if '''prim''' {{HoverText|(1)|is not found}} is not found, {{HoverText|(2)|is part of an attachment}} is part of an attachment{{Footnote|Weather the attachment exception is a bug or a feature is unclear.|handle=attachment}}, or {{HoverText|(3)|is not a prim}} is not a prim.
|func_desc
|return_text=that is the total number of prims in the object that contains '''prim'''.
|spec
|caveats=
* This cannot be used to detect if an avatar is seated (by checking for a non-zero return), use [[llGetAgentInfo]] instead.
* The prim count for attachments are not returned{{Footnote|handle=attachment}}. If possible use [[llGetNumberOfPrims]] instead.
|constants
|examples=
<<lsl>default
{
touch_start(integer num)
{
integer prims = llGetObjectPrimCount(llGetKey());
if (prims == 0)
{
// llGetObjectPrimCount returns zero for attachments.
prims = llGetNumberOfPrims();
// Avatars can't sit on attachments so this is ok.
}
llOwnerSay("This object has "
+ (string)prims
+ " prims and "
+ (string)(llGetNumberOfPrims() - prims)
+ " avatars.");
}
}</lsl>
|helpers
|also_functions=
{{LSL DefineRow||[[llGetNumberOfPrims]]|Returns the number of prims in the current object.}}
|also_tests
|also_events
|also_articles
|notes
|cat1=Object
|cat2
|cat3
|cat4
}}

LlGetNumberOfPrims

2011-08-04T07:45:06Z

Kaluura Boa: Lazy bracing fixed

{{LSL_Function
|func_id=275|func_sleep=0.0|func_energy=10.0
|func=llGetNumberOfPrims
|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=*The number of prims returned also includes the number of avatars sitting on the object.
|constants
|examples=<lsl>default
{
state_entry()
{
llOwnerSay((string)llGetLinkNumber());
llOwnerSay((string)llGetNumberOfPrims());
}
}</lsl>
|helpers=<lsl>
// Returns the number of prims in the object, ignoring sitted avatars
integer GetNumberOfPrims()
{
if (llGetAttached())
{
// llGetObjectPrimCount fails on attachments, but you can't sit on an attachment
return llGetNumberOfPrims();
}
return llGetObjectPrimCount(llGetKey());
}

// Returns the number of agents on the object
integer GetNumberOfAgents()
{
return llGetNumberOfPrims() - GetNumberOfPrims();
}</lsl>
|also_functions=
{{LSL DefineRow||[[llGetObjectPrimCount]]|Returns the number of prims in any object.}}
{{LSL DefineRow||[[llGetLinkNumber]]|Returns the link number of the prim the script is in.}}
|also_tests
|also_events
|also_articles
|notes
|cat1=Link
|cat2
|cat3
|cat4
}}

LlAvatarOnSitTarget

2011-08-04T07:32:19Z

Kaluura Boa: Double-checked, triple-checked!

{{LSL_Function|func_id=239|func_sleep=0.0|func_energy=10.0
|func=llAvatarOnSitTarget
|return_type=key
|return_text=that is the [[UUID]] of the user seated on the prim.
|func_footnote=If the prim lacks a [[llSitTarget|sit target]] or there is no avatar sitting on the prim, then {{LSL Const|NULL_KEY|key|"00000000-0000-0000-0000-000000000000"|c=Evaluates to false in conditionals just like invalid keys.}} is returned.
|caveats=*A prim does not have a sit target unless [[llSitTarget]] has been called with a '''nonzero''' vector as the first argument.
*If the prim lacks a sit target or the avatar is seated upon a different prim, the only way to determine how many and which avatars are seated upon the object is to scan the link set (for an example of this, see [[llGetNumberOfPrims#Useful_Snippets|llGetNumberOfPrims]]).
|spec
|examples=<lsl>default
{
state_entry()
{
// set sit target, otherwise this will not work
llSitTarget(<0.0, 0.0, 0.1>, ZERO_ROTATION);
}

changed(integer change)
{
if (change & CHANGED_LINK)
{
key av = llAvatarOnSitTarget();
if (av) // evaluated as true if key is valid and not NULL_KEY
{
llSay(0, "Hello " + llKey2Name(av) + ", thank you for sitting down");
}
}
}
}</lsl>
|helpers=<lsl>//Gets the link number of a seated avatar
integer GetAgentLinkNumber(key avatar)
{
integer link_num = llGetNumberOfPrims();
while (link_num > 1) // Check only child prims.
{
if (llGetLinkKey(link_num) == avatar) // If it is the avatar we want
{
return link_num; // then return the link number
}
--link_num; // else go on with next child.
}
// Avatar wasn't found
return FALSE; // 0 (zero) for easy testing.
}</lsl>
|related
|also_tests
|also_events={{LSL DefineRow||[[changed]]|}}
|also_functions={{LSL DefineRow||[[llSitTarget]]|}}
{{LSL DefineRow||[[llGetLinkKey]]}}
|also_articles={{LSL DefineRow||[[CHANGED_LINK]]|}}
|notes=The position of an avatar on a sit target can be determined with the use of [[llGetObjectDetails]] (see [[llSitTarget#Useful_Snippets|llSitTarget]] for an example).
|cat1=Avatar
|cat2=Prim
|cat3=Sit
|cat4
}}

LlAvatarOnSitTarget

2011-08-04T07:29:32Z

Kaluura Boa: Grumble, tabs, grumble, whitespaces, grumble...

2008-08-03T05:50:06Z

Kaluura Boa:

{{Multi-lang}}
{{LSL Header}}
__NOTOC__
NOTE: Please also add your feature requests to the [http://jira.secondlife.com/ JIRA] and create crosslinks between the wiki and the JIRA for voting, and assignment to projects.

==A==
[[llAddToEstateBanList]]

[[llAddCameraView]]

==C==
llDetectedDrop?

event: Dropped

(To prevent spamming of objects with llAllowInvenoryDrop)
[[CHANGED_ALLOWED_DROP]]

[[llChangeLandPassPrice]]

[[llChildPrims2List]]

==D==
{{LSLG|llDetectedFace}}

==E==
{{LSLG|llExecuteMenuCommand}}

==F==
{{LSLG|llForeach}}

{{LSLG|llFrandom}}

==G==
{{LSLG|llGetAgentHealth}}

{{LSLG|llGetAgentPreferedLanguage}}

{{LSLG|llGetAvatarKeysOnEstate}}

{{LSLG|llGetAvatarKeysOnParcel}}

{{LSLG|llGetCreatorKey}}

{{LSLG|llGetEstateBanList}}

{{LSLG|llGetGender}}

{{LSLG|llGetGroup}}

{{LSLG|llGetGroupTitle}}

{{LSLG|llGetInventoryDesc}}

{{LSLG|llGetLinkPrimitiveParams}}

{{LSLG|llGetMyAccountBalance}}

{{LSLG|llGetNotecard}}

{{LSLG|llGetParcelBanList}}

{{LSLG|llGetParcelPopulation}}

{{LSLG|llGetPowerThirst}}

{{LSLG|llGetPrice}}

<s>llGetScriptCreatorKey</s> - use [[llGetInventoryCreator]]([[llGetScriptName]]()) instead

{{LSLG|llGetWorldPopulation}}

==I==
{{LSLG|llInstantMessageGroup}}

{{LSLG|llInviteToGroup}}

{{LSLG|llIsValidIntegerString}}

{{LSLG|llIsValidFloatString}}

{{LSLG|llIsValidVectorString}}

{{LSLG|llIsValidRotationString}}

==L==
{{LSLG|llLBETMB}}

==M==
{{LSLG|llMapTouch}}

==N==
{{LSLG|llName2Key}}

==O==
{{LSLG|llOnRegionReset}}

{{LSLG|OverParcel}}

{{LSLG|on_error}}

==P==
{{LSLG|llPizza}}

{{LSLG|llPosition_change}}

==R==
{{LSLG|llRaiseError}}

{{LSLG|llRemoveFromEstateBanList}}

{{LSLG|llRequestClientData}}

{{LSLG|llReturnObject}}

{{LSLG|llReturnOwnersObjects}}

{{LSLG|llRotateAgent}}

{{LSLG|llRequestPermissions(llGetOwner(), PERMISSION_REFUND);}}

==S==
{{LSLG|llSameGroupOfficer}}

{{LSLG|llSameGroupOwner}}

{{LSLG|llSetLinkMotorParam}}

{{LSLG|llSetLinkText}}

{{LSLG|llSetCOG}}

{{LSLG|llSetNotecard}}

{{LSLG|llSetParcelDetails}}

{{LSLG|llSetParcelFlags}}

{{LSLG|llSoundex}}

{{LSLG|llSpeakText}}

{{LSLG|llSpeech2Text}}

{{LSLG|llSpeech2TextRemove}}

{{LSLG|llStringUTF16ToUTF8}}

{{LSLG|llSayWithinRange}}

{{LSLG|llSetSunDirection}}

{{LSLG|llSetWaterMark}}

{{LSLG|llSetCloudLevel}}

{{LSLG|llSetTouch}}

{{LSLG|stopwatch(float precision_time)}}

{{LSLG|llSayTo}}

==T==
{{LSLG|llTargetOffsetOmega}}

{{LSLG|llTeleportAgent}}

{{LSLG|llTriggerLandmark}}

{{LSLG|llTrackTouches}}

{{LSLG|llTreeSystem}}

==W==
{{LSLG|llWriteToNotecard}}

==Other functionality==
{{LSLG|Block comments}}

{{LSLG|True tab-stops}}

{{LSLG|Code Folding}}

{{LSLG|Windowed Scripting}}

{{LSLG|Switch Statement}}

{{LSLG|Array}}

{{LSLG|on_unrez|Event: Unrez / Delete}}

{{LSLG|Conditionals}}

{{LSLG|State variables}}

{{LSLG|Object Orientation aka OOP or OO}}

{{LSLG|Various C++ aspects should be implemented in LSL, Classes, Switch Statements, pointers, etc.}}

{{LSLG|Receive instant messages}}

{{LSLG|money transfer denied for stale Event}}

{{LSLG|Nestable lists}}

{{LSLG|Nesting of Child Prims in a Parent}}

LlSameGroupOfficer

2008-07-18T05:44:33Z

Kaluura Boa: Correction of an error in the script

{{LSL Function
|func=llSameGroupOfficer
|sort=SameGroupOfficer
|func_id|mode=request|func_sleep=0.0|func_energy=10.0
|return_type=integer
|p1_type=key
|p1_name=agent
|p1_desc=must be in the same sim and must carry the appropriate group tag
|func_desc
|func_footnote=Also returns [[TRUE]] if the object is deeded to the group in which '''agent''' is an officer
|return_text=boolean, that is [[TRUE]] if '''agent''' is officer in the same group than the object, otherwise [[FALSE]]
|spec
|caveats
|constants
|examples=<lsl>// Gives inventory object only to officers of the same group than the object
default
{
touch_start(integer number)
{
--number;
for (; number >= 0; --number)
{
key avatar = llDetectedKey(number);

if (llSameGroupOfficer(avatar))
{
llGiveInventory(avatar, llGetInventoryName(INVENTORY_OBJECT, 0));
}
else
{
llSay(0, "You are not an officer of my group!"
}
}
}
}</lsl>
|helpers
|also_functions={{LSL DefineRow||[[llDetectedGroup]]|Used in conjunction with {{LSLGC|Detected|detection}} events}}
{{LSL DefineRow||[[llSameGroup]]}}
{{LSL DefineRow||[[llSameGroupOwner]]}}
|also_tests
|also_events
|also_articles
|notes
}}

LlSameGroupOwner

2008-07-18T05:43:28Z

Kaluura Boa: Correction of an error in the script

{{LSL Function
|func=llSameGroupOwner
|sort=SameGroupOwner
|func_id|mode=request|func_sleep=0.0|func_energy=10.0
|return_type=integer
|p1_type=key
|p1_name=agent
|p1_desc=must be in the same sim and must carry the appropriate group tag
|func_desc
|func_footnote=Also returns [[TRUE]] if the object is deeded to the group of which '''agent''' is an owner
|return_text=boolean, that is [[TRUE]] if '''agent''' is owner of the same group than the object, otherwise [[FALSE]]
|spec
|caveats
|constants
|examples=<lsl>// Gives inventory object only to owners of the same group than the object
default
{
touch_start(integer number)
{
--number;
for (; number >= 0; --number)
{
key avatar = llDetectedKey(number);

if (llSameGroupOwner(avatar))
{
llGiveInventory(avatar, llGetInventoryName(INVENTORY_OBJECT, 0));
}
else
{
llSay(0, "You are not an owner of my group!"
}
}
}
}</lsl>
|helpers
|also_functions={{LSL DefineRow||[[llDetectedGroup]]|Used in conjunction with {{LSLGC|Detected|detection}} events}}
{{LSL DefineRow||[[llSameGroup]]}}
{{LSL DefineRow||[[llSameGroupOfficer]]}}
|also_tests
|also_events
|also_articles
|notes
}}