V
|
Flag
|
|
Parameters Returned
|
Scope
|
27
|
PRIM_NAME
|
[ PRIM_NAME,
|
|
|
|
Used to get or set the prim's name.
|
|
3 name
|
28
|
PRIM_DESC
|
[ PRIM_DESC,
|
string description ]
|
description - prim
|
|
|
|
Used to get or set the prim's description.
|
|
3 description
|
9
|
PRIM_TYPE
|
[ PRIM_TYPE,
|
integer flag ] + flag_parameters
|
shape - prim
|
|
|
|
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
- Depending upon the situation position may need to be in local coordinates or region coordinates, See llSetPos#Specification for details.
- It is usually not a good idea to combine PRIM_POSITION with LINK_SET. The root will treat the coordinates as world or attachment, while the children will treat them as local, yielding inconsistent results or failure. If you want to move the object as a unit, use LINK_ROOT instead.
- The range the prim can move is limited if it is an unattached root prim. The distance is capped to 10m per PRIM_POSITION call. See WarpPos. This is a very special case. Do not rely on rule duplication of other flags - the results are undefined, and things will break in the future.
- Moving avatars with PRIM_POSITION
- Moving the prim the avatar sat upon does not move the avatar.
- Moving an avatar does not move the prim they sat upon.
- Sit-target coordinates do not easily map to prim coordinates, use UpdateSitTarget.
- If you have explicitally set your object as "static obstacle" for pathfinding , the function will fail with the error in the debug channel : "Unable to set prim position or scale: object contributes to the navmesh."
- If position is greater than 54 meters away from the center, the repositioning will silently fail.
- PRIM_TYPE can only be used with LINK_SET if the object contains 10 or fewer prims. It can only be used with LINK_ALL_OTHERS or LINK_ALL_CHILDREN if the object contains 11 or fewer prims. If there are more prims, the operation will fail and an error will be shouted to DEBUG_CHANNEL. Work around this by looping through the prims with llSetLinkPrimitiveParamsFast.
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 ]
|
PRIM_TYPE top_size and client taper conversion
|
Range
|
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
|
2
|
PRIM_MATERIAL
|
[ PRIM_MATERIAL,
|
|
3 material
|
3
|
PRIM_PHYSICS
|
[ PRIM_PHYSICS,
|
integer boolean ] ]
|
physics status - object
|
|
|
|
|
|
4 status physics
|
4
|
PRIM_TEMP_ON_REZ
|
[ PRIM_TEMP_ON_REZ,
|
integer boolean ] ]
|
temporary - object
|
|
|
|
|
|
4 temporary
|
5
|
PRIM_PHANTOM
|
[ PRIM_PHANTOM,
|
integer boolean ] ]
|
phantom status - object
|
|
|
|
|
|
4 status phantom
|
6
|
PRIM_POSITION
|
[ PRIM_POSITION,
|
vector position ] ]
|
position - prim
|
|
|
|
|
|
3 position
|
8
|
PRIM_ROTATION
|
[ PRIM_ROTATION,
|
|
3 rotation global
|
29
|
PRIM_ROT_LOCAL
|
[ PRIM_ROT_LOCAL,
|
|
3 rotation local
|
7
|
PRIM_SIZE
|
[ PRIM_SIZE,
|
|
3 size
|
17
|
PRIM_TEXTURE
|
[ PRIM_TEXTURE,
|
|
2 texture
|
26
|
PRIM_TEXT
|
[ PRIM_TEXT,
|
|
3 floating text
|
18
|
PRIM_COLOR
|
[ PRIM_COLOR,
|
|
2 color & alpha
|
19
|
PRIM_BUMP_SHINY
|
[ PRIM_BUMP_SHINY,
|
|
2 shiny & bump
|
23
|
PRIM_POINT_LIGHT
|
[ PRIM_POINT_LIGHT,
|
|
3 point light
|
20
|
PRIM_FULLBRIGHT
|
[ PRIM_FULLBRIGHT,
|
|
2 full bright
|
21
|
PRIM_FLEXIBLE
|
[ PRIM_FLEXIBLE,
|
|
3 flexible
|
22
|
PRIM_TEXGEN
|
[ PRIM_TEXGEN,
|
|
|
|
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.
|
|
|
2 texture mode
|
25
|
PRIM_GLOW
|
[ PRIM_GLOW,
|
|
2 glow
|
24
|
PRIM_CAST_SHADOWS
|
[ PRIM_CAST_SHADOWS,
|
integer boolean ] ]
|
(DEPRECATED) - cast shadow - prim
|
|
|
|
|
|
3 cast shadow *
|
1
|
PRIM_TYPE_LEGACY
|
PRIM_TYPE_LEGACY [ 1,
|
integer flag ] + flag_parameters ]
|
(DEPRECATED) - shape - prim
|
|
|
|
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 ]
|
|
|
3 shape legacy mode
|