diff --git a/trunk/Resource/ConfLSL.xml b/trunk/Resource/ConfLSL.xml
index b02f9e4..0db433a 100644
--- a/trunk/Resource/ConfLSL.xml
+++ b/trunk/Resource/ConfLSL.xml
@@ -1,4 +1,4 @@
-
+
+
+ integer llManageEstateAccess(integer Action, key AvatarID);
+
+ Use to add or remove agents from the estate's agent access or ban lists or groups from the estate's group access list.
+ Returns an integer representing a boolean, TRUE if the call was successful; FALSE if throttled, invalid action, invalid or null id or object owner is not allowed to manage the estate.
+ One of the ESTATE_ACCESS_ALLOWED_* actions.
+ UUID of the avatar or group to act upon.
+
+
+
+ llMapDestination(string simname, vector position, vector lookat);
+
+ Shows a given location on the map.
+ Works in attachments, or during touch events.
+ Currently the function will open the map window whenever it is called.
+ There is no way to simply set the map position without
+ opening the window.
+
+
llMessageLinked(integer linknum, integer num, string str, key id);
@@ -1131,11 +1821,20 @@
The linknum parameter is either the linked number
available through llGetLinkNumber or a link constant.
+
llMinEventDelay(float delay);
Set the minimum time between events being handled.
+
+
+ integer llModPow(integer a, integer b, integer c);
+
+ Returns a raised to the b power, mod c. ( (a ^ b)%c ).
+ b is capped at 0xFFFF (16 bits).
+
+
llModifyLand(integer action, integer size);
@@ -1148,1124 +1847,27 @@
LAND_SMALL_BRUSH, LAND_MEDIUM_BRUSH or LAND_LARGE_BRUSH
+
llMoveToTarget(vector target, float tau);
Critically damp to position target in tau-seconds if the
- script is physical. Good tau-values are greater than 0.2.
+ script is physical. Good tau-values are greater than 0.2.
A tau of 0.0 stops the critical damping.
+
llOffsetTexture(float offset_s, float offset_t, integer face);
- Sets the texture s and t offsets of face.
- If face is ALL_SIDES this function sets the texture offsets for
+ Sets the texture s and t offsets of face.
+ If face is ALL_SIDES this function sets the texture offsets for
all faces.
-
- integer llOverMyLand(key id);
- Returns TRUE if id is over land owned by the object owner,
- FALSE otherwise.
-
-
- list llParseString2List(string src, list separators, list spacers);
-
- Breaks src into a list, discarding anything in separators,
- keeping any entry in spacers. The
- separators and spacers must be lists of strings with a maximum
- of 8 entries each. So, if you had made the
- call:
- llParseString2List("Parsethisnow! I dare:you to.", ["this", "!", " "], [":"]);
- You would get the list:
- ["Parse", "now", "I", "dare", ":", "you", "to"]
-
-
- llParticleSystem(list parameters);
-
- Makes a particle system based on the parameter list.
- The parametersare specified as an ordered list of
- parameter and value. Valid parameters and their expected
- values can be found in the particle system constants.
- Here is a simple example:
- llParticleSystem([PSYS_PART_FLAGS, PSYS_PART_WIND_MASK,
- PSYS_PART_START_COLOR, <1,0,0>,
- PSYS_SRC_PATTERN, PSYS_SRC_PATTERN_EXPLODE]);
-
-
- llPassCollisions(integer pass);
-
- If pass is TRUE, land and object collisions are passed from
- children on to parents.
- The default is FALSE if there is no script to handle the collision events.
-
- boolean, if TRUE, collisions are passed from children on to parents
-
-
-
- llPassTouches(integer pass);
-
- If pass is TRUE, touches are passed from children on to parents.
- The default is TRUE if there is no script to handle the touch events.
-
- boolean, if TRUE, touches are passed from children on to parents
-
-
-
- llPlaySound(string sound, float volume);
-
- Plays a sound once. The sound will be attached to an object and
- follow object movement. Only one sound may
- be attached to an object at a time, and attaching a new sound or
- calling llStopSound will stop the previously
- attached sound. A second call to llPlaySound with the same sound
- will not restart the sound, but the new
- volume will be used, which allows control over the volume
- of already playing sounds. To restart the sound from
- the beginning, call llStopSound before calling llPlaySound again.
-
-
- llPlaySoundSlave(string sound, float volume);
-
- Behavior is identical to llPlaySound, unless there is
- a "Sync Master" present. If a Sync Master is already
- playing the Slave sound will not be played until the Master
- hits its loop point and returns to the beginning.
- llPlaySoundSlave will play the sound exactly once; if it is
- desired to have the sound play every time the Master
- loops, either use llLoopSoundSlave with extra silence padded
- on the end of the sound or ensure that
- llPlaySoundSlave is called at least once per loop of the Master.
-
-
-
- llPow(float base, float exp);
-
- Returns base raised to the exp.
-
-
- llPreloadSound(string sound);
-
- Preloads sound from object inventory on nearby viewers.
-
-
- llPushObject(key id, vector impulse, vector angular_impulse, integer local);
-
- Applies impulse and angular_impulse to object id.
-
-
- llReleaseControls(key avatar);
-
- Stop taking inputs from avatar.
-
-
-
- llRemoveInventory(string inventory);
-
- Remove the named inventory item from the object inventory.
-
-
- llRemoveVehicleFlags(integer flags);
-
- Sets the vehicle flags to FALSE. Valid parameters can be found in the vehicle flags constants section.
-
-
- key llRequestAgentData(key id, integer data);
-
- This function requests data about agent id. If and when the information
- is collected, the dataserver event is
- called with the returned key returned from this function passed in
- the requested parameter. See the agent data
- constants for details about valid values of data and what each will
- return in the dataserver event.
-
-
- key llRequestInventoryData(string name);
-
- Requests data from object inventory item name. When data is available
- the dataserver event will be raised with
- the key returned from this function in the requested parameter.
- The only request currently implemented is to
- request data from landmarks, where the data returned is in the
- form "<float, float, float>" which can be cast to a
- vector. This position is in region local coordinates.
-
-
- llRequestPermissions(key avatar, integer perm);
-
- Ask avatar to allow the script to do perm. The perm parameter should
- be a permission constant. Multiple
- permissions can be requested simultaneously by ORing the
- constants together. Many of the permissions requests
- can only go to object owner. This call will not stop script
- execution -if the specified avatar grants the requested
- permissions, the run_time_permissions event will be called.
-
-
- llResetScript(void);
-
- Resets this script.
-
-
- llResetOtherScript(string name);
-
- Resets the script name.
-
-
- llResetTime(void);
-
- Sets the internal timer to zero.
-
-
- llRezObject(string inventory, vector pos, vector vel, rotation rot, integer param);
-
- Creates object's inventory object at position pos with velocity
- vel and rotation rot. The param value
- will be available to the newly created object in the on_rez
- event or through the llGetStartParameter library
- function. The vel parameter is ignored if the rezzed object
- is not physical.
-
-
- float llRot2Angle(rotation rot);
-
- Returns the rotation angle represented by rot.
-
-
- vector llRot2Axis(rotation rot);
-
- Returns the rotation axis represented by rot.
-
-
- vector llRot2Euler(rotation rot);
-
- Returns the Euler Angle representation of rot.
-
-
- vector llRot2Fwd(rotation rot);
-
- Returns the forward axis represented by rot.
-
-
- vector llRot2Left(rotation rot);
-
- Returns the left axis represented by rot.
-
-
- vector llRot2Up(rotation rot);
-
- Returns the up axis represented by rot.
-
-
- rotation llRotBetween(vector a, vector b);
-
- Returns the rotation needed to rotate ato b.
-
-
- llRotLookAt(rotation rot, float strength, float damping);
-
- Cause object to rotate to rot. Good strength values are around
- half the mass of the object and good
- damping values are less than 1/10th of the strength.
- Asymmetrical shapes require smaller damping.A
- strengthof 0.0 cancels the look at.
-
-
- integer llRotTarget(rotation rot, float error);
-
- Set object rotation within error of rotation as a rotational
- target and return an integer number for the
- target. The number can be used in llRotTargetRemove.
-
-
- llRotTargetRemove(integer number);
-
- Remove rotational target number.
-
-
- llRotateTexture(float radians, integer face);
-
- Sets the texture rotation of face to radians.
- If face ALL_SIDES, rotate the texture of all faces.
-
-
- integer llRound(float val);
-
- returns val rounded to the nearest integer.
-
-
- integer llSameGroup(key id);
-
- Returns TRUE if the object or agen id is in the same simulator
- and has the same active group as this object.
- Otherwise, returns FALSE.
-
-
- llRegionSay(integer channel, string text);
-
- Says the string text on channel number channel that can be heard
- anywhere in the region by a script listening on channel.
-
- Any integer value other than zero
-
-
- Message to be transmitted
-
-
-
- llSay(integer channel, string text);
- Say text on channel.
- Channel 0 is the public chat channel that all
- avatars see as chat text. Channels 1 to 2,147,483,648 are private
- channels that are not sent to avatars but other scripts can listen
- for through the llListen api.
-
- Channel to use to say text on
-
- Text to say
-
-
- llScaleTexture(float horizontal, float vertical, integer side);
-
- Sets the horizontal and vertical repeats per face on side.
- If side == ALL_SIDES, all sides are set in one call.
- Negative values for horizontal and vertical will flip the texture.
-
-
- integer llScriptDanger(vector pos);
-
- Returns true if pos is over public land, land that doesn't allow everyone
- to edit and build, or land that doesn't allow outside scripts.
-
-
- llSensor(string name, key id, integer type, float range, float arc);
-
- Performs a single scan for name and id with type within
- range meters and arc radians of forward vector.
- Specifying a blank name or NULL_KEY id will not filter
- results for any particular name or id A range of 0.0
- does not perform a scan. The type parameter should be an
- object type constant vlaue.
-
-
- llSensorRemove(void);
-
- Removes the sensor.
-
-
- llSensorRepeat(string name, key id, integer type, float range, float arc, float rate);
-
- Performs a repeating sensor scan for name and id with type
- (AGENT, ACTIVE, PASSIVE, and/or SCRIPTED) within range meters and arc
- radians of forward vector (name and/or id can be empty or 0).
- A range of 0.0m does perform a scan. The parameters have the same
- function as llSensor, except rate, which defines the number of
- seconds between repeated sensor or no_sensor event calls.
-
-
- llSetAlpha(float alpha, integer face);
-
- Sets the alpha value for face. If face is ALL_SIDES,
- set the alpha to all faces. The alpha value is interpreted
- as an opacity percentage -1.0 is fully opaque, and 0.2 is
- mostly transparent. This api will clamp alpha values
- less 0.1 to .1 and greater than 1.0 to 1.
-
-
- llSetBuoyancy(float buoyancy);
-
- Set the object buoyancy. A value of 0 is none,
- less than 1.0 sinks, 1.0 floats, and greater than 1.0 rises.
-
-
- llSetCameraAtOffset(vector offset);
-
- Sets the camera at offset used in this object
- if an avatar sits on it.
-
-
- llSetCameraEyeOffset(vector offset);
-
- Sets the camera eye offset used in this object if an avatar sits on it.
-
-
- llSetColor(vector color, integer face);
-
- Sets the color of face. If face is ALL_SIDES, set the color to all faces.
-
-
- llSetDamage(float damage);
-
- Sets the amount of damage that will be done to an object
- that this object hits. This object will be destoyed on
- damaging another object.
-
-
- llSetForce(vector force, integer local);
-
- If the object is physical, this function sets the force.
- The vector is in local coordinates if local is TRUE, global if
- FALSE.
-
- directional force
-
-
- boolean, if TRUE uses local axis, if FALSE uses region axis.
-
-
-
- llSetForceAndTorque(vector force, vector torque, integer local);
-
- If the object is physical, this function sets the force and
- torque. The vectors are in loal coordinates if local is
- TRUE, global if FALSE.
-
- directional force
-
-
- torque force
-
-
- boolean, if TRUE uses local axis, if FALSE uses region axis.
-
-
-
- llSetHoverHeight(float height, float water, float tau);
-
- Critically damps to a height. The height is above ground
- and water if water is TRUE. Only works with physics-enabled objects.
- Do not use with vehicles. Use llStopHover to stop hovering.
-
- Distance above the ground
-
-
- boolean, if TRUE then hover above water too.
-
-
- seconds to critically damp in
-
-
-
- llSetLinkColor(integer linknumber, vector color, integer face);
-
- Sets the color of the linked child specified by linknumber.
- A value of 0 means no link, 1 the root, 2 for first
- child, etc. If linknumber is ALL_SIDES, set the color
- of all objects in the linked set. If face is
- ALL_SIDES, set the color of all faces.
-
-
- llSetObjectName(string name);
-
- Sets the object name to name.
-
-
- llSetPos(vector pos);
-
- If the object is not physical, this function sets the position
- in region coordinates. If the object is a child, the
- position is treated as root relative and the linked set is adjusted.
-
-
- llSetRot(rotation rot);
-
- If the object is not physical, this function sets the rotation.
- If the object is a child, the position is treated as root
- relative and the linked set is adjusted.
-
-
- llSetScale(vector scale);
-
- Sets the object scale.
-
-
- llSetScriptState(string name, integer run);
-
- Control the state of a script on the object.
-
-
- llSetSitText(string text);
-
- Displays text rather than sit in viewer pie menu.
-
-
- llSetSoundQueueing(integer queue);
-
- Sets whether successive calls to llPlaySound, llLoopSound,
- etc., (attached sounds) interrupt the playing sound.
- The default for objects is FALSE. Setting this value to
- TRUE will make the sound wait until the current playing
- sound reaches its end. The queue is one level deep.
-
- boolean, sound queuing: TRUE enables, FALSE disables (default)
-
-
-
- llSetStatus(integer status, integer value);
-
- Sets the status to value. Use status constants for the values of status.
-
-
- llSetText(string text, vector color, float alpha);
-
- Sets text that floats above object to text,
- using the specified color and alpha.
-
-
- llSetTexture(string texture, integer face);
-
- Sets the texture from object inventory of face.
- If face is ALL_SIDES, set the texture to all faces.
-
-
- llSetTextureAnim(integer mode, integer face, integer sizex, integer sizey, float start, float length, float rate);
-
- Animates a texture by setting the texture scale and offset.
- mask of Mode flags
- face number or ALL_SIDES
- horizontal frames (ignored for ROTATE and SCALE)
- vertical frames (ignored for ROTATE and SCALE)
- Start position/frame number (or radians for ROTATE)
- number of frames to display (or radians for ROTATE)
- frames per second (must not be zero)
-
-
- llSetTimerEvent(float sec);
-
- Sets the timer event to be triggered every sec seconds.
- Passing in 0.0 stops further timer events.
-
-
- llSetTorque(vector torque, integer local);
-
- If the object is physical, this function sets the torque.
- The vector is in local coordinates if local is TRUE, global
- if FALSE.
-
- torque force
-
-
- boolean, if TRUE uses local axis, if FALSE uses region axis.
-
-
-
- llSetTouchText(string text);
-
- Displays text in viewer pie menu that acts as a touch.
-
-
- llSetVehicleFlags(integer flags);
-
- Sets the vehicle flags to TRUE.
- Valid parameters can be found in the vehicle flags constants section.
-
-
- llSetVehicleFloatParam(integer param_name, float param_value);
-
- Sets the vehicle floating point parameter param_name to param_value.
- Valid parameters and their expected
- values can be found in the vehicle parameter constants section.
-
-
- llSetVehicleType(integer type);
-
- Activates the vehicle action and choose vehicle type.
- Valid types and an explination of their characteristeics
- can be found in the vehicle type constants section.
-
-
- llSetVehicleRotationParam(integer param_name, rotation param_value);
-
- Sets the vehicle rotation parameter param_name to param_value.
- Valid parameters can be found in the
- vehicle parameter constants section.
-
-
- llSetVehicleVectorParam(integer param_name, vector param_value);
-
- Sets the vehicle vector parameter param_name to param_value.
- Valid parameters can be found in the
- vehicle parameter constants section.
-
-
- llShout(integer channel, string text);
-
- Shout text on channel. Channel 0 is the public chat channel that
- all avatars see as chat text. Channels 1 to
- 2,147,483,648 are private channels that are not sent to
- avatars but other scripts can listen for through the llListen api.
-
-
- float llSin(float theta);
-
- Returns the sine of theta in radians.
-
-
- llSitTarget(vector offset, rotation rot);
-
- Set the sit location for this object. If offset == ZERO_VECTOR
- clear the sit target.
-
-
- llSleep(float sec);
-
- Puts the script to sleep for sec seconds.
-
-
- float llSqrt(float val);
-
- Returns the square root of val. If val is less than 0.0,
- this function returns 0.0 and raises a math runtime error.
-
-
- llStartAnimation(string anim);
-
- This function starts animation anim for the avatar that owns the object.
-
-
- llStopAnimation(string anim);
-
- Stop animation animfor avatar that owns object.
-
-
- llStopHover(void);
-
- Stop hover to a height.
-
-
- llStopLookAt(void);
-
- Stop causing object to look at target.
-
-
- llStopMoveToTarget(void);
-
- Stops critically damped motion.
-
-
-
- llStopSound(void);
-
- Stops a currently playing attached sound started with
- llPlaySound or llLoopSound. Has no effect on sounds
- started with llTriggerSound.
-
-
- integer llStringLength(string src);
-
- Returns the number of characters in src.
-
-
- integer llSubStringIndex(string source, string pattern);
-
- Finds index in source where pattern first appears.
- Returns -1 if no match is found found.
-
-
- llTakeControls(integer controls, integer accept, integer pass_on);
-
- If ( accept == (controls and input) ), send input to object.
- If the boolean pass_on is TRUE, also send input
- to avatar. Requires the PERMISSION_TAKE_CONTROLS permission to run.
-
- bitfield of CONTROL_* flags
-
-
- boolean, determines whether control events are generated
-
-
- boolean, determines whether controls are disabled
-
-
-
- float llTan(float theta);
-
- Returns the tangent of theta radians.
-
-
- integer llTarget(vector position, float range);
-
- Set object position within range of position as a target
- and returns an integer ID for the target.
-
-
- llTargetOmega(vector axis, float spinrate, float gain);
-
- Attempt to spin at spinrate with strength gain on axis.
- A spinrate of 0.0 cancels the spin. This
- function always works in object local coordinates.
-
-
- llTargetRemove(integer tnumber);
-
- Remove target number tnumber.
-
-
- llTeleportAgentHome(key id);
-
- Teleport agent on the owner's land to agent's home location.
-
-
- string llToLower(string src);
-
- Returns src in all lower case.
-
-
- string llToUpper(string src);
-
- Returns src in all upper case.
-
-
- llTriggerSound(string sound, float volume);
-
- Plays a transient sound NOT attached to an object.
- The sound plays from a stationary position located at the
- center of the object at the time of the trigger.
- There is no limit to the number of triggered sounds which can be
- generated by an object, and calling llTriggerSound does not affect
- the attached sounds created by llPlaySound
- and llLoopSound. This is very useful for things like collision noises,
- explosions, etc. There is no way to stop or
- alter the volume of a sound triggered by this function.
-
-
- llTriggerSoundLimited(string sound, float volume, vector tne, vector bsw);
-
- Plays a transient sound NOT attached to an object with its
- audible range limited by the axis aligned bounding
- box define by tne(top-north-eash) and bsw (bottom-south-west).
- The sound plays from a stationary position
- located at the center of the object at the time of the trigger.
- There is no limit to the number of triggered sounds
- which can be generated by an object, and calling llTriggerSound
- does not affect the attached sounds created by
- llPlaySound and llLoopSound. This is very useful for things
- like collision noises, explosions, etc. There is no
- way to stop or alter the volume of a sound triggered by this function.
-
-
- llUnSit(key id);
-
- If agent identified by id is sitting on the object the script
- is attached to or is over land owned by the objects
- owner, the agent is forced to stand up.
-
-
- float llVecDist(vector a, vector b);
-
- Returns the distance from ato b
-
-
- float llVecMag(vector vec);
-
- Returns the magnitude of vec.
-
-
- vector llVecNorm(vector vec);
-
- Returns normalized vec.
-
-
- llVolumeDetect(integer detect);
-
- When detect = TRUE, this makes the entire link set the script
- is attached to phantom but if another object
- interpenetrates it, it will get a collision_start event.
- When an object stops interpenetrating, a collision_end event
- is generated. While the other is interpenetrating,
- collision events are NOT generated. The script must be applied
- to the root object of the link set to get the collision events.
- Collision filters work normally.
-
- TRUE enables, FALSE disables
-
-
-
- float llWater(vector offset);
-
- Returns the water height at the object position + offset.
-
-
- llWhisper(integer channel, string text);
-
- Whisper text on channel. Channel 0 is the public chat channel that
- all avatars see as chat text. Channels 1 to 2,147,483,648 are
- private channels that are not sent to avatars but other scripts
- can listen for through the llListen api.
-
-
- vector llWind(vector offset);
-
- Returns the wind velocity below the object position + offset.
-
-
- llAddToLandBanList(key agent, float hours);
-
- Adds agent to the parcel ban list for the specified number of hours.
- A value of 0 for hours will add agent indefinitely.
- The smallest value hours will accept is 0.01;
- anything smaller will be seen as 0.
- When values that small are used, it seems the function bans
- in 30 second increments (Probably 36 second increments,
- as 0.01 of an hour is 36 seconds).
- Residents teleporting to a parcel where they are banned
- will be redirected to a neighboring parcel.
-
-
- integer llBase64ToInteger(string str);
-
- Little endian decode the 8 character Base64 string str into an integer.
-
-
- string llBase64ToString(string str);
-
- Converts a Base 64 string to a conventional string.
- If the conversion creates any unprintable characters, they are converted to question marks (this behavior is different then llUnescapeURL).
-
-
- llClearCameraParams();
-
- Resets all camera parameters to default values and turns
- off scripted camera control.
-
-
- integer llClearPrimMedia( integer face );
-
- Clears (deletes) the media and all params from the given face.
-
- Returns an integer that is a STATUS_* flag which details the success/failure of the operation.
- face number
-
-
- llCloseRemoteDataChannel(key channel);
-
- Closes XML-RPC channel.
-
-
- integer llDetectedGroup(integer number);
-
- Returns TRUE if detected object or agent number has the same
- user group active as this object.
- It will return FALSE if the object or agent is in the group,
- but the group is not active.
-
-
- string llEscapeURL(string url);
-
- Returns the string that is the URL-escaped version of url
- (replacing spaces with %20, etc).
- This function returns the UTF-8 encoded escape codes
- for selected characters.
-
-
- llForceMouselook(integer mouselook);
-
- After calling this function with mouselook set to TRUE,
- any agent sitting down on the prim will be forced into mouselook.
- Just like llSitTarget, this changes a permanent property
- of the prim (not the object) and needs to be reset by calling
- this function with mouselook set to FALSE in order to disable it.
-
- boolean, if TRUE when an avatar sits on the prim,
- the avatar will be forced into mouselook mode.
- FALSE is the default setting and will undo
- a previously set TRUE or do nothing.
-
-
-
- list llGetAnimationList(key id);
-
- Returns a list of keys of all playing animations for avatar id.
-
-
- list llGetBoundingBox(key object);
-
- Returns the bounding box around the object or avatar with
- the key object (including any linked prims) relative to the
- root prim, in a list: [ (vector) min_corner, (vector) max_corner ]
-
-
- vector llGetCameraPos();
- Returns the position of the camera of the user that granted the
- script PERMISSION_TRACK_CAMERA. If no user has granted the permission,
- it returns ZERO_VECTOR.
-
-
- rotation llGetCameraRot();
-
- Returns the rotation of the camera of the user who's granted
- this script PERMISSION_TRACK_CAMERA. If no user has granted the
- permission, it returns ZERO_ROTATION. The key of the user whose
- camera is being tracked can be obtained using llGetPermissionsKey.
-
-
- key llGetCreator();
-
- Returns the key of the object's original creator. Similar to llGetOwner.
-
-
- string llGetDisplayName( key id );
-
- Returns a string that is the non-unique display name of the avatar specified by id.
- • key id – avatar UUID that is in the same region or is otherwise known to the region
-
- id must specify a valid avatar key, present in or otherwise known to the sim in which the script is running, otherwise an empty
- string is returned. This function will still return a valid display name if the avatar is a child agent of the sim
- (i.e., in an adjacent sim, but presently able to see into the one the script is in), or for a short period after the avatar
- leaves the sim (specifically, when the client completely disconnects from the sim, either as a main or child agent).
-
-
- vector llGetGeometricCenter();
-
- Returns the geometric center of the linked set the
- script is in relative to the object's position
- (the position of the root prim of a linked set).
- To get the object's position, use llGetPos.
-
-
- float llGetGMTclock();
-
- Gets the time in seconds since midnight in GMT/UTC.
-
-
- key llGetInventoryCreator(string item);
-
- This function returns the UUID of the creator of item.
- If item is not found in inventory,
- the object says "No item named 'name' ".
-
-
- integer llGetInventoryPermMask(string item, integer mask);
-
- Returns the requested permission mask for the inventory
- item defined by item. If item is not in the object's inventory,
- llGetInventoryPermMask returns 0 and causes the object to
- say "No item named '<item>'", where "<item>" is item.
- If this is used to determine whether or not an inventory item
- exists within the object, it will have the side effect of spamming chat.
- inventory item
-
- MASK_BASE, MASK_OWNER,MASK_GROUP, MASK_EVERYONE or MASK_NEXT
-
-
-
- integer llGetInventoryType(string name);
-
- Returns the type of the inventory item name.
- Remember, like the other inventory functions, llGetInventoryType
- is case-sensitive.
-
-
- integer llGetLinkNumberOfSides( integer link );
-
- Returns an integer that is the number of faces (or sides) of the prim link.
- • integer link – Link number (0: unlinked, 1: root prim, >1: child prims) or a LINK_* flag
-
-
- float llGetMass();
-
- Returns the scripted object's mass. When called from a script
- in a linkset, the parent will return the sum of the linkset weights,
- while a child will return just its own mass. When called from
- a script inside an attachment, this function will return the mass
- of the avatar it's attached to, not its own.
-
-
- key llGetNumberOfNotecardLines(string name);
-
- Returns number of lines in the notecard name via the dataserver event.
- (Cast the value returned by the dataserver to an integer.)
- The key returned is a query id for identifying the dataserver reply.
-
-
- integer llGetNumberOfPrims();
-
- Returns the number of prims in (and avatars seated on)
- the object the script is in.
-
-
- string llGetObjectDesc();
-
- Returns the description of the scripted object/prim.
- You can set the description using llSetObjectDesc.
-
-
- float llGetObjectMass(key id);
-
- Gets the mass of the object or avatar corresponding to id.
-
-
- integer llGetObjectPermMask(integer mask);
-
- Returns the requested permission mask for the root object
- the task is attached to.
-
-
-
- integer llGetParcelFlags(vector pos);
-
- Returns a bitfield specifying the parcel flags
- (PARCEL_FLAG_*) for the parcel under the position pos.
-
-
- list llGetPrimitiveParams(list params);
-
- Returns primitive parameters specified in the params list.
-
-
- list llGetPrimMediaParams( integer face, list params );
-
- Get the media params for a particular face on an object, given the desired list of names.
-
- Returns a list of values in the order requested.
- face number
- a set of names (in no particular order)
-
- Returns an empty list if no media exists on the face.
-
-
- vector llGetRegionCorner();
-
- Returns the RegionCorner of the simulator containing the task.
-
-
- integer llGetRegionFlags();
-
- Returns a bitfield specifying the region flags
- (REGION_FLAG_*) for the region the object is in.
-
-
- vector llGetRootPosition();
-
- Gets the position (in region coordinates)
- of the root/parent prim of the object containing the script.
- This is used to allow a child prim to determine where the root is.
-
-
- rotation llGetRootRotation();
-
- Gets the global rotation of the root object of the
- object script is attached to.
-
-
- string llGetSimulatorHostname();
-
- Returns the host name (server) of the sim
- in which the scripted object is located.
- For example, "sim225.agni.lindenlab.com".
-
-
- string llGetTimestamp();
-
- Returns the current time-and-date (a timestamp)
- in the format YYYY-MM-DDThh:mm:ss.ff..fZ,
- for example: 2004-08-27T00:56:21.785886Z
- The letter Z stands for Zulu,
- the military time zone name for UTC. T is just
- a separator between date and time.
-
-
- integer llGetUnixTime();
-
- Returns the number of seconds elapsed since 00:00 hours,
- Jan 1, 1970 UTC from the system clock.
- In UNIX terms, time_t. This is great for a monotonic
- source of time that ticks once a second.
-
-
- key llHTTPRequest(string url, list parameters, string body);
-
- Sends HTTP request to url with the specified body and parameters.
-
- url must always be a valid HTTP or HTTPS URL, pointing to a
- location outside the Linden Lab and Second Life servers.
-
-
- string llIntegerToBase64(integer number);
-
- Encodes number as an 8-character Base64 string.
-
-
- list llListReplaceList(list dest, list src, integer start, integer end);
-
- Returns a list replacing the slice of the list dest from
- start to end with the list src. start and end are inclusive,
- so 0, 1 would replace the first two entries
- and 0, 0 would replace only the first list entry.
-
-
- float llListStatistics(integer operation, list input);
-
- This function allows a script to perform a statistical
- operation as defined by operation on a list composed
- of integers and floats.
-
- One of LIST_STAT_* values
-
-
-
- llLoadURL(key avatar_id, string message, string url);
-
- llLoadURL displays a dialog box to the user offering
- to load a web page using the default web browser.
-
-
- float llLog(float val);
-
- Returns the base e (natural) logarithm of val (value).
-
-
- float llLog10(float val);
-
- Returns the base 10 (common) logarithm of val (value).
-
-
- llMapDestination(string simname, vector position, vector lookat);
-
- Shows a given location on the map.
- Works in attachments, or during touch events.
- Currently the function will open the map window whenever it is called.
- There is no way to simply set the map position without
- opening the window.
-
-
- string llMD5String(string src, integer nonce);
-
- Performs a RSA Data Security, Inc. MD5 Message-Digest
- Algorithm on string with nonce (also known as salt).
- Returns a 32-character hex string. (128-bit in binary.)
-
-
- integer llModPow(integer a, integer b, integer c);
-
- Returns a raised to the b power, mod c. ( (a ^ b)%c ).
- b is capped at 0xFFFF (16 bits).
-
llOpenRemoteDataChannel();
- Creates a channel to listen for XML-RPC calls.
+ Creates a channel to listen for XML-RPC calls.
Will trigger a remote_data event with type = REMOTE_DATA_CHANNEL
and a channel ID (key) once it is available.
This channel ID must be referenced in the XML-RPC call
@@ -2273,6 +1875,14 @@
so the key must somehow get to the scripter's XML-RPC client,
most often via llEmail, llHttpRequest or llLoadUrl.
+
+
+ integer llOverMyLand(key id);
+
+ Returns TRUE if id is over land owned by the object owner,
+ FALSE otherwise.
+
+
llOwnerSay(string message);
@@ -2280,11 +1890,13 @@
if the owner has been within the object's simulator since
logging into Second Life, regardless of where they may be are in-world.
+
llParcelMediaCommandList(list command_list);
Playing QuickTime movies (you have to own the land).
+
list llParcelMediaQuery(list query_list);
@@ -2297,6 +1909,20 @@
object owner is a member of the group. The object
actually has to be owned by the group.
+
+
+ list llParseString2List(string src, list separators, list spacers);
+
+ Breaks src into a list, discarding anything in separators,
+ keeping any entry in spacers. The
+ separators and spacers must be lists of strings with a maximum
+ of 8 entries each. So, if you had made the
+ call:
+ llParseString2List("Parsethisnow! I dare:you to.", ["this", "!", " "], [":"]);
+ You would get the list:
+ ["Parse", "now", "I", "dare", ":", "you", "to"]
+
+
list llParseStringKeepNulls(string src, list separators, list spacers);
@@ -2305,16 +1931,141 @@
it will add a null string instead of discarding it
like llParseString2List does.
+
+
+ llParticleSystem(list parameters);
+
+ Makes a particle system based on the parameter list.
+ The parametersare specified as an ordered list of
+ parameter and value. Valid parameters and their expected
+ values can be found in the particle system constants.
+ Here is a simple example:
+ llParticleSystem([PSYS_PART_FLAGS, PSYS_PART_WIND_MASK,
+ PSYS_PART_START_COLOR, <1,0,0>,
+ PSYS_SRC_PATTERN, PSYS_SRC_PATTERN_EXPLODE]);
+
+
+
+ llPassCollisions(integer pass);
+
+ If pass is TRUE, land and object collisions are passed from
+ children on to parents.
+ The default is FALSE if there is no script to handle the collision events.
+
+ boolean, if TRUE, collisions are passed from children on to parents
+
+
+
+
+ llPassTouches(integer pass);
+
+ If pass is TRUE, touches are passed from children on to parents.
+ The default is TRUE if there is no script to handle the touch events.
+
+ boolean, if TRUE, touches are passed from children on to parents
+
+
+
+
+ llPlaySound(string sound, float volume);
+
+ Plays a sound once. The sound will be attached to an object and
+ follow object movement. Only one sound may
+ be attached to an object at a time, and attaching a new sound or
+ calling llStopSound will stop the previously
+ attached sound. A second call to llPlaySound with the same sound
+ will not restart the sound, but the new
+ volume will be used, which allows control over the volume
+ of already playing sounds. To restart the sound from
+ the beginning, call llStopSound before calling llPlaySound again.
+
+
+
+ llPlaySoundSlave(string sound, float volume);
+
+ Behavior is identical to llPlaySound, unless there is
+ a "Sync Master" present. If a Sync Master is already
+ playing the Slave sound will not be played until the Master
+ hits its loop point and returns to the beginning.
+ llPlaySoundSlave will play the sound exactly once; if it is
+ desired to have the sound play every time the Master
+ loops, either use llLoopSoundSlave with extra silence padded
+ on the end of the sound or ensure that
+ llPlaySoundSlave is called at least once per loop of the Master.
+
+
+
+
+ llPow(float base, float exp);
+
+ Returns base raised to the exp.
+
+
+
+ llPreloadSound(string sound);
+
+ Preloads sound from object inventory on nearby viewers.
+
+
+
+ llPushObject(key id, vector impulse, vector angular_impulse, integer local);
+
+ Applies impulse and angular_impulse to object id.
+
+
+
+ llRegionSay(integer channel, string text);
+
+ Says the string text on channel number channel that can be heard
+ anywhere in the region by a script listening on channel.
+
+ Any integer value other than zero
+
+
+ Message to be transmitted
+
+
+
+
+ llRegionSayTo( key target, integer channel, string msg );
+
+ Says the text supplied in string msg on channel supplied in integer channel to the object or avatar specified by target
+ • key target
+ • integer channel – output channel, any integer value
+ • string msg – message to be transmitted
+
+
+
+
+
+ llReleaseControls(key avatar);
+
+ Stop taking inputs from avatar.
+
+
+
+ llReleaseURL( string url );
+
+ Releases the specified URL, it will no longer be usable.
+ URL to release
+
+
llRemoteDataReply(key channel, key message_id, string sdata, integer idata);
@@ -2322,13 +2073,18 @@
on channel with payload of string sdata and integer idata.
The size of sdata is limited to 254 characters.
-
+
llRemoteLoadScriptPin(key target, string name, integer pin, integer running, integer start_param);
@@ -2337,17 +2093,111 @@
the PIN previously set using llSetRemoteScriptAccessPin
(on the target prim), then the script name will be copied into target.
+
llRemoveFromLandBanList(key avatar);
Remove avatar from the land parcel ban list.
+
llRemoveFromLandPassList(key avatar);
Remove avatar from the land parcel pass list.
+
+ llRemoveInventory(string inventory);
+
+ Remove the named inventory item from the object inventory.
+
+
+
+ llRemoveVehicleFlags(integer flags);
+
+ Sets the vehicle flags to FALSE. Valid parameters can be found in the vehicle flags constants section.
+
+
+
+ key llRequestAgentData(key id, integer data);
+
+ This function requests data about agent id. If and when the information
+ is collected, the dataserver event is
+ called with the returned key returned from this function passed in
+ the requested parameter. See the agent data
+ constants for details about valid values of data and what each will
+ return in the dataserver event.
+
+
+
+ key llRequestDisplayName( key id );
+
+ Requests the Display Name of the agent identified by id. When the Display Name is available the dataserver event will be raised.
+ The agent identified by id does not need to be in the same region or online at the time of the request.
+ Returns the key that is used to identify the dataserver event when it is raised.
+ • key id – avatar UUID
+
+
+
+ key llRequestInventoryData(string name);
+
+ Requests data from object inventory item name. When data is available
+ the dataserver event will be raised with
+ the key returned from this function in the requested parameter.
+ The only request currently implemented is to
+ request data from landmarks, where the data returned is in the
+ form "<float, float, float>" which can be cast to a
+ vector. This position is in region local coordinates.
+
+
+
+ llRequestPermissions(key avatar, integer perm);
+
+ Ask avatar to allow the script to do perm. The perm parameter should
+ be a permission constant. Multiple
+ permissions can be requested simultaneously by ORing the
+ constants together. Many of the permissions requests
+ can only go to object owner. This call will not stop script
+ execution -if the specified avatar grants the requested
+ permissions, the run_time_permissions event will be called.
+
+
+
+ key llRequestSecureURL( );
+
+ Requests one HTTPS:// (SSL) url for use by this object. The http_request event is tiggered with results.
+
+ Returns a key that is the handle used for identifying the request in the http_request event.
+
+
+
+ key llRequestSimulatorData(string simulator, integer data);
+
+ Requests data about the sim with the name simulator.
+ simulator is case-insensitive.
+ Returns a dataserver query ID and triggers the dataserver
+ event when data is found. The sim name is usually not case-sensitive,
+ but sometimes will return data for a similarly-named sim
+ if the supplied case doesn't match the intended sim's actual name.
+
+
+
+ key llRequestURL( );
+
+ Requests one HTTP:// url for use by this script. The http_request event is triggered with the result of the request.
+
+ Returns a key that is the handle used for identifying the result in the http_request event.
+
+
+
+ key llRequestUsername( key id );
+
+ Requests the Username of the agent identified by id. When Username is available the dataserver event will be raised.
+ The agent identified by id does not need to be in the same region or online at the time of the request.
+ Returns a key that is used to identify the dataserver event when it is raised.
+ • key id – avatar UUID
+
+
llResetLandBanList(void)
@@ -2360,22 +2210,164 @@
Removes all residents from the land access/pass list.
-
- key llRequestSimulatorData(string simulator, integer data);
+
+ llResetScript(void);
- Requests data about the sim with the name simulator.
- simulator is case-insensitive.
- Returns a dataserver query ID and triggers the dataserver
- event when data is found. The sim name is usually not case-sensitive,
- but sometimes will return data for a similarly-named sim
- if the supplied case doesn't match the intended sim's actual name.
+ Resets this script.
+
+
+ llResetOtherScript(string name);
+
+ Resets the script name.
+
+
+
+ llResetTime(void);
+
+ Sets the internal timer to zero.
+
+
llRezAtRoot(string inventory, vector pos, vector vel, rotation rot, integer param);
Rezzes object's inventory item named inventory at
pos with velocity vel and rotation rot with start parameter param.
+
+
+ llRezObject(string inventory, vector pos, vector vel, rotation rot, integer param);
+
+ Creates object's inventory object at position pos with velocity
+ vel and rotation rot. The param value
+ will be available to the newly created object in the on_rez
+ event or through the llGetStartParameter library
+ function. The vel parameter is ignored if the rezzed object
+ is not physical.
+
+
+
+ float llRot2Angle(rotation rot);
+
+ Returns the rotation angle represented by rot.
+
+
+
+ vector llRot2Axis(rotation rot);
+
+ Returns the rotation axis represented by rot.
+
+
+
+ vector llRot2Euler(rotation rot);
+
+ Returns the Euler Angle representation of rot.
+
+
+
+ vector llRot2Fwd(rotation rot);
+
+ Returns the forward axis represented by rot.
+
+
+
+ vector llRot2Left(rotation rot);
+
+ Returns the left axis represented by rot.
+
+
+
+ vector llRot2Up(rotation rot);
+
+ Returns the up axis represented by rot.
+
+
+
+ rotation llRotBetween(vector a, vector b);
+
+ Returns the rotation needed to rotate ato b.
+
+
+
+ llRotLookAt(rotation rot, float strength, float damping);
+
+ Cause object to rotate to rot. Good strength values are around
+ half the mass of the object and good
+ damping values are less than 1/10th of the strength.
+ Asymmetrical shapes require smaller damping.A
+ strengthof 0.0 cancels the look at.
+
+
+
+ integer llRotTarget(rotation rot, float error);
+
+ Set object rotation within error of rotation as a rotational
+ target and return an integer number for the
+ target. The number can be used in llRotTargetRemove.
+
+
+
+ llRotTargetRemove(integer number);
+
+ Remove rotational target number.
+
+
+
+ llRotateTexture(float radians, integer face);
+
+ Sets the texture rotation of face to radians.
+ If face ALL_SIDES, rotate the texture of all faces.
+
+
+
+ integer llRound(float val);
+
+ returns val rounded to the nearest integer.
+
+
+
+ integer llSameGroup(key id);
+
+ Returns TRUE if the object or agen id is in the same simulator
+ and has the same active group as this object.
+ Otherwise, returns FALSE.
+
+
+
+ llSay(integer channel, string text);
+ Say text on channel.
+ Channel 0 is the public chat channel that all
+ avatars see as chat text. Channels 1 to 2,147,483,648 are private
+ channels that are not sent to avatars but other scripts can listen
+ for through the llListen api.
+
+ Channel to use to say text on
+
+ Text to say
+
+
+
+ llScaleTexture(float horizontal, float vertical, integer side);
+
+ Sets the horizontal and vertical repeats per face on side.
+ If side == ALL_SIDES, all sides are set in one call.
+ Negative values for horizontal and vertical will flip the texture.
+
+
+
+ integer llScriptDanger(vector pos);
+
+ Returns true if pos is over public land, land that doesn't allow everyone
+ to edit and build, or land that doesn't allow outside scripts.
+
+
+
+ void llScriptProfiler(integer iState);
+
+ Enables or disables the scripts profiling state.
+ PROFILE_NONE or PROFILE_SCRIPT_MEMORY flags to control the state.
+
+
key llSendRemoteData(key channel, string dest, integer idata, string sdata);
@@ -2383,131 +2375,79 @@
through channel with payload of channel (in a string),
integer idata and string sdata.
+
+
+ llSensor(string name, key id, integer type, float range, float arc);
+
+ Performs a single scan for name and id with type within
+ range meters and arc radians of forward vector.
+ Specifying a blank name or NULL_KEY id will not filter
+ results for any particular name or id A range of 0.0
+ does not perform a scan. The type parameter should be an
+ object type constant vlaue.
+
+
+
+ llSensorRemove(void);
+
+ Removes the sensor.
+
+
+
+ llSensorRepeat(string name, key id, integer type, float range, float arc, float rate);
+
+ Performs a repeating sensor scan for name and id with type
+ (AGENT, ACTIVE, PASSIVE, and/or SCRIPTED) within range meters and arc
+ radians of forward vector (name and/or id can be empty or 0).
+ A range of 0.0m does perform a scan. The parameters have the same
+ function as llSensor, except rate, which defines the number of
+ seconds between repeated sensor or no_sensor event calls.
+
+
+
+ llSetAlpha(float alpha, integer face);
+
+ Sets the alpha value for face. If face is ALL_SIDES,
+ set the alpha to all faces. The alpha value is interpreted
+ as an opacity percentage -1.0 is fully opaque, and 0.2 is
+ mostly transparent. This api will clamp alpha values
+ less 0.1 to .1 and greater than 1.0 to 1.
+
+
+
+ void llSetAngularVelocity(vector vForce, integer iLocal);
+
+ Applies angular (rotational) velocity to a physical object.
+ The force to apply.
+ If TRUE, the vForce is treated as a local directional vector instead of a regional directional vector.
+
+
+
+ llSetBuoyancy(float buoyancy);
+
+ Set the object buoyancy. A value of 0 is none,
+ less than 1.0 sinks, 1.0 floats, and greater than 1.0 rises.
+
+
+
+ llSetCameraAtOffset(vector offset);
+
+ Sets the camera at offset used in this object
+ if an avatar sits on it.
+
+
+
+ llSetCameraEyeOffset(vector offset);
+
+ Sets the camera eye offset used in this object if an avatar sits on it.
+
+
llSetCameraParams(list rules);
Sets multiple camera parameters at once.
List format is [rule1, value1, rule2, value2 . . . ruleN, valueN]
-
- llSetLinkAlpha(integer linknumber, float alpha, integer face);
-
- Sets the side number face on the linked child linknumber
- to the transparency alpha.
-
-
- llSetLocalRot(rotation rot);
-
- Sets the rotation of a child prim relative to the root prim.
-
-
-
- integer llSetPrimMediaParams( integer face, list params );
-
- Set the media params for a particular face.
-
- Returns an integer that is a STATUS_* flag which details the success/failure of the operation(s).
- face number
- a set of name/value pairs (in no particular order)
-
-
-
- llSetObjectDesc(string name);
-
- Sets the description of the scripted prim to name.
- You can get the description using llGetObjectDesc.
- The description is limited to 127 characters.
-
-
- llSetParcelMusicURL(string url)
-
- Sets the streaming audio URL for the parcel the
- scripted object is on (the object must be owned
- by the owner of the parcel, if the parcel is group
- owned the object must be owned by that group).
-
-
- llSetPayPrice(integer price, list quick_pay_buttons);
-
- Sets the values of the buttons and the text box default
- for the Pay dialog -- when a user right-clicks on
- the object and selects "Pay", llSetPayPrice will affect
- what buttons exist, what their values are, and whether
- or not there is a manual payment text entry box.
-
-
- llSetPrimitiveParams(list rule);
-
- This function changes the many properties (or "parameters")
- of a prim in one operation. The parameter is a list of changes.
- (Don't confuse prim parameters with function parameters.)
-
-
- llSetRemoteScriptAccessPin(integer pin);
-
- If pin is set to a non-zero number, the task will accept
- remote script loads via llRemoteLoadScriptPin
- if passed the matching PIN.
- Otherwise llRemoteLoadScriptPin is ignored
-
-
- string llStringToBase64(string str);
-
- Converts a string to the Base 64 representation of the string.
-
-
- string llUnescapeURL(string url);
-
- Returns the string that is the URL unescaped version
- of url, replacing "%20" with spaces, etc.
- The function can output raw UTF-8 strings.
-
-
- string llXorBase64StringsCorrect(string s1, string s2)
-
- Performs an xor on two Base64 strings and returns a Base64 string.
- s2 repeats if it is shorter than s1.
- This function is for encrypting data. Put your data in s1 and
- your key in s2 to encrypt or put the encrypted data into s1
- with the same key in s2 to decrypt again.
-
-
-
- llSetSoundRadius(float radius);
-
- Establishes a hard cut-off radius for audibility of scripted
- sounds (both attached and triggered)
-
-
-
- list llGetObjectDetails(key id, list params);
-
- Returns a list of the details specified in params for the object with key id.
-
- prim or avatar UUID that is in the same region
-
-
- list of OBJECT_* flags
-
-
llSetClickAction(integer action);
@@ -2518,10 +2458,569 @@
-
- integer llGetRegionAgentCount();
+
+ llSetColor(vector color, integer face);
- Returns an integer that is the number of avatars in the region.
+ Sets the color of face. If face is ALL_SIDES, set the color to all faces.
+
+
+
+ llSetDamage(float damage);
+
+ Sets the amount of damage that will be done to an object
+ that this object hits. This object will be destoyed on
+ damaging another object.
+
+
+
+ llSetForce(vector force, integer local);
+
+ If the object is physical, this function sets the force.
+ The vector is in local coordinates if local is TRUE, global if
+ FALSE.
+
+ directional force
+
+
+ boolean, if TRUE uses local axis, if FALSE uses region axis.
+
+
+
+
+ llSetForceAndTorque(vector force, vector torque, integer local);
+
+ If the object is physical, this function sets the force and
+ torque. The vectors are in loal coordinates if local is
+ TRUE, global if FALSE.
+
+ directional force
+
+
+ torque force
+
+
+ boolean, if TRUE uses local axis, if FALSE uses region axis.
+
+
+
+
+ llSetHoverHeight(float height, float water, float tau);
+
+ Critically damps to a height. The height is above ground
+ and water if water is TRUE. Only works with physics-enabled objects.
+ Do not use with vehicles. Use llStopHover to stop hovering.
+
+ Distance above the ground
+
+
+ boolean, if TRUE then hover above water too.
+
+
+ seconds to critically damp in
+
+
+
+
+ llSetKeyframedMotion(list lKeyframes, list lOptions);
+
+ Specify a list of times, positions, and orientations to be followed by an object. The object will be smoothly moved between key-frames by the simulator. Collisions with other nonphysical or keyframed objects will be ignored (no script events will fire and collision processing will not occur). Collisions with physical objects will be computed and reported, but the keyframed object will be unaffected by those collisions.
+ Strided keyframe list of the form: position, orientation, time. Each keyframe is interpreted relative to the previous transform of the object.
+
+
+
+
+
+
+ llSetLinkAlpha(integer linknumber, float alpha, integer face);
+
+ Sets the side number face on the linked child linknumber
+ to the transparency alpha.
+
+
+
+ llSetLinkColor(integer linknumber, vector color, integer face);
+
+ Sets the color of the linked child specified by linknumber.
+ A value of 0 means no link, 1 the root, 2 for first
+ child, etc. If linknumber is ALL_SIDES, set the color
+ of all objects in the linked set. If face is
+ ALL_SIDES, set the color of all faces.
+
+
+
+ integer llSetLinkMedia(integer iLink, integer iFace, list lParameters);
+
+ Set the media parameters for a particular face on the linked prim(s) without a delay.
+ Link number (0: unlinked, 1: root prim, >1: child prims).
+ Face number.
+ A set of name/value pairs (in no particular order)
+ Returns an integer that is a STATUS_* flag which details the success/failure of the operation(s).
+
+
+
+ void llSetLinkPrimitiveParams(integer linknumber, list rules);
+
+ Sets the parameters (or properties) of any linked prim in none step
+ Link number (0: unlinked, 1: root prim, >1: child prims) or a LINK_* flag
+
+
+
+
+ llSetLinkPrimitiveParamsFast( integer linknumber, list rules );
+
+ Set primitive parameters for linknumber based on rules with no built-in script sleep. This function is identical to llSetLinkPrimitiveParams except without the delay.
+ Link number (0: unlinked, 1: root prim, >1: child prims) or a LINK_* flag
+
+
+
+
+ void llSetLinkTexture(integer linknumber, string texture, integer face);
+
+ Sets the texture of linked prims
+
+
+
+ llSetLinkTextureAnim( integer link, integer mode, integer face, integer sizex, integer sizey, float start, float length, float rate );
+
+ Animate the texture on the specified face/faces of the
+ specified prim/prims by setting the texture scale and offset.
+ Identical to llSetTextureAnim except able to modify any prim in the link set.
+
+ Link number (0: unlinked, 1: root prim, >1: child prims) or a LINK_* flag to effect
+ mask of Mode flags
+ face number or ALL_SIDES
+ horizontal frames (ignored for ROTATE and SCALE)
+ vertical frames (ignored for ROTATE and SCALE)
+ Start position/frame number (or radians for ROTATE)
+ number of frames to display (or radians for ROTATE)
+ frames per second (must not be zero)
+
+
+
+ llSetLocalRot(rotation rot);
+
+ Sets the rotation of a child prim relative to the root prim.
+
+
+
+ integer llSetMemoryLimit(integer iLimit);
+
+ Request iLimit bytes to be reserved for this script. This function has no effect if the script is running in the LSO VM.
+ Return TRUE or FALSE indicating whether the limit was set successfully.
+ The amount to reserve, which must be less than the allowed maximum (currently 64KB) and not already have been exceeded.
+
+
+
+ llSetObjectDesc(string name);
+
+ Sets the description of the scripted prim to name.
+ You can get the description using llGetObjectDesc.
+ The description is limited to 127 characters.
+
+
+
+ llSetObjectName(string name);
+
+ Sets the object name to name.
+
+
+
+ llSetParcelMusicURL(string url)
+
+ Sets the streaming audio URL for the parcel the
+ scripted object is on (the object must be owned
+ by the owner of the parcel, if the parcel is group
+ owned the object must be owned by that group).
+
+
+
+ llSetPayPrice(integer price, list quick_pay_buttons);
+
+ Sets the values of the buttons and the text box default
+ for the Pay dialog -- when a user right-clicks on
+ the object and selects "Pay", llSetPayPrice will affect
+ what buttons exist, what their values are, and whether
+ or not there is a manual payment text entry box.
+
+
+
+ void llSetPhysicsMaterial(integer MaterialBits, float GravityMultiplier, float Restitution, float Friction, float Density);
+
+ No description available.
+
+
+
+ llSetPos(vector pos);
+
+ If the object is not physical, this function sets the position
+ in region coordinates. If the object is a child, the
+ position is treated as root relative and the linked set is adjusted.
+
+
+
+ integer llSetPrimMediaParams( integer face, list params );
+
+ Set the media params for a particular face.
+
+ Returns an integer that is a STATUS_* flag which details the success/failure of the operation(s).
+ face number
+ a set of name/value pairs (in no particular order)
+
+
+
+ llSetPrimitiveParams(list rule);
+
+ This function changes the many properties (or "parameters")
+ of a prim in one operation. The parameter is a list of changes.
+ (Don't confuse prim parameters with function parameters.)
+
+
+
+ llSetRemoteScriptAccessPin(integer pin);
+
+ If pin is set to a non-zero number, the task will accept
+ remote script loads via llRemoteLoadScriptPin
+ if passed the matching PIN.
+ Otherwise llRemoteLoadScriptPin is ignored
+
+
+
+ llSetRot(rotation rot);
+
+ If the object is not physical, this function sets the rotation.
+ If the object is a child, the position is treated as root
+ relative and the linked set is adjusted.
+
+
+
+ llSetScale(vector scale);
+
+ Sets the object scale.
+
+
+
+ llSetScriptState(string name, integer run);
+
+ Control the state of a script on the object.
+
+
+
+ llSetSitText(string text);
+
+ Displays text rather than sit in viewer pie menu.
+
+
+
+ llSetSoundQueueing(integer queue);
+
+ Sets whether successive calls to llPlaySound, llLoopSound,
+ etc., (attached sounds) interrupt the playing sound.
+ The default for objects is FALSE. Setting this value to
+ TRUE will make the sound wait until the current playing
+ sound reaches its end. The queue is one level deep.
+
+ boolean, sound queuing: TRUE enables, FALSE disables (default)
+
+
+
+
+ llSetSoundRadius(float radius);
+
+ Establishes a hard cut-off radius for audibility of scripted
+ sounds (both attached and triggered)
+
+
+
+ llSetStatus(integer status, integer value);
+
+ Sets the status to value. Use status constants for the values of status.
+
+
+
+ llSetText(string text, vector color, float alpha);
+
+ Sets text that floats above object to text,
+ using the specified color and alpha.
+
+
+
+ llSetTexture(string texture, integer face);
+
+ Sets the texture from object inventory of face.
+ If face is ALL_SIDES, set the texture to all faces.
+
+
+
+ llSetTextureAnim(integer mode, integer face, integer sizex, integer sizey, float start, float length, float rate);
+
+ Animates a texture by setting the texture scale and offset.
+ mask of Mode flags
+ face number or ALL_SIDES
+ horizontal frames (ignored for ROTATE and SCALE)
+ vertical frames (ignored for ROTATE and SCALE)
+ Start position/frame number (or radians for ROTATE)
+ number of frames to display (or radians for ROTATE)
+ frames per second (must not be zero)
+
+
+
+ llSetTimerEvent(float sec);
+
+ Sets the timer event to be triggered every sec seconds.
+ Passing in 0.0 stops further timer events.
+
+
+
+ llSetTorque(vector torque, integer local);
+
+ If the object is physical, this function sets the torque.
+ The vector is in local coordinates if local is TRUE, global
+ if FALSE.
+
+ torque force
+
+
+ boolean, if TRUE uses local axis, if FALSE uses region axis.
+
+
+
+
+ llSetTouchText(string text);
+
+ Displays text in viewer pie menu that acts as a touch.
+
+
+
+ llSetVehicleFlags(integer flags);
+
+ Sets the vehicle flags to TRUE.
+ Valid parameters can be found in the vehicle flags constants section.
+
+
+
+ llSetVehicleFloatParam(integer param_name, float param_value);
+
+ Sets the vehicle floating point parameter param_name to param_value.
+ Valid parameters and their expected
+ values can be found in the vehicle parameter constants section.
+
+
+
+ llSetVehicleType(integer type);
+
+ Activates the vehicle action and choose vehicle type.
+ Valid types and an explination of their characteristeics
+ can be found in the vehicle type constants section.
+
+
+
+ llSetVehicleRotationParam(integer param_name, rotation param_value);
+
+ Sets the vehicle rotation parameter param_name to param_value.
+ Valid parameters can be found in the
+ vehicle parameter constants section.
+
+
+
+ llSetVehicleVectorParam(integer param_name, vector param_value);
+
+ Sets the vehicle vector parameter param_name to param_value.
+ Valid parameters can be found in the
+ vehicle parameter constants section.
+
+
+
+ void llSetVelocity(vector vForce, integer iLocal);
+
+ Applies velocity to a physical object.
+ The force to apply.
+ If TRUE, the vForce is treated as a local directional vector instead of a regional directional vector.
+
+
+
+ string llSHA1String( string src );
+
+ *** Pre-release Documentation Warning ***
+ Returns a string of 40 hex characters that is the SHA1 security hash of src.
+
+
+
+ llShout(integer channel, string text);
+
+ Shout text on channel. Channel 0 is the public chat channel that
+ all avatars see as chat text. Channels 1 to
+ 2,147,483,648 are private channels that are not sent to
+ avatars but other scripts can listen for through the llListen api.
+
+
+
+ float llSin(float theta);
+
+ Returns the sine of theta in radians.
+
+
+
+ llSitTarget(vector offset, rotation rot);
+
+ Set the sit location for this object. If offset == ZERO_VECTOR
+ clear the sit target.
+
+
+
+ llSleep(float sec);
+
+ Puts the script to sleep for sec seconds.
+
+
+
+ float llSqrt(float val);
+
+ Returns the square root of val. If val is less than 0.0,
+ this function returns 0.0 and raises a math runtime error.
+
+
+
+ llStartAnimation(string anim);
+
+ This function starts animation anim for the avatar that owns the object.
+
+
+
+ llStopAnimation(string anim);
+
+ Stop animation animfor avatar that owns object.
+
+
+
+ llStopHover(void);
+
+ Stop hover to a height.
+
+
+
+ llStopLookAt(void);
+
+ Stop causing object to look at target.
+
+
+
+ llStopMoveToTarget(void);
+
+ Stops critically damped motion.
+
+
+
+
+
+ llStopSound(void);
+
+ Stops a currently playing attached sound started with
+ llPlaySound or llLoopSound. Has no effect on sounds
+ started with llTriggerSound.
+
+
+
+ integer llStringLength(string src);
+
+ Returns the number of characters in src.
+
+
+
+ string llStringToBase64(string str);
+
+ Converts a string to the Base 64 representation of the string.
+
+
+
+ string llStringTrim(string text, integer trim_type);
+
+ Outputs a string eliminating whitespace from the start and/or end of the specified string.
+
+ Constants for trim_type:
+ STRING_TRIM_HEAD: trim all leading spaces in text
+ STRING_TRIM_TAIL: trim all trailing spaces in text
+ STRING_TRIM: trim all leading and trailing spaces in text
+ string to trim
+
+ STRING_TRIM_HEAD,STRING_TRIM_TAIL or STRING_TRIM
+
+
+
+
+ integer llSubStringIndex(string source, string pattern);
+
+ Finds index in source where pattern first appears.
+ Returns -1 if no match is found found.
+
+
+
+ llTakeControls(integer controls, integer accept, integer pass_on);
+
+ If ( accept == (controls and input) ), send input to object.
+ If the boolean pass_on is TRUE, also send input
+ to avatar. Requires the PERMISSION_TAKE_CONTROLS permission to run.
+
+ bitfield of CONTROL_* flags
+
+
+ boolean, determines whether control events are generated
+
+
+ boolean, determines whether controls are disabled
+
+
+
+
+ float llTan(float theta);
+
+ Returns the tangent of theta radians.
+
+
+
+
+
+ integer llTarget(vector position, float range);
+
+ Set object position within range of position as a target
+ and returns an integer ID for the target.
+
+
+
+ llTargetOmega(vector axis, float spinrate, float gain);
+
+ Attempt to spin at spinrate with strength gain on axis.
+ A spinrate of 0.0 cancels the spin. This
+ function always works in object local coordinates.
+
+
+
+ llTargetRemove(integer tnumber);
+
+ Remove target number tnumber.
+
+
+
+ llTeleportAgentHome(key id);
+
+ Teleport agent on the owner's land to agent's home location.
@@ -2533,185 +3032,144 @@
is said on chat_channel when the "OK" button is clicked.
-
- string llGetAgentLanguage( key avatar );
+
+ string llToLower(string src);
- Returns a string that is the language code of the preferred
- interface language of the user avatar.
+ Returns src in all lower case.
-
- vector llDetectedTouchUV( integer index );
+
+ string llToUpper(string src);
- Returns a vector that is the texture coordinates for where
- the prim was touched. The x and y vector positions contain
- the u and v face coordinates respectively.
+ Returns src in all upper case.
+
- TOUCH_INVALID_TEXCOORD is returned
- when the touch UV coordinates cannot be determined.
-
- Index of detection information
+
+ key llTransferLindenDollars(key AvatarID, integer Amount);
+
+ Attempts to send the amount of money to the specified avatar, and trigger a transaction_result event identified by the returned key.
+
+
+
+ llTriggerSound(string sound, float volume);
+
+ Plays a transient sound NOT attached to an object.
+ The sound plays from a stationary position located at the
+ center of the object at the time of the trigger.
+ There is no limit to the number of triggered sounds which can be
+ generated by an object, and calling llTriggerSound does not affect
+ the attached sounds created by llPlaySound
+ and llLoopSound. This is very useful for things like collision noises,
+ explosions, etc. There is no way to stop or
+ alter the volume of a sound triggered by this function.
+
+
+
+ llTriggerSoundLimited(string sound, float volume, vector tne, vector bsw);
+
+ Plays a transient sound NOT attached to an object with its
+ audible range limited by the axis aligned bounding
+ box define by tne(top-north-eash) and bsw (bottom-south-west).
+ The sound plays from a stationary position
+ located at the center of the object at the time of the trigger.
+ There is no limit to the number of triggered sounds
+ which can be generated by an object, and calling llTriggerSound
+ does not affect the attached sounds created by
+ llPlaySound and llLoopSound. This is very useful for things
+ like collision noises, explosions, etc. There is no
+ way to stop or alter the volume of a sound triggered by this function.
+
+
+
+ string llUnescapeURL(string url);
+
+ Returns the string that is the URL unescaped version
+ of url, replacing "%20" with spaces, etc.
+ The function can output raw UTF-8 strings.
+
+
+
+ llUnSit(key id);
+
+ If agent identified by id is sitting on the object the script
+ is attached to or is over land owned by the objects
+ owner, the agent is forced to stand up.
+
+
+
+ float llVecDist(vector a, vector b);
+
+ Returns the distance from ato b
+
+
+
+ float llVecMag(vector vec);
+
+ Returns the magnitude of vec.
+
+
+
+ vector llVecNorm(vector vec);
+
+ Returns normalized vec.
+
+
+
+ llVolumeDetect(integer detect);
+
+ When detect = TRUE, this makes the entire link set the script
+ is attached to phantom but if another object
+ interpenetrates it, it will get a collision_start event.
+ When an object stops interpenetrating, a collision_end event
+ is generated. While the other is interpenetrating,
+ collision events are NOT generated. The script must be applied
+ to the root object of the link set to get the collision events.
+ Collision filters work normally.
+
+ TRUE enables, FALSE disables
-
- integer llDetectedTouchFace( integer index );
+
+ float llWater(vector offset);
- Returns an integer that is the index of the face the avatar clicked on.
-
- Index of detection information
-
+ Returns the water height at the object position + offset.
-
- vector llDetectedTouchPos( integer index );
+
+ llWhisper(integer channel, string text);
- Returns a vector that is the position where the object
- was touched in region coordinates, unless it is attached to
- the HUD, in which case it returns the position relative
- to the attach point.
-
- Index of detection information
-
+ Whisper text on channel. Channel 0 is the public chat channel that
+ all avatars see as chat text. Channels 1 to 2,147,483,648 are
+ private channels that are not sent to avatars but other scripts
+ can listen for through the llListen api.
-
- vector llDetectedTouchNormal( integer index );
+
+ vector llWind(vector offset);
- Returns a vector that is the surface normal
- (perpendicular to the surface) where the touch event was triggered.
-
- Index of detection information
-
+ Returns the wind velocity below the object position + offset.
-
- vector llDetectedTouchBinormal( integer index );
+
+ string llXorBase64StringsCorrect(string s1, string s2)
- Returns a vector that is the surface binormal
- (tangent to the surface) where the touch event was triggered.
-
- Index of detection information
-
+ Performs an xor on two Base64 strings and returns a Base64 string.
+ s2 repeats if it is shorter than s1.
+ This function is for encrypting data. Put your data in s1 and
+ your key in s2 to encrypt or put the encrypted data into s1
+ with the same key in s2 to decrypt again.
-
- vector llDetectedTouchST( integer index );
+
+ llSetObjectPermMask(integer mask, integer value);
- Returns a vector that is the surface coordinates for where the prim was touched.
- The x and y vector positions contain the horizontal (s) and vertical (t) face
- coordinates respectively.
- Each component is in the interval [0.0, 1.0].
-
- TOUCH_INVALID_TEXCOORD is returned when the surface coordinates cannot be determined.
-
- Index of detection information
-
-
-
-
- string llSHA1String( string src );
-
- *** Pre-release Documentation Warning ***
- Returns a string of 40 hex characters that is the SHA1 security hash of src.
-
-
-
- integer llGetFreeURLs( );
-
- Returns an integer that is the number of available URLs.
-
-
- key llRequestURL( );
-
- Requests one HTTP:// url for use by this script. The http_request event is triggered with the result of the request.
-
- Returns a key that is the handle used for identifying the result in the http_request event.
-
-
- key llRequestSecureURL( );
-
- Requests one HTTPS:// (SSL) url for use by this object. The http_request event is tiggered with results.
-
- Returns a key that is the handle used for identifying the request in the http_request event.
-
-
- llReleaseURL( string url );
-
- Releases the specified URL, it will no longer be usable.
- URL to release
-
-
- void llHTTPResponse( key request_id, integer status, string body );
-
- Responds to request_id with status and body.
- A valid HTTP request key
- HTTP Status (200, 400, 404, etc)
- Contents of the response
-
-
- string llGetHTTPHeader( key request_id, string header );
-
- Returns a string that is the value for header for request_id.
- A valid HTTP request key
- Header value name
-
-
- integer LlGetSPMaxMemory( );
-
- Returns the integer of the most bytes used while llScriptProfiler was last active.
-
-
- string llGetEnv( string name );
-
- Returns a string with the requested data about the region.
- • string name – The name of the data to request
- Table of valid name values. Name ↓ Description
- "sim_channel" Get the current region's channel string, for example "Second Life Server"
- "sim_version" Get the current region's version number string, for example "10.11.30.215699"
-
-
- integer llGetUsedMemory( );
-
- Returns the integer of the number of bytes of memory currently in use by the script.
-
-
- string llGetUsername( key id );
-
- Returns a string that is the unique username of the avatar specified by id.
- • key id – avatar UUID that is in the same region or is otherwise known to the region
-
- id must specify a valid avatar key, present in or otherwise known to the sim in which the script is running,
- otherwise an empty string is returned. This function will still return a valid username if the avatar is a child agent
- of the sim (i.e., in an adjacent sim, but presently able to see into the one the script is in), or for a short period
- after the avatar leaves the sim (specifically, when the client completely disconnects from the sim, either as a main
- or child agent).
-
-
- llRegionSayTo( key target, integer channel, string msg );
-
- Says the text supplied in string msg on channel supplied in integer channel to the object or avatar specified by target
- • key target
- • integer channel – output channel, any integer value
- • string msg – message to be transmitted
-
-
- key llRequestDisplayName( key id );
-
- Requests the Display Name of the agent identified by id. When the Display Name is available the dataserver event will be raised.
- The agent identified by id does not need to be in the same region or online at the time of the request.
- Returns the key that is used to identify the dataserver event when it is raised.
- • key id – avatar UUID
-
-
- key llRequestUsername( key id );
-
- Requests the Username of the agent identified by id. When Username is available the dataserver event will be raised.
- The agent identified by id does not need to be in the same region or online at the time of the request.
- Returns a key that is used to identify the dataserver event when it is raised.
- • key id – avatar UUID
+ Sets the given permission mask to the new value on the root object
+ the task is attached to.
+
+
Every state must have at least one handler. You can choose to
handle an event by defining one of the the reserved
@@ -2727,7 +3185,7 @@
at_rot_target(integer number, rotation target_rotation, rotation our_rotation);
- This event is triggered when a script comes within a defined
+ This event is triggered when a script comes within a defined
angle of a target rotation. The range is set by a call
to llRotTarget.
@@ -2745,203 +3203,229 @@
When a target is set via the llTarget library call,
but the script is outside the specified range this event is raised.
+
attach(key attached);
- This event is triggered whenever a object with this script is
+ This event is triggered whenever a object with this script is
attached or detached from an avatar. If it is attached,
- attached is the key of the avatar it is attached to, otherwise
+ attached is the key of the avatar it is attached to, otherwise
attached is NULL_KEY.
+
changed(integer change);
- Triggered when various events change the object. The change
+ Triggered when various events change the object. The change
argument will be a bitfield of change constants.
+
collision(integer total_number);
- This event is raised while another object is colliding with
+ This event is raised while another object is colliding with
the object the script is attached to. The number of
- detected objects is passed to the script. Information on
+ detected objects is passed to the script. Information on
those objects may be gathered via the llDetected* library
- functions.
+ functions.
(Collisions are also generated if a user walks into an object.)
+
collision_end(integer total_number);
- This event is raised when another object stops colliding with
+ This event is raised when another object stops colliding with
the object the script is attached to. The number of
- detected objects is passed to the script. Information on those
+ detected objects is passed to the script. Information on those
objects may be gathered via the llDetected* library
- functions.
+ functions.
(Collisions are also generated if a user walks into an object.)
+
collision_start(integer total_number);
- This event is raised when another object begins to collide with
+ This event is raised when another object begins to collide with
the object the script is attached to. The number of
- detected objects is passed to the script. Information on
+ detected objects is passed to the script. Information on
those objects may be gathered via the llDetected* library
- functions.
+ functions.
(Collisions are also generated if a user walks into an object.)
+
control(key name, integer levels, integer edges);
- Once a script has the ability to grab control inputs from the avatar,
+ Once a script has the ability to grab control inputs from the avatar,
this event will be used to pass the commands
- into the script. The levelsand edgesare bitfields
+ into the script. The levelsand edgesare bitfields
of control constsants.
+
dataserver(key requested, string data);
- This event is triggered when the requested data is returned
+ This event is triggered when the requested data is returned
to the script. Data may be requested by the
- llRequestAgentData, the llRequestInventoryData,
+ llRequestAgentData, the llRequestInventoryData,
and the llGetNotecardLine function calls.
+
email(string time, string address, string subject, string body, integer remaining);
- This event is triggered when an email sent to this script arrives.
+ This event is triggered when an email sent to this script arrives.
The remaining tells how many more emails are known as still pending.
+
land_collision(vector position);
- This event is raised when the object the script is attached
+ This event is raised when the object the script is attached
to is colliding with the ground.
+
land_collision_end(vector position);
- This event is raised when the object the script is attached
+ This event is raised when the object the script is attached
to stops colliding with the ground.
+
land_collision_start(vector position);
- This event is raised when the object the script is attached
+ This event is raised when the object the script is attached
to begins to collide with the ground.
+
link_message(integer sender_number, integer number, string message, key id);
Triggered when object receives a link message via llMessageLinked
library function call.
+
listen(integer channel, string name, key id, string message);
- This event is raised whenever a chat message matching the
+ This event is raised whenever a chat message matching the
constraints passed in the llListen command is heard.
- The nameand id of the speaker as well as the messageare passed
+ The nameand id of the speaker as well as the messageare passed
in as parameters. Channel 0 is the public
- chat channel that all avatars see as chat text.
+ chat channel that all avatars see as chat text.
Channels 1 through 2,147,483,648 are private channels that are not
sent to avatars but other scripts can listen on those channels.
+
money(key giver, integer amount);
- This event is triggered when user giver has given an amount
+ This event is triggered when user giver has given an amount
of Linden dollars to the object.
+
moving_end(void);
Triggered whenever a object with this script stops moving.
+
moving_start(void);
Triggered whenever a object with this script starts moving.
+
no_sensor(void);
- This event is raised when sensors are active
+ This event is raised when sensors are active
(via the llSensor library call) but are not sensing anything.
object_rez(key id);
- Triggered when object rez-es in another object from its
+ Triggered when object rez-es in another object from its
inventory via the llRezObject api. The id is the globally
unique key for the object.
+
on_rez(integer start_param);
- Triggered whenever a object is rez-ed from inventory
+ Triggered whenever a object is rez-ed from inventory
or by another object. The start_paramis the parameter
passed in from the call to llRezObject.
+
run_time_permissions(integer permissions);
- Scripts need permission from either the owner or the avatar
+ Scripts need permission from either the owner or the avatar
they wish to act on before they perform certain
- functions, such as debiting money from their owners account,
+ functions, such as debiting money from their owners account,
triggering an animation on an avatar, or capturing
- control inputs. The llRequestPermissions library
+ control inputs. The llRequestPermissions library
function is used to request these permissions and the various
- permissions integer constants can be supplied.
+ permissions integer constants can be supplied.
The integer returned to this event handler contains the current set
of permissions flags, so if permissionseqal 0 then no permissions are set.
+
sensor(integer total_number);
- This event is raised whenever objects matching the constraints
- of the llSensor command are detected.
- The number of detected objects is passed to the script
+ This event is raised whenever objects matching the constraints
+ of the llSensor command are detected.
+ The number of detected objects is passed to the script
in the total_number parameter. Information on those
objects may be gathered via the llDetected* library functions.
+
state_entry(void);
The state_entry event occurs whenever a new state is entered,
including program start, and is always the first event handled.
+
state_exit(void);
- The state_exit event occurs whenever the state command
+ The state_exit event occurs whenever the state command
is used to transition to another state. It is handled
before the new states state_entry event.
+
timer(void);
- This event is raised at regular intervals set by the
+ This event is raised at regular intervals set by the
llSetTimerEvent library function.
+
touch(integer total_number);
- This event is raised while a user is touching the object
+ This event is raised while a user is touching the object
the script is attached to. The number of touching objects is
- passed to the script in the total_number parameter.
+ passed to the script in the total_number parameter.
Information on those objects may be gathered via the
llDetected* library functions.
+
touch_end(integer total_number);
- This event is raised when a user stops touching the object
+ This event is raised when a user stops touching the object
the script is attached to. The number of touching
- objects is passed to the script in the total_number parameter.
+ objects is passed to the script in the total_number parameter.
Information on those objects may be gathered
via the llDetected* library functions.
+
touch_start(integer total_number);
@@ -2950,6 +3434,7 @@
the total_number parameter. Information on those objects may be gathered
via the llDetected() library functions.
+
http_request(key request_id, string method, string body);
@@ -2958,24 +3443,28 @@
GET, POST, PUT
Contents of the request.
+
http_response(key request_id, integer status, list metadata, string body);
- This event handler is invoked when an HTTP response is received for
+ This event handler is invoked when an HTTP response is received for
a pending llHTTPRequest request or if a pending request fails or times out.
+
remote_data(integer event_type, key channel, key message_id, string sender, integer idata, string sdata);
Triggered by various XML-RPC calls with event_type specifying the type of data.
+
+
To ease scripting, many useful constants are defined by LSL.
- The boolean constants represent the values for TRUE and FALSE.
+ The boolean constants represent the values for TRUE and FALSE.
LSL represents booleans as integer values 1
- and 0 respectively. Since there is no boolean type these
+ and 0 respectively. Since there is no boolean type these
constants act as a scripting aid usually employed for
testing variables which conceptually represent boolean values.
@@ -2986,64 +3475,64 @@
- The status constants are used in the llSetStatus and llGetStatus
+ The status constants are used in the llSetStatus and llGetStatus
library calls. These constants can be bitwise ORed
- together when calling the library functions to set the same
+ together when calling the library functions to set the same
value to more than one status flag
Status Constants
- Controls whether the object moves physically.
+ Controls whether the object moves physically.
This controls the same flag that the ui checkbox for
Physical controls. The default is FALSE.
- Controls whether the object collides or not.
+ Controls whether the object collides or not.
Setting the value to TRUE makes the object non-colliding with
- all objects. It is a good idea to use this for most objects
+ all objects. It is a good idea to use this for most objects
that move or rotate, but are non-physical. It is also
useful for simulating volumetric lighting. The default is FALSE.
- Controls whether the object can physically rotate around
+ Controls whether the object can physically rotate around
the specific axis or not. This flag has no meaning
- for non-physical objects. Set the value to FALSE
+ for non-physical objects. Set the value to FALSE
if you want to disable rotation around that axis. The
default is TRUE for a physical object.
- A useful example to think about when visualizing
+ A useful example to think about when visualizing
the effect is a sit-and-spin device. They spin around the
Z axis (up) but not around the X or Y axis.
- Controls whether the object can be grabbed.
+ Controls whether the object can be grabbed.
A grab is the default action when in third person, and is
- available as the hand tool in build mode.
+ available as the hand tool in build mode.
This is useful for physical objects that you dont want other
- people to be able to trivially disturb.
+ people to be able to trivially disturb.
The default if FALSE
- Controls whether the object can cross region boundaries
+ Controls whether the object can cross region boundaries
and move more than 20 meters from its creation
point. The default if FALSE.
- Controls whether the object is returned to the owners
+ Controls whether the object is returned to the owners
inventory if it wanders off the edge of the world. It is
- useful to set this status TRUE for things like bullets
+ useful to set this status TRUE for things like bullets
or rockets. The default is TRUE
- These constants can be combined using the binary | operator
+ These constants can be combined using the binary | operator
and are used in the llSensor and related calls.
Object Type Constants
Objects in world that are agents.
- Objects in world that are running a script or
+ Objects in world that are running a script or
currently pysically moving.
@@ -3054,40 +3543,40 @@
- The permission constants are used for passing values
+ The permission constants are used for passing values
to llRequestPermissions, determing the value of
- llGetPermissions, and explicitly passed to the
+ llGetPermissions, and explicitly passed to the
run_time_permissions event. For many of the basic library
- functions to work, a specific permission must be enabled.
+ functions to work, a specific permission must be enabled.
The permission constants can be ored together to be
used in conjunction.
Permission Constants
- If this permission is enabled, the object can successfully
+ If this permission is enabled, the object can successfully
call llGiveMoney to debit the owners account.
- If this permission enabled, the object can successfully
+ If this permission enabled, the object can successfully
call the llTakeControls libray call.
(not yet implemented)
- If this permission is enabled, the object can successfully
+ If this permission is enabled, the object can successfully
call llStartAnimation for the avatar that owns this
object.
- If this permission is enabled, the object can successfully
+ If this permission is enabled, the object can successfully
call llAttachToAvatar to attach to the given avatar.
(not yet implemented)
- If this permission is enabled, the object can successfully
+ If this permission is enabled, the object can successfully
call llCreateLink, llBreakLink, and
llBreakAllLinks to change links to other objects.
@@ -3099,7 +3588,7 @@
- These constants can be used to refer to a specific inventory
+ These constants can be used to refer to a specific inventory
type in calls to llGetInventoryNumber
andllGetInventoryName.
Inventory Constants
@@ -3115,7 +3604,7 @@
- These constants are used to refer to attachment points
+ These constants are used to refer to attachment points
in calls to llAttachToAvatar.
Attachment Constants
@@ -3243,7 +3732,7 @@
- These constants are used in calls to llSetLinkColor and
+ These constants are used in calls to llSetLinkColor and
llMessageLinked.
Link Constants
@@ -3254,7 +3743,7 @@
This targets the root of the linked set.
- This targets every object in the linked set except
+ This targets every object in the linked set except
the object with the script.
@@ -3262,7 +3751,7 @@
- These constants are used in llTakeControls as well
+ These constants are used in llTakeControls as well
as the control event handler.
Control Constants
@@ -3303,7 +3792,7 @@
The object inventory has changed.
- The object inventory has changed because an item was
+ The object inventory has changed because an item was
added through the llAllowInventoryDrop interface.
@@ -3316,7 +3805,7 @@
The object scale has changed.
- The texture offset, scale rotation, or simply the object
+ The texture offset, scale rotation, or simply the object
texture has changed.
@@ -3324,9 +3813,9 @@
- These constants are used to determine the variable type
+ These constants are used to determine the variable type
stored in a heterogenous list. The value returned from
- llGetListEntryType can be used for comparison against
+ llGetListEntryType can be used for comparison against
these constants.
Type Constants
@@ -3352,9 +3841,9 @@
- Each of these constants represents a bit in the integer
+ Each of these constants represents a bit in the integer
returned from the llGetAgentInfo function and can be used
- in an expression to determine the specified information
+ in an expression to determine the specified information
about an agent.
Agent Info Constants
@@ -3368,7 +3857,7 @@
- These constants are used in the llSetTextureAnim api to
+ These constants are used in the llSetTextureAnim api to
control the animation mode.
Texture Animation Constants
@@ -3394,21 +3883,21 @@
- These constants are used in calls to the llParticleSystem
+ These constants are used in calls to the llParticleSystem
api to specify parameters.
Particle System Parameters
- Each particle that is emitted by the particle system is
+ Each particle that is emitted by the particle system is
simulated based on the following flags. To use
multiple flags, bitwise or (|) them together.
PSYS_PART_FLAGS Values
- Interpolate both the color and alpha from the start
+ Interpolate both the color and alpha from the start
value to the end value.
- Interpolate the particle scale from the start value
+ Interpolate the particle scale from the start value
to the end value.
@@ -3421,11 +3910,11 @@
The particle position is relative to the source objects position.
- The particle orientation is rotated so the vertical
+ The particle orientation is rotated so the vertical
axis faces towards the particle velocity.
- The particle heads towards the location of the target
+ The particle heads towards the location of the target
object as defined by PSYS_SRC_TARGET_KEY.
@@ -3441,7 +3930,7 @@
(not implemented)
- The pattern which is used to generate particles.
+ The pattern which is used to generate particles.
Use one of the following values:
PSYS_SRC_PATTERN Values
@@ -3449,49 +3938,49 @@
Drop particles at the source position.
- Shoot particles out in all directions,
+ Shoot particles out in all directions,
using the burst parameters.
- Shoot particles across a 2 dimensional area defined
+ Shoot particles across a 2 dimensional area defined
by the arc created from
- PSYS_SRC_OUTERANGLE.
+ PSYS_SRC_OUTERANGLE.
There will be an open area defined by PSYS_SRC_INNERANGLE
within the larger arc.
- Shoot particles out in a 3 dimensional cone with
+ Shoot particles out in a 3 dimensional cone with
an outer arc of PSYS_SRC_OUTERANGLE and an
inner open area defined by PSYS_SRC_INNERANGLE.
- a vector <r,g,b> which determines the starting
+ a vector <r,g,b> which determines the starting
color of the object.
a float which determines the starting alpha of the object.
- a vector <r, g, b> which determines the ending
+ a vector <r, g, b> which determines the ending
color of the object.
a float which determines the ending alpha of the object.
- a vector <sx, sy, z>,
- which is the starting size of the particle billboard
+ a vector <sx, sy, z>,
+ which is the starting size of the particle billboard
in meters (z is ignored).
- a vector <sx, sy, z>, which is the ending
+ a vector <sx, sy, z>, which is the ending
size of the particle billboard in meters (z is ignored).
age in seconds of a particle at which it dies.
- a vector <x, y, z> which is the acceleration
+ a vector <x, y, z> which is the acceleration
to apply on particles.
@@ -3501,16 +3990,16 @@
how often to release a particle burst (float seconds).
- specifies the inner angle of the arc created
+ specifies the inner angle of the arc created
by the PSYS_PART_SRC_PATTERN_ANGLE or
- PSYS_PART_SRC_PATTERN_ANGLE_CONE source pattern.
+ PSYS_PART_SRC_PATTERN_ANGLE_CONE source pattern.
The area specified will not have particles
in it..
- specifies the outer angle of the arc created
+ specifies the outer angle of the arc created
by the PSYS_PART_SRC_PATTERN_ANGLE or
- PSYS_PART_SRC_PATTERN_ANGLE_CONE source pattern.
+ PSYS_PART_SRC_PATTERN_ANGLE_CONE source pattern.
The area between the outer and inner angle
will be filled with particles..
@@ -3518,7 +4007,7 @@
how many particles to release in a burst.
- what distance from the center of the object
+ what distance from the center of the object
to create the particles.
@@ -3528,22 +4017,22 @@
maximum speed that a particle should be moving.
- how long this particle system should last,
+ how long this particle system should last,
0.0 menas forever.
- the key of a target object to move towards
+ the key of a target object to move towards
if PSYS_PART_TARGET_POS_MASK is enabled.
- Sets the angular velocity to rotate the axis
+ Sets the angular velocity to rotate the axis
that SRC_PATTERN_ANGLE and
SRC_PATTERN_ANGLE_CONE use..
- These constants are used in calls to the
- llRequestAgentData api to collect information about
+ These constants are used in calls to the
+ llRequestAgentData api to collect information about
an agent which will
be provided in the dataserver event.
Texture Animation Constants
@@ -3557,7 +4046,7 @@
The date the agent was born returned in ISO 8601 format of YYYY-MM-DD.
- Returns the agent ratings as a comma separated string
+ Returns the agent ratings as a comma separated string
of six integers. They are:
1. Positive rated behavior
@@ -3569,10 +4058,10 @@
- LSL provides a small collection of floating point
- constants for use in float arithmetic.
+ LSL provides a small collection of floating point
+ constants for use in float arithmetic.
These constants are usually
- employed while performing trigonometric calculations,
+ employed while performing trigonometric calculations,
but are sometimes useful for other applications such as
specifying arc radians to sensor or particle system functions.
Float Constants
@@ -3586,12 +4075,12 @@
1.57079633 - The radians of a quarter circle.
- 0.01745329 - Number of radians per degree.
+ 0.01745329 - Number of radians per degree.
You can use this to convert degrees to radians by multiplying
the degrees by this number.
- 57.2957795 - Number of degrees per radian.
+ 57.2957795 - Number of degrees per radian.
You can use this number to convert radians to degrees by
multiplying the radians by this number.
@@ -3603,39 +4092,39 @@
There is only one key constant which acts as an invalid key: NULL_KEY.
- There is one uncategorized integer constant
+ There is one uncategorized integer constant
which is used in some of the texturing and coloring api: ALL_SIDES
- There is one uncategorized string constant
+ There is one uncategorized string constant
which is used in the dataserver event: EOF
- There is only one vector constant which
+ There is only one vector constant which
acts as a zero vector: ZERO_VECTOR = <0,0,0>.
- There is only one rotation constant
+ There is only one rotation constant
which acts as a zero rotation: ZERO_ROTATION = <0,0,0,1>.
Parameters
- A vector of timescales for exponential
+ A vector of timescales for exponential
decay of the vehicles linear velocity along its preferred axes of
- motion (at, left, up).
+ motion (at, left, up).
Range = [0.07, inf) seconds for each element of the vector.
- A vector of timescales for exponential
+ A vector of timescales for exponential
decay of the vehicles angular velocity about its preferred axes of
- motion (at, left, up).
+ motion (at, left, up).
Range = [0.07, inf) seconds for each element of the vector.
- The direction and magnitude (in preferred frame)
+ The direction and magnitude (in preferred frame)
of the vehicles linear motor. The vehicle will accelerate
- (or decelerate if necessary) to match its velocity to its motor.
+ (or decelerate if necessary) to match its velocity to its motor.
Range of magnitude = [0, 30] meters/second.
@@ -3645,7 +4134,7 @@
The timescale for exponential decay of the linear motors magnitude.
- The direction and magnitude (in preferred frame)
+ The direction and magnitude (in preferred frame)
of the vehicles angular motor.The vehicle will accelerate
(or decelerate if necessary) to match its velocity to its motor.
@@ -3656,16 +4145,16 @@
The timescale for exponential decay of the angular motors magnitude.
- The height (above the terrain or water, or global)
+ The height (above the terrain or water, or global)
at which the vehicle will try to hover.
- A slider between minimum (0.0 = bouncy)
+ A slider between minimum (0.0 = bouncy)
and maximum (1.0 = fast as possible) damped motion of the
hover behavior.
- The period of bounce (or timescale of exponential approach,
+ The period of bounce (or timescale of exponential approach,
depending on the hover efficiency) for the
vehicle to hover to the proper height.
@@ -3673,59 +4162,59 @@
A slider between minimum (0.0) and maximum anti-gravity (1.0).
- A slider between minimum (0.0) and maximum (1.0)
+ A slider between minimum (0.0) and maximum (1.0)
deflection of linear velocity. That is, its a simple
scalar for modulating the strength of linear deflection.
- The timescale for exponential success of linear
+ The timescale for exponential success of linear
deflection deflection. It is another way to specify how much
- time it takes for the vehicles linear velocity
+ time it takes for the vehicles linear velocity
to be redirected to its preferred axis of motion.
- A slider between minimum (0.0) and maximum (1.0)
+ A slider between minimum (0.0) and maximum (1.0)
deflection of angular orientation. That is, its a simple
- scalar for modulating the strength of angular
+ scalar for modulating the strength of angular
deflection such that the vehicles preferred axis of motion
points toward its real velocity.
- The timescale for exponential success of linear
+ The timescale for exponential success of linear
deflection deflection. Its another way to specify the strength
- of the vehicles tendency to reorient itself so
+ of the vehicles tendency to reorient itself so
that its preferred axis of motion agrees with its true velocity.
- A slider between minimum (0.0 = wobbly) and
+ A slider between minimum (0.0 = wobbly) and
maximum (1.0 = firm as possible) stability of the vehicle to
keep itself upright.
- The period of wobble, or timescale for
+ The period of wobble, or timescale for
exponential approach, of the vehicle to rotate such that its preferred
"up" axis is oriented along the worlds "up" axis.
- A slider between anti (-1.0), none (0.0),
+ A slider between anti (-1.0), none (0.0),
and maxmum (1.0) banking strength.
- A slider between static (0.0) and dynamic (1.0)
+ A slider between static (0.0) and dynamic (1.0)
banking. "Static" means the banking scales only with the
- angle of roll, whereas "dynamic" is a term
+ angle of roll, whereas "dynamic" is a term
that also scales with the vehicles linear speed.
- The timescale for banking to exponentially
+ The timescale for banking to exponentially
approach its maximum effect. This is another way to scale the
- strength of the banking effect, however it affects the
+ strength of the banking effect, however it affects the
term that is proportional to the difference between what
- the banking behavior is trying to do, and what the
+ the banking behavior is trying to do, and what the
vehicle is actually doing.
- A rotation of the vehicles preferred axes of
+ A rotation of the vehicles preferred axes of
motion and orientation (at, left, up) with respect to the vehicles
local frame (x, y, z).
@@ -3736,14 +4225,14 @@
Old, changed to VEHICLE_FLAG_NO_DEFLECTION_UP
- This flag prevents linear deflection parallel to world z-axis.
+ This flag prevents linear deflection parallel to world z-axis.
This is useful for preventing ground vehicles
- with large linear deflection, like bumper cars,
+ with large linear deflection, like bumper cars,
from climbing their linear deflection into the sky.
- For vehicles with vertical attractor
- that want to be able to climb/dive, for instance,
+ For vehicles with vertical attractor
+ that want to be able to climb/dive, for instance,
airplanes that want to use the banking feature.
@@ -3756,7 +4245,7 @@
Hover at global height.
- Hover doesnt push down. Use this flag for hovering vehicles
+ Hover doesnt push down. Use this flag for hovering vehicles
that should be able to jump above their hover
height.
@@ -3767,7 +4256,7 @@
Types
- Simple vehicle that bumps along the ground,
+ Simple vehicle that bumps along the ground,
and likes to move along its local x-axis.
// most friction for left-right, least for up-down
llSetVehicleVectorParam( VEHICLE_LINEAR_FRICTION_TIMESCALE, <30, 1, 1000> );
@@ -3813,7 +4302,7 @@
| VEHICLE_FLAG_LIMIT_MOTOR_UP );
- Another vehicle that bounces along the ground but needs
+ Another vehicle that bounces along the ground but needs
the motors to be driven from external controls or
timer events.
// most friction for left-right, least for up-down
@@ -4022,7 +4511,7 @@
- DEBUG_CHANNEL is an integer constant that, when passed to
+ DEBUG_CHANNEL is an integer constant that, when passed to
llSay, llWhisper, or llShout as a channel parameter,
will print text to the Script Warning/Error Window.
It has the value '2147483647'.
@@ -4217,9 +4706,9 @@
will NOT be created (for ANGLE patterns)
- Area in radians filled with particles
+ Area in radians filled with particles
(for ANGLE patterns) (if lower than PSYS_SRC_ANGLE_BEGIN,
- acts as PSYS_SRC_ANGLE_BEGIN itself,
+ acts as PSYS_SRC_ANGLE_BEGIN itself,
and PSYS_SRC_ANGLE_BEGIN acts as PSYS_SRC_ANGLE_END)
@@ -4229,7 +4718,7 @@
PUBLIC_CHANNEL is an integer constant that, when passed to
- llSay, llWhisper, or llShout as a channel parameter,
+ llSay, llWhisper, or llShout as a channel parameter,
will print text to the publicly heard chat channel. Has the value '0'.
@@ -4314,6 +4803,8 @@
+
+
@@ -4332,12 +4823,14 @@
+
+