|
|
Line 1: |
Line 1: |
| {{#if: | | <noinclude>__NOTOC__</noinclude>{{#if: |
|
| |
|
| <!-- TRM push --> | | <!-- TRM push --> |
Revision as of 00:45, 19 November 2010
{| class="sortable" width="100%" border="2" cellspacing="0" cellpadding="3" rules="all" style="margin:1em 1em 1em 0; border:solid 1px #AAAAAA; border-collapse:collapse; background-color:#F9F9F9; font-size:90%; empty-cells:show; margin: 0px 0px 10px 1pt;"
|- bgcolor="#00bfff" style="white-space:nowrap;"
! class="sortable" title="Value" style="cursor: help;" |V
! class="sortable" | Flag
! class="unsortable" style="display:none;" |
! class="unsortable" width="70%" | Parameters Returned
! class="sortable" width="30%" | Scope
|-
|- valign="top"
| style="text-align:center;" | 27
| style="display:none;" | PRIM_NAME
| style="text-align:right;" | [ PRIM_NAME,
| colspan="2" |
|
|
|
Used to get or set the prim's name.
|
| style="display:none;" | 3 name
|-
|- valign="top"
| style="text-align:center;" | 28
| style="display:none;" | PRIM_DESC
| style="text-align:right;" | [ PRIM_DESC,
| colspan="2" |
string description ]
|
description - prim
|
|
|
|
Used to get or set the prim's description.
|
| style="display:none;" | 3 description
|-
|- valign="top"
| style="text-align:center;" | 9
| style="display:none;" | PRIM_TYPE
| style="text-align:right;" | [ PRIM_TYPE,
| colspan="2" |
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 All Issues ~ Search JIRA for related Bugs
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
|
|
| style="display:none;" | 3 shape
|-
|- valign="top"
| style="text-align:center;" | 17
| style="display:none;" | PRIM_TEXTURE
| style="text-align:right;" | [ PRIM_TEXTURE,
| colspan="2" |
|
|
|
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.
All Issues ~ Search JIRA for related Bugs
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>
|
| style="display:none;" | 2 texture
|-
|-
|}
V
|
Request Format
|
|
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 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 ]
|
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
|
17
|
PRIM_TEXTURE
|
[ PRIM_TEXTURE, integer face ]
|
|
|
|
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
|
|
All Issues ~ Search JIRA for related Bugs
|
|
2 texture
|