User:Strife Onizuka/PrimitiveParamsTable

From Second Life Wiki
Jump to navigation Jump to search
User:Strife Onizuka/PRIM TEXTUser:Strife Onizuka/PRIM PHYSICSUser:Strife Onizuka/PRIM PHANTOMUser:Strife Onizuka/PRIM TEMP ON REZUser:Strife Onizuka/PRIM MATERIALUser:Strife Onizuka/PRIM SIZEUser:Strife Onizuka/PRIM POSITIONUser:Strife Onizuka/PRIM ROTATIONUser:Strife Onizuka/PRIM ROT LOCALUser:Strife Onizuka/PRIM FLEXIBLEUser:Strife Onizuka/PRIM POINT LIGHTUser:Strife Onizuka/PRIM TEXGENUser:Strife Onizuka/PRIM COLORUser:Strife Onizuka/PRIM GLOWUser:Strife Onizuka/PRIM FULLBRIGHTUser:Strife Onizuka/PRIM BUMP SHINY
V Flag Parameters Returned Scope
27 PRIM_NAME PRIM_NAME,
string name ] name - prim
Jive-icon-11x2.png

Used to get or set the prim's name.

• string name
3 name
28 PRIM_DESC PRIM_DESC,
string description ] description - prim
Jive-icon-11x2.png

Used to get or set the prim's description.

• string description
3 description
9 PRIM_TYPE PRIM_TYPE,
integer flag ] + flag_parameters shape - prim
Jive-icon-11x2.png

Gets or sets the type of the prim and associated type flag_parameters.

• integer flag PRIM_TYPE_* flag

• list flag_parameters a list consisting of the parameters for flag

The values needed for flag_parameters is dependent on flag, please refer to the individual PRIM_TYPE_* articles for additional information.

Caveats

All Issues ~ Search JIRA for related Bugs
flag Constants Additional Return Values / Flag Parameters
PRIM_TYPE_BOX 0 [ integer hole_shape, vector cut, float hollow, vector twist, vector top_size, vector top_shear ]
PRIM_TYPE_CYLINDER 1 [ integer hole_shape, vector cut, float hollow, vector twist, vector top_size, vector top_shear ]
PRIM_TYPE_PRISM 2 [ integer hole_shape, vector cut, float hollow, vector twist, vector top_size, vector top_shear ]
PRIM_TYPE_SPHERE 3 [ integer hole_shape, vector cut, float hollow, vector twist, vector dimple]
PRIM_TYPE_TORUS 4 [ 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 skew ]
PRIM_TYPE_TUBE 5 [ 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 skew ]
PRIM_TYPE_RING 6 [ 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 skew ]
PRIM_TYPE_SCULPT 7 [ string map, integer type ]
type Flags Style Description
PRIM_SCULPT_TYPE_SPHERE 1 Sphere Converge top & bottom, stitch left side to right
PRIM_SCULPT_TYPE_TORUS 2 Torus Stitch top to bottom, stitch left side to right
PRIM_SCULPT_TYPE_PLANE 3 Plane No stitching or converging
PRIM_SCULPT_TYPE_CYLINDER 4 Cylinder Stitch left side to right.
PRIM_SCULPT_TYPE_MESH 5 Mesh model See: Mesh
PRIM_SCULPT_FLAG_ZZZZZZZZ 63
PRIM_SCULPT_FLAG_ANIMESH 0x20 Animesh Read-only flag to query Animated mesh status.
PRIM_SCULPT_FLAG_INVERT 0x40 Invert Render inside out (inverts the normals).
PRIM_SCULPT_FLAG_MIRROR 0x80 Mirror Render an X axis mirror of the sculpty.
hole_shape Flags Shape
PRIM_HOLE_DEFAULT 0x00 Default
PRIM_HOLE_SQUARE 0x20 Square
PRIM_HOLE_CIRCLE 0x10 Circle
PRIM_HOLE_TRIANGLE 0x30 Triangle
PRIM_TYPE top_size and client taper conversion
Range[1] Top
Tapered
No
Tapering
Bottom
Tapered
Client [-1, 1] 1.0 0.0 -1.0
PRIM_TYPE [0, 2] 0.0 1.0 2.0
LEGACY [0, 1] 0.0 1.0 NA
Client < 1.11 [0, 1] 0.0 1.0 NA
3 shape
17 PRIM_TEXTURE PRIM_TEXTURE,
integer face, string texture, vector repeats, vector offsets, float rotation_in_radians ] texture - face
Jive-icon-11x2.png

Used to get or set the texture settings of a prim's face.

• integer face face number or ALL_SIDES
• string texture a texture in the inventory of the prim this script is in or a UUID of a texture
• vector repeats x and y range from 0.0 to 100, or -0.0 to -100 in 0.01 increments. Negative values flip the texture (z is ignored)
• vector offsets x and y range from -1 to 1 (z is ignored)
• float rotation_in_radians angle in radians

Caveats

  • 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.
All Issues ~ Search JIRA for related Bugs

texture Constants

The following constants can (optionally) be used for the texture value: TEXTURE_BLANK, TEXTURE_DEFAULT, TEXTURE_MEDIA, TEXTURE_PLYWOOD and TEXTURE_TRANSPARENT.

Examples

<lsl>llSetPrimitiveParams([ PRIM_TEXTURE, ALL_SIDES, "5748decc-f629-461c-9a36-a35a221fe21f", <1.0, 1.0, 0.0>, <0.0, 0.0, 0.0>, 0.0 ]); llSetPrimitiveParams([ PRIM_TEXTURE, ALL_SIDES, llGetInventoryName(INVENTORY_TEXTURE, 0), <1.0, 1.0, 0.0>, <0.0, 0.0, 0.0>, 0.0 ]);

llSetPrimitiveParams([ PRIM_TEXTURE, 0, TEXTURE_PLYWOOD, <2.0, 5.0, 0.0>, <0.1, 0.2, 0.0>, 1.0 ]);</lsl>
2 texture
User:Strife Onizuka/PRIM TEXTUser:Strife Onizuka/PRIM PHYSICSUser:Strife Onizuka/PRIM PHANTOMUser:Strife Onizuka/PRIM TEMP ON REZUser:Strife Onizuka/PRIM MATERIALUser:Strife Onizuka/PRIM SIZEUser:Strife Onizuka/PRIM POSITIONUser:Strife Onizuka/PRIM ROTATIONUser:Strife Onizuka/PRIM ROT LOCALUser:Strife Onizuka/PRIM FLEXIBLEUser:Strife Onizuka/PRIM POINT LIGHTUser:Strife Onizuka/PRIM TEXGENUser:Strife Onizuka/PRIM COLORUser:Strife Onizuka/PRIM GLOWUser:Strife Onizuka/PRIM FULLBRIGHTUser:Strife Onizuka/PRIM BUMP SHINY
V Request Format Parameters Returned Scope
27 PRIM_NAME PRIM_NAME ]
string name ] name - prim
Jive-icon-11x2.png

Used to get or set the prim's name.

• string name
3 name
28 PRIM_DESC PRIM_DESC ]
string description ] description - prim
Jive-icon-11x2.png

Used to get or set the prim's description.

• string description
3 description
9 PRIM_TYPE PRIM_TYPE ]
integer flag ] + flag_parameters shape - prim
Jive-icon-11x2.png

Gets or sets the type of the prim and associated type flag_parameters.

• integer flag PRIM_TYPE_* flag

• list flag_parameters a list consisting of the parameters for flag
The values that follow after flag, the flag_parameters, are dependent on the value of flag, please refer to the individual PRIM_TYPE_* articles for further information.
flag Constants Additional Return Values
PRIM_TYPE_BOX 0 [ integer hole_shape, vector cut, float hollow, vector twist, vector top_size, vector top_shear ]
PRIM_TYPE_CYLINDER 1 [ integer hole_shape, vector cut, float hollow, vector twist, vector top_size, vector top_shear ]
PRIM_TYPE_PRISM 2 [ integer hole_shape, vector cut, float hollow, vector twist, vector top_size, vector top_shear ]
PRIM_TYPE_SPHERE 3 [ integer hole_shape, vector cut, float hollow, vector twist, vector dimple]
PRIM_TYPE_TORUS 4 [ 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 skew ]
PRIM_TYPE_TUBE 5 [ 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 skew ]
PRIM_TYPE_RING 6 [ 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 skew ]
PRIM_TYPE_SCULPT 7 [ string map, integer type ]
type Flags Style Description
PRIM_SCULPT_TYPE_SPHERE 1 Sphere Converge top & bottom, stitch left side to right
PRIM_SCULPT_TYPE_TORUS 2 Torus Stitch top to bottom, stitch left side to right
PRIM_SCULPT_TYPE_PLANE 3 Plane No stitching or converging
PRIM_SCULPT_TYPE_CYLINDER 4 Cylinder Stitch left side to right.
PRIM_SCULPT_TYPE_MESH 5 Mesh model See: Mesh
PRIM_SCULPT_FLAG_ZZZZZZZZ 63
PRIM_SCULPT_FLAG_ANIMESH 0x20 Animesh Read-only flag to query Animated mesh status.
PRIM_SCULPT_FLAG_INVERT 0x40 Invert Render inside out (inverts the normals).
PRIM_SCULPT_FLAG_MIRROR 0x80 Mirror Render an X axis mirror of the sculpty.
hole_shape Flags Shape
PRIM_HOLE_DEFAULT 0x00 Default
PRIM_HOLE_SQUARE 0x20 Square
PRIM_HOLE_CIRCLE 0x10 Circle
PRIM_HOLE_TRIANGLE 0x30 Triangle
PRIM_TYPE top_size and client taper conversion
Range[1] Top
Tapered
No
Tapering
Bottom
Tapered
Client [-1, 1] 1.0 0.0 -1.0
PRIM_TYPE [0, 2] 0.0 1.0 2.0
LEGACY [0, 1] 0.0 1.0 NA
Client < 1.11 [0, 1] 0.0 1.0 NA
3 shape
17 PRIM_TEXTURE PRIM_TEXTURE, integer face ]
string texture, vector repeats, vector offsets, float rotation_in_radians ] texture - face
Jive-icon-11x2.png

Used to get or set the texture settings of a prim's face.

• integer face face number or ALL_SIDES

• string texture a texture in the inventory of the prim this script is in or a UUID of a texturea texture in the inventory of the prim this script is in or a UUID of a texture
• vector repeats x and y range from 0.0 to 100, or -0.0 to -100 in 0.01 increments. Negative values flip the texture (z is ignored)x and y range from 0.0 to 100, or -0.0 to -100 in 0.01 increments. Negative values flip the texture (z is ignored)
• vector offsets x and y range from -1 to 1 (z is ignored)x and y range from -1 to 1 (z is ignored)
• float rotation_in_radians angle in radiansangle in radians
All Issues ~ Search JIRA for related Bugs
2 texture
#var value
ALL_SIDES ALL_SIDES
p_face_desc face number or ALL_SIDES
p_face_hover face number or ALL_SIDES (-1)
p_boolean_desc TRUE enables, FALSE disables
p_boolean_hover TRUE enables, FALSE disables
p_alpha_desc from 0.0 (clear) to 1.0 (solid) (0.0 <= alpha <= 1.0)
p_alpha_hover from 0.0 (clear) to 1.0 (solid) (0.0 <= alpha <= 1.0)
p_color_desc color in RGB <R, G, B> (<0.0, 0.0, 0.0> = black, <1.0, 1.0, 1.0> = white)
p_color_hover color in RGB <R, G, B> (<0.0, 0.0, 0.0> = black, <1.0, 1.0, 1.0> = white)
facechoise If face is ALL_SIDES then the function works on all sides.
header_footnote
caveats
  • If face is ALL_SIDES then the flag works on all sides.
  • If face indicates a face that does not exist the flag return is nothing.
  • If face is ALL_SIDES then the function works on all sides.
  • If face indicates a face that does not exist the return is [ "", ZERO_VECTOR, ZERO_VECTOR, 0.0 ]
  • If face is ALL_SIDES then the flag works on all sides.
  • If face indicates a face that does not exist the flag return is nothing.
  • If face is ALL_SIDES then the function works on all sides.
  • If face indicates a face that does not exist the return is [ "", ZERO_VECTOR, ZERO_VECTOR, 0.0 ]
notes
spec
deepnotes