PrimParam
Constants in the PrimParam enum.
// Link targetingPRIM_LINK_TARGET, integer link_target // the rules after it apply to this link// Position and orientationPRIM_POSITION, vector position // region coordinatesPRIM_ROTATION, rotation rot // global rotation, like llSetRot; broken for child primsPRIM_SIZE, vector size // like llSetScale; fails silently on physical primsPRIM_POS_LOCAL, vector position // relative to the root, like llSetPos in a childPRIM_ROT_LOCAL, rotation rot // relative to the root, like llSetLocalRotPRIM_OMEGA, vector axis, float spinrate, float gain // client-side spin, like llTargetOmega; spinrate in radians per second// AppearancePRIM_COLOR, integer face, vector color, float alpha // Blinn-Phong colour and opacity; face may be ALL_SIDESPRIM_ALPHA_MODE, integer face, integer alpha_mode, integer alpha_cutoff // PRIM_ALPHA_MODE_*; alpha_cutoff used only for _MASKPRIM_TEXTURE, integer face, string texture, vector repeats, vector offsets, float rotation_in_radians // Blinn-Phong diffuse texturePRIM_FULLBRIGHT, integer face, integer boolean // full-bright rendering on the facePRIM_GLOW, integer face, float intensity // glow intensity on the facePRIM_POINT_LIGHT, integer boolean, vector linear_color, float intensity, float radius, float falloff // local light; linear_color in linear space (llsRGB2Linear)PRIM_BUMP_SHINY, integer face, integer shiny, integer bump // PRIM_SHINY_*, PRIM_BUMP_*PRIM_TEXGEN, integer face, integer mode // PRIM_TEXGEN_* texture mapping modePRIM_RENDER_MATERIAL, integer face, string render_material // clears most PRIM_GLTF_* overridesPRIM_GLTF_BASE_COLOR, integer face, string texture, vector repeats, vector offsets, float rotation_in_radians, vector linear_color, float alpha, integer gltf_alpha_mode, float alpha_mask_cutoff, integer double_sided // linear_color: linear spacePRIM_GLTF_NORMAL, integer face, string texture, vector repeats, vector offsets, float rotation_in_radians // glTF normal map overridePRIM_GLTF_METALLIC_ROUGHNESS, integer face, string texture, vector repeats, vector offsets, float rotation_in_radians, float metallic_factor, float roughness_factorPRIM_GLTF_EMISSIVE, integer face, string texture, vector repeats, vector offsets, float rotation_in_radians, vector linear_emissive_tint // linear spacePRIM_NORMAL, integer face, string texture, vector repeats, vector offsets, float rotation_in_radians // Blinn-Phong normal mapPRIM_SPECULAR, integer face, string texture, vector repeats, vector offsets, float rotation_in_radians, vector color, integer glossiness, integer environment // Blinn-PhongPRIM_PROJECTOR, string texture, float fov, float focus, float ambiance // light projection; set onlyPRIM_REFLECTION_PROBE, integer boolean, float ambiance, float clip_distance, integer flags // custom reflection probe; PRIM_REFLECTION_PROBE_* flags// Text and namingPRIM_TEXT, string text, vector color, float alpha // floating text, like llSetTextPRIM_NAME, string name // like llSetObjectNamePRIM_DESC, string description // like llSetObjectDesc// ShapePRIM_TYPE, PRIM_TYPE_BOX, integer hole_shape, vector cut, float hollow, vector twist, vector top_size, vector top_shear // no effect on meshPRIM_TYPE, PRIM_TYPE_CYLINDER, integer hole_shape, vector cut, float hollow, vector twist, vector top_size, vector top_shearPRIM_TYPE, PRIM_TYPE_PRISM, integer hole_shape, vector cut, float hollow, vector twist, vector top_size, vector top_shearPRIM_TYPE, PRIM_TYPE_SPHERE, integer hole_shape, vector cut, float hollow, vector twist, vector dimplePRIM_TYPE, PRIM_TYPE_TORUS, integer hole_shape, vector cut, float hollow, vector twist, vector hole_size, vector top_shear, vector advanced_cut, vector taper, float revolutions, float radius_offset, float skewPRIM_TYPE, PRIM_TYPE_TUBE, integer hole_shape, vector cut, float hollow, vector twist, vector hole_size, vector top_shear, vector advanced_cut, vector taper, float revolutions, float radius_offset, float skewPRIM_TYPE, PRIM_TYPE_RING, integer hole_shape, vector cut, float hollow, vector twist, vector hole_size, vector top_shear, vector advanced_cut, vector taper, float revolutions, float radius_offset, float skewPRIM_TYPE, PRIM_TYPE_SCULPT, string map, integer typePRIM_SLICE, vector slice // shape slice, equivalent to cut / advanced_cut// Physics and behaviourPRIM_PHYSICS, integer boolean // whole object responds to physicsPRIM_PHANTOM, integer boolean // whole object phantomPRIM_TEMP_ON_REZ, integer boolean // whole object temporary; cleaned up in about a minutePRIM_PHYSICS_SHAPE_TYPE, integer type // PRIM_PHYSICS_SHAPE_NONE, _PRIM or _CONVEXPRIM_MATERIAL, integer material // PRIM_MATERIAL_*: default collision sound, friction, restitutionPRIM_FLEXIBLE, integer boolean, integer softness, float gravity, float friction, float wind, float tension, vector force // softness 0 to 3; gravity -10.0 to 10.0PRIM_COLLISION_SOUND, string sound, float volume // collision sound UUID and volumePRIM_DAMAGE, float damage, integer damage_type // damage delivered on collisionPRIM_HEALTH, float health // objects default to 0 health// Clicking and sittingPRIM_CLICK_ACTION, integer action // CLICK_ACTION_* default click/touch actionPRIM_SIT_TARGET, integer boolean, vector offset, rotation rot // FALSE removes it; offset may be ZERO_VECTORPRIM_SIT_FLAGS, integer flags // SIT_FLAG_*PRIM_SCRIPTED_SIT_ONLY, integer boolean // only llSitOnLink can seat avatarsPRIM_ALLOW_UNSIT, integer boolean // manual standing; experience seats (llSitOnLink) only
Constants
Link targeting
| Constant | Type | Value | Description |
|---|---|---|---|
PRIM_LINK_TARGET | integer | 34 | Prim parameter [PRIM_LINK_TARGET, integer link_target] used to get or set properties for multiple linked prims within a single primitive parameters call. |
Position and orientation
| Constant | Type | Value | Description |
|---|---|---|---|
PRIM_POSITION | integer | 6 | Prim parameter [PRIM_POSITION, vector position] to get or set the position of the prim in region coordinates (or local coordinates depending on the script context). |
PRIM_ROTATION | integer | 8 | Prim parameter [PRIM_ROTATION, rotation global_rot] to get or set the global rotation of the prim (equivalent to llGetRot/llSetRot; note that setting this on child prims may be broken). |
PRIM_SIZE | integer | 7 | Prim parameter [PRIM_SIZE, vector size] to get or set the prim's physical dimensions (equivalent to llGetScale/llSetScale). |
PRIM_POS_LOCAL | integer | 33 | Prim parameter [PRIM_POS_LOCAL, vector position] to get or set the local position of a prim (equivalent to llGetLocalPos/llSetPos). |
PRIM_ROT_LOCAL | integer | 29 | Prim parameter [PRIM_ROT_LOCAL, rotation local_rot] to get or set the local rotation of a prim (equivalent to llGetLocalRot/llSetLocalRot). |
PRIM_OMEGA | integer | 32 | Prim parameter to get, set, or disable a client-side physical-like rotation (analogous to llTargetOmega). vector axis – arbitrary axis to rotate the object around float spinrate – rate of rotation in radians per second float gain – also modulates the final spinrate and disables the rotation behavior if zero |
Appearance
| Constant | Type | Value | Description |
|---|---|---|---|
PRIM_COLOR | integer | 18 | Prim parameter to get or set the Blinn-Phong color and opacity of a face. integer face – face number or ALL_SIDES vector color – color in RGB <R, G, B> (<0.0, 0.0, 0.0> = black, <1.0, 1.0, 1.0> = white) float alpha – from 0.0 (clear) to 1.0 (solid) (0.0 <= alpha <= 1.0) |
PRIM_ALPHA_MODE | integer | 38 | Prim parameter used to set diffuse texture alpha rendering mode attributes. Requires face, alpha_mode (PRIM_ALPHA_MODE_BLEND, _NONE, _MASK, or _EMISSIVE), and alpha_cutoff (used only for _MASK) parameters. |
PRIM_TEXTURE | integer | 17 | Prim parameter [PRIM_TEXTURE, integer face, string texture, vector repeats, vector offsets, float rotation_in_radians] to get or set the Blinn-Phong diffuse texture settings of a face. |
PRIM_FULLBRIGHT | integer | 20 | Prim parameter [PRIM_FULLBRIGHT, integer face, integer boolean] to get or set whether full-bright rendering is enabled on the specified face. |
PRIM_GLOW | integer | 25 | Prim parameter [PRIM_GLOW, integer face, float intensity] to get or set the glow intensity on a face (the compiler integer value is 25 if the named constant is rejected). |
PRIM_POINT_LIGHT | integer | 23 | Prim parameter to configure local lighting. Accepts color in linear space (use llsRGB2Linear to convert from sRGB). integer boolean – TRUE enables, FALSE disables vector linear_color – linear color in RGB <R, G, B&> (<0.0, 0.0, 0.0> = black, <1.0, 1.0, 1.0> = white) float intensity – ranges from 0.0 to 1.0 float radius – ranges from 0.1 to 20.0 float falloff – ranges from 0.01 to 2.0 |
PRIM_BUMP_SHINY | integer | 19 | Prim parameter used to get or set both the shininess and bump mapping settings of a face. |
PRIM_TEXGEN | integer | 22 | Prim parameter [PRIM_TEXGEN, integer face, integer mode] to get or set the texture mapping mode of the face. |
PRIM_RENDER_MATERIAL | integer | 49 | Prim parameter [PRIM_RENDER_MATERIAL, integer face, string material] to get or set face material settings. Note: Setting this clears most PRIM_GLTF_* properties on the face, except for repeats, offsets, and rotation_in_radians. |
PRIM_GLTF_BASE_COLOR | integer | 48 | Prim parameter to get or set the GLTF base color override of an object's face. Requires face, texture, repeats, offsets, rotation, linear_color (in linear space; use llsRGB2Linear), alpha_mode (PRIM_GLTF_ALPHA_MODE_*), alpha_cutoff, and double_sided arguments. |
PRIM_GLTF_NORMAL | integer | 45 | Prim parameter to get or set the GLTF normal map override of a face. Requires face, texture, repeats, offsets, and rotation arguments. |
PRIM_GLTF_METALLIC_ROUGHNESS | integer | 47 | Prim parameter to get or set the GLTF occlusion/metallic/roughness override of a face. Requires face, texture, repeats, offsets, rotation, metallic_factor, and roughness_factor arguments. |
PRIM_GLTF_EMISSIVE | integer | 46 | Prim parameter to get or set the GLTF emission override of a face. Requires face, texture, repeats, offsets, rotation, and emissive_tint (specified in linear space; use llsRGB2Linear). |
PRIM_NORMAL | integer | 37 | Prim parameter to get or set the Blinn-Phong normal map texture settings of a face. Requires face, texture, repeats, offsets, and rotation_in_radians arguments. |
PRIM_SPECULAR | integer | 36 | Prim parameter to get or set the Blinn-Phong specular map texture settings of a face. Requires face, texture, repeats, offsets, rotation_in_radians, color, glossy, and environment arguments. |
PRIM_PROJECTOR | integer | 42 | Prim parameter [PRIM_PROJECTOR, string texture, float fov, float focus, float ambiance] to configure light projection settings. If the prim is not configured as a projector, the texture key will return NULL_KEY. |
PRIM_REFLECTION_PROBE | integer | 44 | Prim parameter to configure the object as a custom-placed reflection probe for Image-Based Lighting (IBL). Only affects objects inside its volume of influence. |
Text and naming
| Constant | Type | Value | Description |
|---|---|---|---|
PRIM_TEXT | integer | 26 | Prim parameter [PRIM_TEXT, string text, vector color, float alpha] to get or set the object's floating/hover text (equivalent to llSetText). |
PRIM_NAME | integer | 27 | Prim parameter [PRIM_NAME, string name] to get or set the prim's name (equivalent to llGetObjectName/llSetObjectName). |
PRIM_DESC | integer | 28 | Prim parameter [PRIM_DESC, string description] to get or set the prim's description (equivalent to llGetObjectDesc/llSetObjectDesc). |
Shape
| Constant | Type | Value | Description |
|---|---|---|---|
PRIM_TYPE | integer | 9 | Prim parameter used to get or set the geometric shape type (PRIM_TYPE_*) and its associated parameters. |
PRIM_SLICE | integer | 35 | Prim parameter [PRIM_SLICE, vector slice] to get or set the prim's slice values (a shape attribute equivalent to advanced cut). |
Physics and behaviour
| Constant | Type | Value | Description |
|---|---|---|---|
PRIM_PHYSICS | integer | 3 | Prim parameter [PRIM_PHYSICS, integer boolean] to get or set whether the object responds to Second Life physics. |
PRIM_PHANTOM | integer | 5 | Prim parameter [PRIM_PHANTOM, integer boolean] to get or set whether phantom status is enabled. |
PRIM_TEMP_ON_REZ | integer | 4 | Prim parameter used to get or set the object's temporary status. Temporary objects live until the next garbage collection cycle (about 1 minute), do not count against normal prim limits, but are subject to regional limits. |
PRIM_PHYSICS_SHAPE_TYPE | integer | 30 | Prim parameter used to get or set the type of shape the physics engine uses for the prim (PRIM_PHYSICS_SHAPE_NONE, _PRIM, or _CONVEX). Mainly used for physics optimization. |
PRIM_MATERIAL | integer | 2 | Prim parameter [PRIM_MATERIAL, integer PRIM_MATERIAL_*] to get or set the prim's material. The material determines the default collision sound, sprite, friction coefficient, and restitution coefficient (elasticity) without affecting mass. |
PRIM_FLEXIBLE | integer | 21 | Prim parameter to get or set the prim's flexible configuration. integer boolean – TRUE enables, FALSE disables integer softness – ranges from 0 to 3 float gravity – ranges from -10.0 to 10.0 float friction – ranges from 0.0 to 10.0 float wind – ranges from 0.0 to 10.0 float tension – ranges from 0.0 to 10.0 vector force |
PRIM_COLLISION_SOUND | integer | 53 | Prim parameter to set the collision sound UUID and volume level for the prim. |
PRIM_DAMAGE | integer | 51 | Prim parameter used to get or set the damage amount and damage type delivered by the prim on collision. |
PRIM_HEALTH | integer | 52 | Prim parameter used to get or set the health of the prim. Objects default to 0 health. |
Clicking and sitting
| Constant | Type | Value | Description |
|---|---|---|---|
PRIM_CLICK_ACTION | integer | 43 | Prim parameter followed by a CLICK_ACTION_* constant to specify the default action taken when a user clicks or touches the prim. |
PRIM_SIT_TARGET | integer | 41 | Prim parameter [PRIM_SIT_TARGET, integer boolean, vector offset, rotation rot] to get or set the prim's sit target. Setting the boolean to FALSE deactivates the target. Unlike llLinkSitTarget, offset <0.0, 0.0, 0.0> can be explicitly set. |
PRIM_SIT_FLAGS | integer | 50 | Prim parameter used to get or set sit-related flags currently active on the prim. |
PRIM_SCRIPTED_SIT_ONLY | integer | 40 | Prim parameter restricting manual sitting on this prim. When active, sitting can only be initiated via llSitOnLink; manual sitting attempts fail. This restriction applies even outside experience-enabled regions. |
PRIM_ALLOW_UNSIT | integer | 39 | Prim parameter for allowing or restricting manual standing for avatars seated on this prim within a valid experience. Ignored if the avatar was not seated via llSitOnLink. When restriction is active, participating seated avatars cannot manually stand or select another prim to sit on. |
Used by
llSetLinkPrimitiveParamsFastfunctionSets primitive parameters for the linked prim link according to rules with no built-in script sleep delay.