LlSetLinkPrimitiveParams

Set primitive parameters for linknumber based on rules.

• This function causes the script to sleep for 0.2 seconds.
• If texture is missing from the prim's inventory and it is not a UUID or it is not a texture then an error is shouted on DEBUG_CHANNEL.
• If texture is a UUID then there are no new asset permissions consequences for the object.
  • The resulting object develops no new usage restrictions that might have occurred if the asset had been placed in the prims inventory.
• top_size and client values are different, the ranges do not line up, conversion is required. This simple equation can be used: answer = 1.0 - value. See top_size Explained for more information.
• If map is missing from the prim's inventory and it is not a UUID or it is not a texture then an error is shouted on DEBUG_CHANNEL.
• If map is a UUID then there are no new asset permissions consequences for the object.
  • The resulting object develops no new usage restrictions that might have occurred if the asset had been placed in the prims inventory.
• PRIM_POSITION caveats
  • Depending upon the situation position may need to be in local coordinates or region coordinates, See llSetPos#Specification for details.
  • The range the prim can move is limited if it is an unattached root prim. The distance is capped to 10m per PRIM_POSITION call. See WarpPos. This is a very special case. Do not rely on rule duplication of other flags - the results are undefined, and things will break in the future.
  • Moving a prim that an avatar is seated upon will not move the avatar; the sit target will not be updated.
    • To mimic updating of a sit-target, use UpdateSitTarget.
  • Moving avatars with PRIM_POSITION
    • Moving the prim the avatar sat upon does not move the avatar.
    • Moving an avatar does not move the prim they sat upon.
    • Sit-target coordinates do not easily map to prim coordinates, use UpdateSitTarget.
    • If position is greater than 54 meters away from the center, the repositioning will silently fail.
• PRIM_PHANTOM, PRIM_PHYSICS and PRIM_TEMP_ON_REZ applies to the entire object (linkset).
• Values may drift, become truncated or be range limited. Some limits are applied by the client during deserialization, others are applied by the simulator when the sim tries to store the values.
  • When testing vectors and rotations use llVecDist and llAngleBetween (respectfully) to perform fuzzy tests.
• If face is ALL_SIDES then the flag works on all sides.
• The flag silently fails if its face value indicates a face that does not exist.
• Applying an operation to LINK_SET is applied first to the root prim, then to each child prim.
• The sim will clamp attributes before storing them.
• The client will clamp attributes before rendering.
• There is currently no corresponding llGetLinkPrimitiveParams although llGetObjectDetails can get the position and rotation of a linked prim identified by its key.
  • The only way to get many parameters from linked prims is to put a separate script in each child and use linked messages.

Important Issues

		SVC-914	[c]		CHANGED_TEXTURE is not triggered when texture is changed via script
		SVC-93	[c]		llSetRot and llSetPrimitiveParams (using PRIM_ROTATION) incorrectly implemented for child prims.

A simple script to light up a prim in a linkset when touched, and unlight the others using llSetLinkPrimitiveParams, when script is installed in the root prim of the linkset.

 
default
{
    touch_start(integer total_number)
    {
        // Turn off all prims
        llSetLinkPrimitiveParams(LINK_SET,[PRIM_FULLBRIGHT,ALL_SIDES,FALSE]);
        // Turn on the one that was touched
        llSetLinkPrimitiveParams(llDetectedLinkNumber(0),[PRIM_FULLBRIGHT,ALL_SIDES,TRUE]);        
    }
}
 

PRIM_POSITION

Avatars sitting on the object can be moved with llSetLinkPrimitiveParams and PRIM_POSITION. This was originally a mis-feature but according to Andrew Linden LL has decided to support it.

Examples

The below example moves an avatar to x,y,z without moving the prim they are sitting on. If x,y,z is more than 54 meters away the call will silently fail. Remember x,y,z is in object relative coordinates just like any other linked prim in a set.

Avatars are always the last prims in the set, so llGetNumberOfPrims can be used for a single avatar sitting on a vehicle.

Example:

llSetLinkPrimitiveParams(llGetNumberOfPrims(), [PRIM_POSITION, <x,y,z>]);

Functions

Articles

Issues

		SVC-914	[c]		CHANGED_TEXTURE is not triggered when texture is changed via script
		SVC-93	[c]		llSetRot and llSetPrimitiveParams (using PRIM_ROTATION) incorrectly implemented for child prims.