OSSL vs LSL

From OpenSimulator

(Difference between revisions)
Jump to: navigation, search
m (minor cleanup)
m (Removed addressing modes. This is confusing and is covered in a separate page.)
 
Line 3: Line 3:
 
OSSL implements features not available in LSL (NPCs, Texture Drawing) or extend them, like adressing prims by key, which gives unprecedented flexibility to the scripter.  
 
OSSL implements features not available in LSL (NPCs, Texture Drawing) or extend them, like adressing prims by key, which gives unprecedented flexibility to the scripter.  
  
−
This page tries to highlight the differences between OSSL and LSL functions when similar versions exist. Functions are tagged with adressing modes :
+
This page tries to highlight the differences between OSSL and LSL functions when similar versions exist.  
−
 
+
−
'''H''' : Target is the script's host (the prim containing the script)<br/>
+
−
'''L''' : Target is a prim in the linkset, adressed by link number<br/>
+
−
'''K''' : Target is any prim you own, adressed by key (inside or outside linkset)<br/>
+
−
'''A''' : Target is an avatar<br/>
+
−
 
+
−
When a function is tagged with multiple adressing modes, these are overloads (a.k.a. 'variants') selected at compile time according to the parameter types.
+
−
+
  
 
{| class="wikitable" style="margin:auto"
 
{| class="wikitable" style="margin:auto"
−
| llGetLinkPrimitiveParams || [[osGetLinkPrimitiveParams]] || L || Allows for multiple-link constants LINK_SET, LINK_ALL_CHILDREN. Returns a by-side list of properties.
+
| llGetLinkPrimitiveParams || [[osGetLinkPrimitiveParams]] || Allows for multiple-link constants LINK_SET, LINK_ALL_CHILDREN. Returns a by-side list of properties.
 
|-
 
|-
−
| llSetLinkPrimitiveParams ||  || L || No need for OSSL version since llSetLinkPrimitiveParams accepts all LINK_* flags
+
| llSetLinkPrimitiveParams ||  || No need for OSSL version since llSetLinkPrimitiveParams accepts all LINK_* flags
 
|-
 
|-
−
| llGetPrimitiveParams<br/>llSetPrimitiveParams || [[osGetPrimitiveParams]]<br/>[[osSetPrimitiveParams]] || K || Acts on out-of-linkset primitive (uuid instead of linknumber)
+
| llGetPrimitiveParams<br/>llSetPrimitiveParams || [[osGetPrimitiveParams]]<br/>[[osSetPrimitiveParams]] || Acts on out-of-linkset primitive (uuid instead of linknumber)
 
|-
 
|-
−
|| || [[osSetProjectionParams]] || H L K || Same effect can be obtained with llSetLinkPrimitiveParams (linknum, [PRIM_PROJECTOR]) but OSSL version has osSetPrimitiveParams power to work outside linkset.
+
|| || [[osSetProjectionParams]] || Same effect can be obtained with llSetLinkPrimitiveParams (linknum, [PRIM_PROJECTOR]) but OSSL version has osSetPrimitiveParams power to work outside linkset.
 
|-
 
|-
−
| llCreateLink<br\>llBreakLink<br\>llBreakAllLinks || [[osForceCreateLink]]<br/>[[osForceBreakLink]]<br\>[[osForceBreakAllLinks]] || || Does not require PERMISSION_CHANGE_LINKS
+
| llCreateLink<br\>llBreakLink<br\>llBreakAllLinks || [[osForceCreateLink]]<br/>[[osForceBreakLink]]<br\>[[osForceBreakAllLinks]] || Does not require PERMISSION_CHANGE_LINKS
 
|-
 
|-
−
| llParticleSystem<br/>llLinkParticleSystem || [[osParticleSystem]]<br/>[[osLinkParticleSystem]] || H<br/>L ||  
+
| llParticleSystem<br/>llLinkParticleSystem || [[osParticleSystem]]<br/>[[osLinkParticleSystem]] ||  
 
|-
 
|-
−
| llSitTarget<br/>llLinkSitTarget || [[osSetStandTarget]]<br/>[[osSetLinkStandTarget]] || H<br/>L || SitTarget is position when sitting.<br/>StandTarget, position when unsitting.
+
| llSitTarget<br/>llLinkSitTarget || [[osSetStandTarget]]<br/>[[osSetLinkStandTarget]] || SitTarget is position when sitting.<br/>StandTarget, position when unsitting.
 
|-
 
|-
−
| llAvatarOnSitTarget<br/>llAvatarOnLinkSitTarget || [[osGetSittingAvatarsCount]]()<br/>[[osGetSittingAvatarsCount]](uuid) || H K || OSSL function returns the total number of avatars sitting on a linkset. LSL functions apply only to avatars on sittarget (return NULL_KEY if sittarget is not set) and cannot operate outside the linkset. A similar result can be obtained with llGetObjectDetails(uuid, [OBJECT_SIT_COUNT]).
+
| llAvatarOnSitTarget<br/>llAvatarOnLinkSitTarget || [[osGetSittingAvatarsCount]]()<br/>[[osGetSittingAvatarsCount]](uuid) || OSSL function returns the total number of avatars sitting on a linkset. LSL functions apply only to avatars on sittarget (return NULL_KEY if sittarget is not set) and cannot operate outside the linkset. A similar result can be obtained with llGetObjectDetails(uuid, [OBJECT_SIT_COUNT]).
 
|-
 
|-
−
| llPlaySound<br/>llLoopSound<br/>llTriggerSound<br/>... || [[osPlaySound]]<br\>[[osLoopSound]]<br\>[[osTriggerSound]]<br/>... || L || All OSSL sound functions takes a linknumber argument.
+
| llPlaySound<br/>llLoopSound<br/>llTriggerSound<br/>... || [[osPlaySound]]<br\>[[osLoopSound]]<br\>[[osTriggerSound]]<br/>... || All OSSL sound functions takes a linknumber argument.
 
|-
 
|-
−
| llLinkPlaySound || || L || Universal link sound function (SOUND_PLAY, SOUND_LOOP, SOUND_TRIGGER, SOUND_SYNC). Equivalent to resp. osPlaySound, osLoopSound, osTriggerSound, osPlaySoundSlave, osLoopSoundSlave.
+
| llLinkPlaySound || || Universal link sound function (SOUND_PLAY, SOUND_LOOP, SOUND_TRIGGER, SOUND_SYNC). Equivalent to resp. osPlaySound, osLoopSound, osTriggerSound, osPlaySoundSlave, osLoopSoundSlave.
 
|-
 
|-
−
| llGetNumberOfPrims<br/>llGetObjectPrimCount || [[osGetPrimCount]]()<br/>[[osGetPrimCount]](uuid) || H K || OSSL version does not count sitting avatars and does work on attachments
+
| llGetNumberOfPrims<br/>llGetObjectPrimCount || [[osGetPrimCount]]()<br/>[[osGetPrimCount]](uuid) || OSSL version does not count sitting avatars and does work on attachments
 
|-
 
|-
−
| llStartAnimation<br/>llStopAnimation ||[[osAvatarPlayAnimation]]<br/>[[osAvatarStopAnimation]] || A || Does not require PERMISSION_TRIGGER_ANIMATION<br/>OSSL can animate multiples avatars, when LSL is bound to the avatar having granted the permission.
+
| llStartAnimation<br/>llStopAnimation ||[[osAvatarPlayAnimation]]<br/>[[osAvatarStopAnimation]] || Does not require PERMISSION_TRIGGER_ANIMATION<br/>OSSL can animate multiples avatars, when LSL is bound to the avatar having granted the permission.
 
|-
 
|-
−
| llAttachToAvatar<br/> llDetachFromAvatar || [[osForceAttachToAvatar]]<br/>[[osForceDetachFromAvatar]] || A || Does not require PERMISSION_ATTACH.<br/>Target avatar is implicit. To attach explicitely to a given avatar, use osForceAttachToOtherAvatarFromInventory on the avatar's key.
+
| llAttachToAvatar<br/> llDetachFromAvatar || [[osForceAttachToAvatar]]<br/>[[osForceDetachFromAvatar]] || Does not require PERMISSION_ATTACH.<br/>Target avatar is implicit. To attach explicitely to a given avatar, use osForceAttachToOtherAvatarFromInventory on the avatar's key.
 
|-
 
|-
−
| llGetAgentList || [[osGetAgents]]<br/>[[osGetAvatarList]]<br/>[[OsGetNpcList|osGetNPCList]] || || llGetAgentList returns a list of agent keys.<br/> osGetAgents, a list of agent names.<br/>osGetAvatarList, a strided list of agent (key, position, name).<br/>osGetNPCList : same as osGetAvatarList, but only NPCs.
+
| llGetAgentList || [[osGetAgents]]<br/>[[osGetAvatarList]]<br/>[[OsGetNpcList|osGetNPCList]] || llGetAgentList returns a list of agent keys.<br/> osGetAgents, a list of agent names.<br/>osGetAvatarList, a strided list of agent (key, position, name).<br/>osGetNPCList : same as osGetAvatarList, but only NPCs.
 
|-
 
|-
−
| llGetInventoryKey<br/>llGetInventoryName || [[osGetInventoryItemKey]]<br/>[[osGetInventoryName]] || || llGetInventoryKey returns <u>item</u> id while osGetInventoryItemKey returns <u>asset</u> id.<br/>llGetInventoryName returns name from (index,type) while osGetInventoryName return name fro item id.
+
| llGetInventoryKey<br/>llGetInventoryName || [[osGetInventoryItemKey]]<br/>[[osGetInventoryName]] || llGetInventoryKey returns <u>item</u> id while osGetInventoryItemKey returns <u>asset</u> id.<br/>llGetInventoryName returns name from (index,type) while osGetInventoryName return name fro item id.
 
|}
 
|}

Latest revision as of 07:33, 19 June 2023

LSL and OSSL functions may appear overlapping. Sometimes, they are. This may happen when a OSSL function has been written before it's LL conterpart. Most of the time, they are complementary.

OSSL implements features not available in LSL (NPCs, Texture Drawing) or extend them, like adressing prims by key, which gives unprecedented flexibility to the scripter.

This page tries to highlight the differences between OSSL and LSL functions when similar versions exist.

llGetLinkPrimitiveParams osGetLinkPrimitiveParams Allows for multiple-link constants LINK_SET, LINK_ALL_CHILDREN. Returns a by-side list of properties.
llSetLinkPrimitiveParams No need for OSSL version since llSetLinkPrimitiveParams accepts all LINK_* flags
llGetPrimitiveParams
llSetPrimitiveParams 		osGetPrimitiveParams
osSetPrimitiveParams 		Acts on out-of-linkset primitive (uuid instead of linknumber)
osSetProjectionParams Same effect can be obtained with llSetLinkPrimitiveParams (linknum, [PRIM_PROJECTOR]) but OSSL version has osSetPrimitiveParams power to work outside linkset.
llCreateLink
llBreakLink
llBreakAllLinks 		osForceCreateLink
osForceBreakLink
osForceBreakAllLinks 		Does not require PERMISSION_CHANGE_LINKS
llParticleSystem
llLinkParticleSystem 		osParticleSystem
osLinkParticleSystem
llSitTarget
llLinkSitTarget 		osSetStandTarget
osSetLinkStandTarget 		SitTarget is position when sitting.
StandTarget, position when unsitting.
llAvatarOnSitTarget
llAvatarOnLinkSitTarget 		osGetSittingAvatarsCount()
osGetSittingAvatarsCount(uuid) 		OSSL function returns the total number of avatars sitting on a linkset. LSL functions apply only to avatars on sittarget (return NULL_KEY if sittarget is not set) and cannot operate outside the linkset. A similar result can be obtained with llGetObjectDetails(uuid, [OBJECT_SIT_COUNT]).
llPlaySound
llLoopSound
llTriggerSound
... 		osPlaySound
osLoopSound
osTriggerSound
... 		All OSSL sound functions takes a linknumber argument.
llLinkPlaySound Universal link sound function (SOUND_PLAY, SOUND_LOOP, SOUND_TRIGGER, SOUND_SYNC). Equivalent to resp. osPlaySound, osLoopSound, osTriggerSound, osPlaySoundSlave, osLoopSoundSlave.
llGetNumberOfPrims
llGetObjectPrimCount 		osGetPrimCount()
osGetPrimCount(uuid) 		OSSL version does not count sitting avatars and does work on attachments
llStartAnimation
llStopAnimation 		osAvatarPlayAnimation
osAvatarStopAnimation 		Does not require PERMISSION_TRIGGER_ANIMATION
OSSL can animate multiples avatars, when LSL is bound to the avatar having granted the permission.
llAttachToAvatar
llDetachFromAvatar 		osForceAttachToAvatar
osForceDetachFromAvatar 		Does not require PERMISSION_ATTACH.
Target avatar is implicit. To attach explicitely to a given avatar, use osForceAttachToOtherAvatarFromInventory on the avatar's key.
llGetAgentList osGetAgents
osGetAvatarList
osGetNPCList 		llGetAgentList returns a list of agent keys.
osGetAgents, a list of agent names.
osGetAvatarList, a strided list of agent (key, position, name).
osGetNPCList : same as osGetAvatarList, but only NPCs.
llGetInventoryKey
llGetInventoryName 		osGetInventoryItemKey
osGetInventoryName 		llGetInventoryKey returns item id while osGetInventoryItemKey returns asset id.
llGetInventoryName returns name from (index,type) while osGetInventoryName return name fro item id.
Retrieved from "http://opensimulator.org/index.php?title=OSSL_vs_LSL&oldid=53648"
Personal tools
General
About This Wiki