Difference between revisions of "User:Strife Onizuka/PrimitiveParamsTable"

From Second Life Wiki
Jump to navigation Jump to search
m
 
(No difference)

Latest revision as of 19:34, 8 August 2013

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

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.


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
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