Difference between revisions of "Template:LSL Constants/PrimitiveParams"

From Second Life Wiki
Jump to navigation Jump to search
Line 1: Line 1:
{{{!}} {{Prettytable}} {{#ifeq:{{NAMESPACE}}|Template||{{LSLC|Light}}}} {{#vardefine:p_hole_shape_desc|PRIM_HOLE_* flag}} {{#vardefine:p_cut_desc|x and y range from 0.0 to 1.0, x must be at least 0.05 smaller than y (z is ignored)}} {{#vardefine:p_hollow_desc|ranges from 0.0 (solid) to 0.95 (maximum hollowed)}} {{#vardefine:p_twist_box_desc|ranges from -0.5 (-180 degree in the edit window) to 0.5 (+180 degree in the edit window) for both x and y (z is ignored)}} {{#vardefine:p_twist_torus_desc|ranges from -1.0 (-360 degree in the edit window) to 1.0 (+360 degree in the edit window) for both x and y (z is ignored)}} {{#vardefine:p_hole_size_desc|x ranges from 0.05 to 1.0; y ranges from 0.05 (large hole) to 0.50 (no hole)}} {{#vardefine:p_top_size_desc|ranges from 0.0 to 2.0 for both x and y (z is ignored)}} {{#vardefine:p_top_shear_desc|ranges from -0.5 to 0.5 for both x and y (z is ignored)}} {{#vardefine:p_taper_desc|ranges from -1.0 to 1.0 for both x and y (z is ignored)}} {{#vardefine:p_revolutions_desc|ranges from 1.0 to 4.00}} {{#vardefine:p_radius_offset_desc|depends on holesize y and revolutions}} {{#vardefine:p_skew_desc|ranges from -1.0 to 1.0}} {{#vardefine:p_id_desc|}} {{#vardefine:p_repeats_desc|x and y range from 0.0 to 100, in 0.01 increments (z is ignored)}} {{#vardefine:p_offsets_desc|x and y range from -1 to 1 (z is ignored)}} {{#vardefine:p_flex_float_desc|ranges from 0.0 to 10.0}} {{#vardefine:p_twist_end_desc|ranges from -0.5 (-180 degree in the edit window) to 0.5 (+180 degree in the edit window)}} {{#vardefine:p_hole_size_y_desc|ranges from 0.05 (large hole) to 0.50 (no hole)}} {{#vardefine:p_topshear_x_desc|ranges from 0.05 to 0.50}} {{#vardefine:p_boolean_desc|TRUE (enables) or FALSE (disables)}} {{LSL_Function/color|color}} {{LSL_Function/alpha|alpha}} {{LSL_Function/face|face|flag}} {{LSL_Function/inventory|id|uuid=true|type=texture|{{#ifeq:{{{1|}}}|get|no_caveat=true}}}} {{#vardefine:p_rotation_in_radians_desc|}} {{#vardefine:p_force_desc|}} {{#vardefine:p_intensity_desc|}} {{#vardefine:p_radius_desc|}} {{#vardefine:p_falloff_desc|}}  
{{{!}} {{Prettytable}} {{#switch:{{NAMESPACE}}|Template=|User=|{{LSLC|Light}}}}
{{#if:
{{#vardefine:p_hole_shape_desc|PRIM_HOLE_* flag}}
{{#vardefine:p_cut_desc|x and y range from 0.0 to 1.0, x must be at least 0.05 smaller than y (z is ignored)}}
{{#vardefine:p_hollow_desc|ranges from 0.0 (solid) to 0.95 (maximum hollowed)}}
{{#vardefine:p_twist_box_desc|ranges from -0.5 (-180 degree in the edit window) to 0.5 (+180 degree in the edit window) for both x and y (z is ignored)}}
{{#vardefine:p_twist_torus_desc|ranges from -1.0 (-360 degree in the edit window) to 1.0 (+360 degree in the edit window) for both x and y (z is ignored)}}
{{#vardefine:p_hole_size_desc|x ranges from 0.05 to 1.0; y ranges from 0.05 (large hole) to 0.50 (no hole)}} {{#vardefine:p_top_size_desc|ranges from 0.0 to 2.0 for both x and y (z is ignored)}} {{#vardefine:p_top_shear_desc|ranges from -0.5 to 0.5 for both x and y (z is ignored)}}
{{#vardefine:p_taper_desc|ranges from -1.0 to 1.0 for both x and y (z is ignored)}}
{{#vardefine:p_revolutions_desc|ranges from 1.0 to 4.00}}
{{#vardefine:p_radius_offset_desc|depends on holesize y and revolutions}}
{{#vardefine:p_skew_desc|ranges from -1.0 to 1.0}}
{{#vardefine:p_id_desc|}}
{{#vardefine:p_repeats_desc|x and y range from 0.0 to 100, in 0.01 increments (z is ignored)}}
{{#vardefine:p_offsets_desc|x and y range from -1 to 1 (z is ignored)}}
{{#vardefine:p_flex_float_desc|ranges from 0.0 to 10.0}}
{{#vardefine:p_twist_end_desc|ranges from -0.5 (-180 degree in the edit window) to 0.5 (+180 degree in the edit window)}}
{{#vardefine:p_hole_size_y_desc|ranges from 0.05 (large hole) to 0.50 (no hole)}}
{{#vardefine:p_size_desc|ranges from 0.01 to 10.0 for x, y and z}}
{{#vardefine:p_rot_desc|any valid rotation}}
{{#vardefine:p_topshear_x_desc|ranges from 0.05 to 0.50}}
{{#vardefine:p_boolean_desc|TRUE (enables) or FALSE (disables)}}
{{LSL_Function/color|color}}
{{LSL_Function/alpha|alpha}}
{{LSL_Function/face|face|flag|return={{#ifeq:{{{1|get}}}|get|...
:{{{!}}{{Prettytable}}
{{!}}-{{Hl2}}
!{{HoverText|flag|PRIM_* flag}}
!Return if face is invalid
{{!}}-
{{!!}} [ [[PRIM_TEXTURE]] ] {{!!}} [ {{HoverText|""|string id}}, {{HoverLink|ZERO_VECTOR|{{LSL VR|0.0|0.0|0.0}} vector repeats}}, {{HoverLink|ZERO_VECTOR|{{LSL VR|0.0|0.0|0.0}} vector offsets}}, {{HoverText|0.0|float rotation_in_radians}} ]
{{!}}-
{{!!}} [ [[PRIM_COLOR]] ] {{!!}} [ {{HoverLink|ZERO_VECTOR|{{LSL VR|0.0|0.0|0.0}} vector color}}, {{HoverText|0.0|float alpha}} ]
{{!}}-
{{!!}} [ [[PRIM_BUMP_SHINY]] ] {{!!}} [ {{HoverLink|PRIM_SHINY_NONE|(0) integer shiny}}, {{HoverLink|PRIM_BUMP_NONE|(0) integer bump}} ]
{{!}}-
{{!!}} [ [[PRIM_FULLBRIGHT]] ] {{!!}} [ {{HoverLink|FALSE|(0) integer boolean}} ]
{{!}}-
{{!!}} [ [[PRIM_TEXGEN]] ] {{!!}} [ {{HoverLink|PRIM_TEXGEN_DEFAULT|(0) integer type}} ]
{{!}}}
}}}}
{{LSL_Function/inventory|id|uuid=true|type=texture|{{#ifeq:{{{1|}}}|get|no_caveat=true}}|full={{{remote|}}}}}
{{#vardefine:p_rotation_in_radians_desc|}}
{{#vardefine:p_force_desc|}}
{{#vardefine:p_intensity_desc|}}
{{#vardefine:p_radius_desc|}}
{{#vardefine:p_falloff_desc|}} }}
{{!}}- {{Hl2}}
{{!}}- {{Hl2}}
! colspan="2" {{!}} Parameter
! colspan="2" {{!}} Parameter
Line 66: Line 112:
{{!}} colspan="6" {{!}} {{GetSet|{{{1|}}}|Gets|Sets}} the prim's material. The material determines the default [[llCollisionSound|collision sound]] & [[llCollisionSprite|sprite]].
{{!}} colspan="6" {{!}} {{GetSet|{{{1|}}}|Gets|Sets}} the prim's material. The material determines the default [[llCollisionSound|collision sound]] & [[llCollisionSprite|sprite]].
{{!}}-
{{!}}-
! colspan="2" {{!}} {{HoverText|flag|PRIM_TYPE_* flag}} Constants
! colspan="2" {{!}} {{HoverText|flag|PRIM_MATERIAL_* flag}} Constants
! colspan="6" {{!}} Flag Description
! colspan="6" {{!}} Flag Description
{{!}}-
{{!}}-
Line 155: Line 201:
{{!}}}
{{!}}}
{{!}}-
{{!}}-
{{!}} rowspan="23" {{!}} [ [[PRIM_BUMP_SHINY]], [[integer]] {{LSL Param|face}} ]
{{!}} rowspan="25" {{!}} [ [[PRIM_BUMP_SHINY]], [[integer]] {{LSL Param|face}} ]
{{!}} rowspan="23" {{!}} 19
{{!}} rowspan="25" {{!}} 19
{{!}} colspan="5" {{!}} [ [[integer]] {{HoverText|shiny|PRIM_SHINY_* flag}}, [[integer]] {{HoverText|bump|PRIM_BUMP_* flag}} ]
{{!}} colspan="5" {{!}} [ [[integer]] {{HoverText|shiny|PRIM_SHINY_* flag}}, [[integer]] {{HoverText|bump|PRIM_BUMP_* flag}} ]
{{!}} colspan="3" {{!}}  
{{!}} colspan="3" {{!}}
{{!}}-
! colspan="2" {{!}} {{HoverText|shiny|PRIM_SHINY_* flag}} & {{HoverText|bump|PRIM_BUMP_* flag}} Constants
! colspan="6" {{!}} Description
{{!}}-
{{!}}-
{{!}} [[PRIM_SHINY_NONE]]
{{!}} [[PRIM_SHINY_NONE]]
Line 175: Line 224:
{{!}} 3
{{!}} 3
{{!}} colspan="6" {{!}} high
{{!}} colspan="6" {{!}} high
{{!}}-
{{!}}
{{!}}
{{!}} colspan="6" {{!}}
{{!}}-
{{!}}-
{{!}} [[PRIM_BUMP_NONE]]
{{!}} [[PRIM_BUMP_NONE]]
Line 182: Line 235:
{{!}} [[PRIM_BUMP_BRIGHT]]
{{!}} [[PRIM_BUMP_BRIGHT]]
{{!}} 1
{{!}} 1
{{!}} colspan="6" {{!}} brightness: generate bump map from highlights
{{!}} colspan="6" {{!}} brightness: generate from highlights
{{!}}-
{{!}}-
{{!}} [[PRIM_BUMP_DARK]]
{{!}} [[PRIM_BUMP_DARK]]
{{!}} 2
{{!}} 2
{{!}} colspan="6" {{!}} darkness: generate bump map from lowlights
{{!}} colspan="6" {{!}} darkness: generate from lowlights
{{!}}-
{{!}}-
{{!}} [[PRIM_BUMP_WOOD]]
{{!}} [[PRIM_BUMP_WOOD]]
Line 226: Line 279:
{{!}} [[PRIM_BUMP_BLOBS]]
{{!}} [[PRIM_BUMP_BLOBS]]
{{!}} 12
{{!}} 12
{{!}} colspan="6" {{!}} petridish: blobby amoebalike shapes
{{!}} colspan="6" {{!}} petridish: blobby amoeba like shapes
{{!}}-
{{!}}-
{{!}} [[PRIM_BUMP_SIDING]]
{{!}} [[PRIM_BUMP_SIDING]]
Line 277: Line 330:
{{!}}-
{{!}}-
{{#ifeq:{{{1|set}}}|set|
{{#ifeq:{{{1|set}}}|set|
{{!}} rowspan="7" {{!}} [ 1 ]<br/><s>PRIM_TYPE_LEGACY</s>
{{!}} rowspan="8" {{!}} [ 1 ]<br/><s>PRIM_TYPE_LEGACY</s>
{{!}} rowspan="7" {{!}} 1
{{!}} rowspan="8" {{!}} 1
{{!}} colspan="8" {{!}} [ [[integer]]&nbsp;{{HoverText|flag|PRIM_TYPE_* flag}}, paramaters ]
{{!}} colspan="8" {{!}} [ [[integer]]&nbsp;{{HoverText|flag|PRIM_TYPE_* flag}}, paramaters ]
{{!}}-
! colspan="2" {{!}} {{HoverText|flag|PRIM_TYPE_* flag}} Constants
! colspan="6" {{!}} Flag Parameters
{{!}}-
{{!}}-
{{!}} {{!}} [[PRIM_TYPE_BOX]]
{{!}} {{!}} [[PRIM_TYPE_BOX]]

Revision as of 08:06, 30 April 2007

Parameter Additional Parameters Description
PRIM_TYPE ] 9 [ integer flag ] Gets / Sets the prim shape.
flag Constants 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 ]
  hole_shape Constants Shape hole_shape Constants Shape
PRIM_HOLE_DEFAULT 0x0 Default PRIM_HOLE_SQUARE 0x20 Square
PRIM_HOLE_CIRCLE 0x10 Circle PRIM_HOLE_TRIANGLE 0x30 Triangle
PRIM_MATERIAL ] 2 [ integer flag] Gets / Sets the prim's material. The material determines the default collision sound & sprite.
flag Constants Flag Description
PRIM_MATERIAL_STONE 0 stone
PRIM_MATERIAL_METAL 1 metal
PRIM_MATERIAL_GLASS 2 glass
PRIM_MATERIAL_WOOD 3 wood
PRIM_MATERIAL_FLESH 4 flesh
PRIM_MATERIAL_PLASTIC 5 plastic
PRIM_MATERIAL_RUBBER 6 rubber
PRIM_MATERIAL_LIGHT 7 light, DEPRECATED: Looks the same as [ PRIM_FULLBRIGHT, ALL_SIDES, TRUE ]
PRIM_PHYSICS ] 3 [ integer boolean ] Physics status llGetStatus / llSetStatus
PRIM_TEMP_ON_REZ ] 4 [ integer boolean ] Temp on rez status llGetStatus / llSetStatus
PRIM_PHANTOM ] 5 [ integer boolean ] Phantom status llGetStatus / llSetStatus
PRIM_POSITION ] 6 [ vector position ] Position, llGetPos / llSetPos
PRIM_ROTATION ] 8 [ rotation rot ] Rotation, llGetRot / llSetRot
PRIM_SIZE ] 7 [ vector size ] Size, llGetScale / llSetScale
PRIM_TEXTURE, integer face ] 17 [ string id, vector repeats, vector offsets, float rotation_in_radians ]
Texture: llGetTexture llSetTexture
Repeats: llGetTextureScale llScaleTexture
Offset: llGetTextureOffset llOffsetTexture
Rotation: llGetTextureRot llRotateTexture
PRIM_COLOR, integer face ] 18 [ vector color, float alpha ]
Alpha: llGetAlpha llSetAlpha
Color: llGetColor llSetColor
PRIM_BUMP_SHINY, integer face ] 19 [ integer shiny, integer bump ]
shiny & bump Constants Description
PRIM_SHINY_NONE 0 none
PRIM_SHINY_LOW 1 low
PRIM_SHINY_MEDIUM 2 medium
PRIM_SHINY_HIGH 3 high
PRIM_BUMP_NONE 0 none: no bump map
PRIM_BUMP_BRIGHT 1 brightness: generate from highlights
PRIM_BUMP_DARK 2 darkness: generate from lowlights
PRIM_BUMP_WOOD 3 woodgrain
PRIM_BUMP_BARK 4 bark
PRIM_BUMP_BRICKS 5 bricks
PRIM_BUMP_CHECKER 6 checker
PRIM_BUMP_CONCRETE 7 concrete
PRIM_BUMP_TILE 8 crustytile
PRIM_BUMP_STONE 9 cutstone: blocks
PRIM_BUMP_DISKS 10 discs: packed circles
PRIM_BUMP_GRAVEL 11 gravel
PRIM_BUMP_BLOBS 12 petridish: blobby amoeba like shapes
PRIM_BUMP_SIDING 13 siding
PRIM_BUMP_LARGETILE 14 stonetile
PRIM_BUMP_STUCCO 15 stucco
PRIM_BUMP_SUCTION 16 suction: rings
PRIM_BUMP_WEAVE 17 weave
PRIM_FULLBRIGHT, integer face ] 20 [ integer boolean ]
PRIM_FLEXIBLE ] 21 [ integer boolean, integer softness, float gravity, float friction, float wind, float tension, vector force ]
PRIM_TEXGEN, integer face ] 22 [ integer type ]
PRIM_TEXGEN_DEFAULT 0
PRIM_TEXGEN_PLANAR 1
PRIM_POINT_LIGHT ] 23 [ integer boolean, vector color, float intensity, float radius, float falloff ]
[ 1 ]
PRIM_TYPE_LEGACY
1 [ integer flag, paramaters ]
flag Constants Flag Parameters
PRIM_TYPE_BOX 0 [ vector cut, float hollow, float twist_end, vector top_size, vector top_shear ]
PRIM_TYPE_CYLINDER 1 [ vector cut, float hollow, float twist_end, vector top_size, vector top_shear ]
PRIM_TYPE_PRISM 2 [ vector cut, float hollow, float twist_end, vector top_size, vector top_shear ]
PRIM_TYPE_SPHERE 3 [ vector cut, float hollow, vector dimple ]
PRIM_TYPE_TORUS 4 [ vector cut, float hollow, float twist_end, float hole_size_y, vector top_shear, vector advanced_cut ]
PRIM_TYPE_TUBE 5 [ vector cut, float hollow, float twist_end, float topshear_x ]

Caveats

  • If face indicates a face that does not exist the flag return is ...
flag Return if face is invalid
[ PRIM_TEXTURE ] [ "", ZERO_VECTOR, ZERO_VECTOR, 0.0 ]
[ PRIM_COLOR ] [ ZERO_VECTOR, 0.0 ]
[ PRIM_BUMP_SHINY ] [ PRIM_SHINY_NONE, PRIM_BUMP_NONE ]
[ PRIM_FULLBRIGHT ] [ FALSE ]
[ PRIM_TEXGEN ] [ PRIM_TEXGEN_DEFAULT ]
  • If id 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 id 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.