Prim Target

Read and change properties of the prim containing the script.

Feature: Prims

What do you want to do?

vector llGetPos()Returns a vector representing the current position of the object in region coordinates.rotation llGetRot()Returns a rotation representing the prim's orientation relative to the region's axes.llSetScale(vector size)Sets the physical scale (dimensions) of the prim containing the script to size.

Reference

Find topic entries

43 topic entries

• key llAvatarOnSitTarget()function

  Returns the UUID of the avatar seated on the prim's sit target (defined via llSitTarget), or NULL_KEY if no avatar is sitting there or the prim lacks a sit target.

• integer llClearPrimMedia(integer face)function

  Deletes the media and clears all parameters from the specified face. Returns an integer STATUS_* flag detailing the success or failure of the operation.

• float llGetAlpha(integer face)function

  Returns a float representing the Blinn-Phong alpha (transparency) of face. If face is ALL_SIDES, returns the mean average of all faces.

• vector llGetColor(integer face)function

  Returns the Blinn-Phong RGB color vector of face (values between 0.0 and 1.0). If face is ALL_SIDES, returns the mean average of all faces.

• key llGetCreator()function

  Returns the key (UUID) of the prim's original creator.

• key llGetKey()function

  Returns the key (UUID) of the prim containing the script.

• integer llGetLinkNumber()function

  Returns the integer link number of the prim containing the script (0 for unlinked, 1 for the root, and 2+ for children).

• vector llGetLocalPos()function

  Returns a position vector relative to the root prim. If called from the root prim, it returns the global region position (or the position relative to the attachment point if attached).

• rotation llGetLocalRot()function

  Returns a rotation representing the local orientation of a child prim relative to the root prim, or the object's overall rotation if called from the root.

• integer llGetNumberOfSides()function

  Returns an integer representing the total number of sides (faces) of the prim containing the script.

• string llGetObjectDesc()function

  Returns a string containing the description of the specific prim containing the script.

• string llGetObjectName()function

  Returns a string containing the name of the specific prim containing the script.

• list llGetPhysicsMaterial()function

  Returns a list of the format [float gravity_multiplier, float restitution, float friction, float density] detailing the physical characteristics of the object.

• vector llGetPos()function

  Returns a vector representing the current position of the object in region coordinates.

• list llGetPrimMediaParams(integer face, list params)function

  Returns a list containing the media parameters of the specified face, retrieved in the order requested by params. Returns an empty list if no media exists on the face.

• list llGetPrimitiveParams(list params)function

  Returns a list of primitive attribute values matching the requested params list.

• string llGetRenderMaterial(integer face)function

  Returns a string representing the render material on face (returns the inventory name if it is in the prim's inventory, or its key UUID otherwise).

• rotation llGetRot()function

  Returns a rotation representing the prim's orientation relative to the region's axes.

• vector llGetScale()function

  Returns a vector representing the physical scale (dimensions in meters) of the prim containing the script.

• string llGetTexture(integer face)function

  Returns a string representing the Blinn-Phong diffuse texture on face (returns the inventory name if it is a texture in the prim's inventory, or its key UUID otherwise).

• vector llGetTextureOffset(integer face)function

  Returns a vector containing the texture offsets of face in the X (horizontal U) and Y (vertical V) components (Z is unused).

• float llGetTextureRot(integer face)function

  Returns a float representing the texture rotation angle (in radians) on face.

• vector llGetTextureScale(integer face)function

  Returns a vector containing the texture scales of face in the X and Y components (Z is unused).

• llOffsetTexture(float u, float v, integer face)function

  Sets the texture horizontal (u) and vertical (v) offsets for the chosen face. If face is ALL_SIDES, offsets all faces.

• llRemoteLoadScriptPin(key target, string script, integer pin, integer running, integer start_param)function

  Copies the script into target, setting it running (if running is TRUE) with the start_param, provided the script owner has modify permissions on target and target's PIN matches pin (set via llSetRemoteScriptAccessPin).

• llRotateTexture(float angle, integer face)function

  Sets the texture rotation of face to the specified angle (in radians). If face is ALL_SIDES, rotates the texture on all faces.

• llScaleTexture(float u, float v, integer face)function

  Sets the diffuse texture horizontal u and vertical v scales (repeats) on the specified face of the prim. Setting face to ALL_SIDES updates all sides. Negative scale values flip the texture.

• llSetAlpha(float alpha, integer face)function

  Sets the diffuse texture alpha (opacity) of face. If face is ALL_SIDES, applies to all faces. Values are clamped between 0.1 and 1.0 (where 1.0 is fully opaque).

• llSetColor(vector color, integer face)function

  Sets the Blinn-Phong diffuse RGB color of face. If face is ALL_SIDES, applies the color to all faces.

• llSetLocalRot(rotation rot)function

  Sets the rotation of a child prim relative to its root prim using rot.

• llSetObjectDesc(string description)function

  Sets the description of the prim containing the script to description (limited to 127 characters).

• llSetObjectName(string name)function

  Sets the name of the prim containing the script to name.

• llSetPhysicsMaterial(integer mask, float gravity_multiplier, float restitution, float friction, float density)function

  Configures the physical characteristics of an object. The mask bitfield specifies which of the other parameters (gravity_multiplier, restitution, friction, or density) should be applied to the object.

• llSetPos(vector pos)function

  Moves the non-physical object or prim toward the vector pos (up to 10m). If called in a child prim, pos is treated as root-relative; if called from the root prim, the entire object is moved.

• integer llSetPrimMediaParams(integer face, list params)function

  Sets the media parameters specified by params on the designated face of the prim. Returns an integer STATUS_* flag detailing success or failure.

• integer llSetRegionPos(vector position)function

  Tries to move the entire object so that its root prim is within 0.1m of the vector position (underground positions are set to ground level). Returns TRUE on success or FALSE on failure.

• llSetRenderMaterial(string material, integer face)function

  Applies material (UUID or inventory name) to face of the prim. Note: This clears most PRIM_GLTF_* properties on the face except for repeats, offsets, and rotation.

• llSetRot(rotation rot)function

  Sets the rotation of the prim to rot. If in a child prim, rot is treated as root-relative; if in the root prim of a non-physical object, rotates the entire object.

• llSetScale(vector size)function

  Sets the physical scale (dimensions) of the prim containing the script to size.

• llSetSitText(string text)function

  Displays the string text instead of 'Sit' (or 'Sit Here') in the viewer's right-click context menu.

• llSetTexture(string texture, integer face)function

  Applies the Blinn-Phong diffuse texture to face of the prim.

• llSetTextureAnim(integer mode, integer face, integer sizex, integer sizey, float start, float length, float rate)function

  Animates the texture on face of the prim by setting its scale and offset. mode defines options, sizex/sizey define frames, start defines the start frame/angle, length defines duration, and rate defines playback speed.

• llSitTarget(vector offset, rotation rot)function

  Sets the sit target position (offset) and rotation (rot) relative to the prim's position and orientation. Clears the sit target if offset is ZERO_VECTOR.