Template:LSL Constants/PrimitiveParams

Template:Needs Translation/de Template:Needs Translation/es Template:Needs Translation/el Template:Needs Translation/he Template:Needs Translation/it Template:Needs Translation/ko Template:Needs Translation/nl Template:Needs Translation/hu Template:Needs Translation/no Template:Needs Translation/da Template:Needs Translation/sv Template:Needs Translation/tr Template:Needs Translation/pl Template:Needs Translation/pt Template:Needs Translation/ru Template:Needs Translation/th Template:Needs Translation/uk Template:Needs Translation/zh-Hans Template:Needs Translation/zh-Hant

Flag	V	Description	Usage
PRIM_NAME	27	Sets the prim's name.	[ PRIM_NAME, string name ]
PRIM_DESC	28	Sets the prim's description.	[ PRIM_DESC, string description ]
PRIM_TYPE	9	Sets the prim's shape.	[ PRIM_TYPE, integer flag ] + flag_parameters
PRIM_MATERIAL	2	Sets the prim's material.	[ PRIM_MATERIAL, integer flag ]
PRIM_PHYSICS	3	Sets the object's physics status.	[ PRIM_PHYSICS, integer boolean ]
PRIM_TEMP_ON_REZ	4	Sets the object's temporary attribute.	[ PRIM_TEMP_ON_REZ, integer boolean ]
PRIM_PHANTOM	5	Sets the object's phantom status.	[ PRIM_PHANTOM, integer boolean ]
PRIM_POSITION	6	Sets the prim's position.	[ PRIM_POSITION, vector position ]
PRIM_ROTATION	8	Sets the prim's global rotation.	[ PRIM_ROTATION, rotation rot ]
PRIM_ROT_LOCAL	29	Sets the prim's local rotation.	[ PRIM_ROT_LOCAL, rotation rot ]
PRIM_SIZE	7	Sets the prim's size.	[ PRIM_SIZE, vector size ]
PRIM_TEXTURE	17	Sets the prim's texture attributes.	[ PRIM_TEXTURE, integer face, string texture, vector repeats, vector offsets, float rotation_in_radians ]
PRIM_TEXT	26	Sets the prim's floating text.	[ PRIM_TEXT, string text, vector color, float alpha ]
PRIM_COLOR	18	Sets the face's color.	[ PRIM_COLOR, integer face, vector color, float alpha ]
PRIM_BUMP_SHINY	19	Sets the face's shiny & bump.	[ PRIM_BUMP_SHINY, integer face, integer shiny, integer bump ]
PRIM_POINT_LIGHT	23	Sets the prim as a point light.	[ PRIM_POINT_LIGHT, integer boolean, vector color, float intensity, float radius, float falloff ]
PRIM_FULLBRIGHT	20	Sets the face's full bright flag.	[ PRIM_FULLBRIGHT, integer face, integer boolean ]
PRIM_FLEXIBLE	21	Sets the prim as flexible.	[ PRIM_FLEXIBLE, integer boolean, integer softness, float gravity, float friction, float wind, float tension, vector force ]
PRIM_TEXGEN	22	Sets the face's texture mode.	[ PRIM_TEXGEN, integer face, integer type ]
PRIM_GLOW	25	Sets the face's glow attribute.	[ PRIM_GLOW, integer face, float intensity ]
PRIM_OMEGA	TBD	Makes the object spin at the specified axis and rate. Only on RC BlueSteel as of 2011-06-22	[ PRIM_OMEGA, vector axis, float spinrate, float gain ]
PRIM_CAST_SHADOWS	24	Sets the prim's cast shadow attribute. (DEPRECATED)	[ PRIM_CAST_SHADOWS, integer boolean ]
PRIM_TYPE_LEGACY	1	Sets the prim's shape (legacy mode, DEPRECATED).	[ 1, integer flag ] + flag_parameters

Parameter		Return Values / Additional Parameters		Description
[ PRIM_NAME ]	27	[ string name ]					Name: llGetObjectName / llSetObjectName
[ PRIM_DESC ]	28	[ string description ]					Description: llGetObjectDesc / llSetObjectDesc
[ PRIM_TYPE ]	9	[ integer flag ]		Gets / Sets the prim shape.
		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 ] Sculpted_Prims:_FAQ
				hole_shape Flags		Shape	hole_shape Flags		Shape
				PRIM_HOLE_DEFAULT	0x00	Default	PRIM_HOLE_SQUARE	0x20	Square
				PRIM_HOLE_CIRCLE	0x10	Circle	PRIM_HOLE_TRIANGLE	0x30	Triangle
				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.
[ PRIM_MATERIAL ]	2	[ integer material]		Gets / Sets the prim's material. The material determines the default collision sound & sprite.
		material Flags		Description				Friction	Restitution
		PRIM_MATERIAL_STONE	0	stone				0.8	0.4
		PRIM_MATERIAL_METAL	1	metal				0.3	0.4
		PRIM_MATERIAL_GLASS	2	glass				0.2	0.7
		PRIM_MATERIAL_WOOD	3	wood				0.6	0.5
		PRIM_MATERIAL_FLESH	4	flesh				0.9	0.3
		PRIM_MATERIAL_PLASTIC	5	plastic				0.4	0.7
		PRIM_MATERIAL_RUBBER	6	rubber				0.9	0.9
		PRIM_MATERIAL_LIGHT	7	light, DEPRECATED: Looks the same as [ PRIM_FULLBRIGHT, ALL_SIDES, TRUE ]						0.6	0.5
[ PRIM_PHYSICS ]	3	[ integer boolean ]					Physics status llGetStatus / llSetStatus
[ PRIM_TEMP_ON_REZ ]	4	[ integer boolean ]					Temporary attribute
[ PRIM_PHANTOM ]	5	[ integer boolean ]					Phantom status llGetStatus / llSetStatus
[ PRIM_POSITION ]	6	[ vector position ]					Position, llGetPos / llSetPos
[ PRIM_ROTATION ]	8	[ rotation rot ]					Global rotation, llGetRot / llSetRot (broken for child prims)
[ PRIM_ROT_LOCAL ]	29	[ rotation rot ]					Local rotation, llGetLocalRot / llSetLocalRot
[ PRIM_SIZE ]	7	[ vector size ]					Size, llGetScale / llSetScale
[ PRIM_TEXTURE, integer face ]	17	[ string texture, vector repeats, vector offsets, float rotation_in_radians ]					Texture: llGetTexture llSetTexture Repeats: llGetTextureScale llScaleTexture Offset: llGetTextureOffset llOffsetTexture Rotation: llGetTextureRot llRotateTexture
[ PRIM_TEXT ]	26	[ string text, vector color, float alpha ]					Floating Text: NA / llSetText
[ 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 Flags		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 mode ]
		mode Constants		Description
		PRIM_TEXGEN_DEFAULT	0	The texture repeats units are in texture repeats per face.
		PRIM_TEXGEN_PLANAR	1	The texture repeats units are in texture repeats per half meter. This is in contrast to the in-world editing tool, in which the planar texture scaling units are repeats per meter.
[ PRIM_POINT_LIGHT ]	23	[ integer boolean, vector color, float intensity, float radius, float falloff ]
[ PRIM_GLOW, integer face ]	25	[ float intensity ]
[ PRIM_OMEGA ]	TBD	[ PRIM_OMEGA, vector axis, float spinrate, float gain ]					llTargetOmega
[ PRIM_CAST_SHADOWS ]	24	[ integer boolean ]		DEPRECATED: Shadow casting for the primitive
[ 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

• The prim description is limited to 127 bytes; any string longer then that will be truncated. This truncation does not always happen when the attribute is set or read.
• The pipe character '|' and the newline character '\n' are not legal in a prim's description. They will be replaced with '?'.^[1]
• Note that when people have "Hover Tips on All Objects" selected in the viewer's "View" menu, they'll see the object description pop-up for any object under their mouse pointer. For that reason, it is good practice to only set human-friendly information in the description, e.g. keys and such.
• When an attached object is detached, changes made by script to the name and description (of the root prim) of the attachment will be lost. While the object is attached the name and description can be changed but it will not be reflected in inventory. This caveat does not apply to child prims.
• 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.
• repeats is not only used to set the number of repeats but the sign of the individual components is also used to set the "Flip" attribute.
• In the default texture mapping mode the texture repeats units are in texture repeats per face. In the planar texture mapping mode the texture repeats units are in texture repeats per half meter. This is in contrast to the in-world editing tool, in which the planar texture scaling units are repeats per meter.
• Do not rely on Floating Text as a storage medium; it is neither secure nor finalized.
  • Floating text has been altered in past server updates, breaking existing content; future changes may occur.
  • Even "invisible"^[2] floating text is transmitted to the client.
    • It can be viewed by anyone with a client that is capable of rendering text that is supposed to be invisible.
    • The network packets that contain the text can be sniffed and the text read.
• top_size and client values are different, the ranges do not line up, conversion is required. This simple equation can be used: answer = 1.0 - value. See top_size Explained for more information.
• PRIM_OMEGA on nonphysical objects, and child prims of physical objects, is only a client side effect; the object or prim will collide as non-moving geometry.
• PRIM_OMEGA cannot be used on avatars sitting on the object. It will emit the error message "PRIM_OMEGA disallowed on agent".
• If PRIM_OMEGA does not appear to be working, make sure that that Develop > Network > Velocity Interpolate Objects is enabled on the viewer.
• In the parameters returned by llGetPrimitiveParams([PRIM_OMEGA]), the vector is normalized, and the spinrate is multiplied by the magnitude of the original vector.
• PRIM_PHANTOM, PRIM_PHYSICS and PRIM_TEMP_ON_REZ applies to the entire object (linkset).
• Values may drift, become truncated or be range limited. Some limits are applied by the client during deserialization before rendering, others are applied by the simulator before storing the values.
  • When testing vectors and rotations use llVecDist and llAngleBetween (respectively) to perform fuzzy tests.
• If face is ALL_SIDES then the flag works on all sides.
• If face indicates a face that does not exist the flag returns nothing.