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

From Second Life Wiki
Jump to navigation Jump to search
m
m
Line 59: Line 59:
{{User:Strife_Onizuka/PRIM_DESC|{{#var:PPC-1}}}}
{{User:Strife_Onizuka/PRIM_DESC|{{#var:PPC-1}}}}
{{User:Strife_Onizuka/PRIM_TYPE|{{#var:PPC-1}}}}
{{User:Strife_Onizuka/PRIM_TYPE|{{#var:PPC-1}}}}
{{User:Strife_Onizuka/PRIM_TEXTURE|{{#var:PPC-1}}}}
<!--{{PPC|{{{1|}}}|PRIM_MATERIAL|const={{#var:material_const}}|value=2|scope=prim|attr=material|[[integer]]&nbsp;{{HoverText|flag|PRIM_MATERIAL_* flag}}&nbsp;]|content={{PBR}}
<!--{{PPC|{{{1|}}}|PRIM_MATERIAL|const={{#var:material_const}}|value=2|scope=prim|attr=material|[[integer]]&nbsp;{{HoverText|flag|PRIM_MATERIAL_* flag}}&nbsp;]|content={{PBR}}
{{LSL Constants/PrimitiveParams/materials|{{{1|}}}|style=margin:0 0 0 0; padding:0;|table=*|sortable=*}} }}
{{LSL Constants/PrimitiveParams/materials|{{{1|}}}|style=margin:0 0 0 0; padding:0;|table=*|sortable=*}} }}
Line 68: Line 69:
{{PPC|{{{1|}}}|PRIM_ROT_LOCAL|const={{#var:rot_local_const}}|value=29|scope=prim|qualifier=rotation|attr=local|[[rotation]]&nbsp;{{LSL Param|rot}}&nbsp;]|content=}}
{{PPC|{{{1|}}}|PRIM_ROT_LOCAL|const={{#var:rot_local_const}}|value=29|scope=prim|qualifier=rotation|attr=local|[[rotation]]&nbsp;{{LSL Param|rot}}&nbsp;]|content=}}
{{PPC|{{{1|}}}|PRIM_SIZE|const={{#var:size_const}}|value=7|scope=prim|attr=size|[[vector]]&nbsp;{{LSL Param|size}}&nbsp;]|content=}}
{{PPC|{{{1|}}}|PRIM_SIZE|const={{#var:size_const}}|value=7|scope=prim|attr=size|[[vector]]&nbsp;{{LSL Param|size}}&nbsp;]|content=}}
{{PPC|{{{1|}}}|PRIM_TEXTURE|const={{#var:texture_const}}|required=[[integer]]&nbsp;{{LSL Param|face}}|value=17|scope=face|attr=texture|[[string]]&nbsp;{{LSL Param|texture}}, [[vector]]&nbsp;{{LSL Param|repeats}}, [[vector]]&nbsp;{{LSL Param|offsets}}, [[float]]&nbsp;{{LSL Param|rotation_in_radians}}&nbsp;]|content=}}
{{PPC|{{{1|}}}|PRIM_TEXT|const={{#var:text_const}}|value=26|scope=prim|attr=floating text|[[string]]&nbsp;{{LSL Param|text}}, [[vector]]&nbsp;{{LSL Param|color}}, [[float]]&nbsp;{{LSL Param|alpha}}&nbsp;]|content=}}
{{PPC|{{{1|}}}|PRIM_TEXT|const={{#var:text_const}}|value=26|scope=prim|attr=floating text|[[string]]&nbsp;{{LSL Param|text}}, [[vector]]&nbsp;{{LSL Param|color}}, [[float]]&nbsp;{{LSL Param|alpha}}&nbsp;]|content=}}
{{PPC|{{{1|}}}|PRIM_COLOR|const={{#var:color_const}}|required=[[integer]]&nbsp;{{LSL Param|face}}|value=18|scope=face|attr=color & alpha|[[vector]]&nbsp;{{LSL Param|color}}, [[float]]&nbsp;{{LSL Param|alpha}}&nbsp;]|content=}}
{{PPC|{{{1|}}}|PRIM_COLOR|const={{#var:color_const}}|required=[[integer]]&nbsp;{{LSL Param|face}}|value=18|scope=face|attr=color & alpha|[[vector]]&nbsp;{{LSL Param|color}}, [[float]]&nbsp;{{LSL Param|alpha}}&nbsp;]|content=}}

Revision as of 00:31, 19 November 2010

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