Difference between revisions of "PRIM POSITION"
Jump to navigation
Jump to search
m |
m (hovertext) |
||
| Line 3: | Line 3: | ||
{{#vardefine:position_const|{{LSL Const|PRIM_POSITION|integer|6|c=Used to {{GetSet|{{{1|}}}|get|set|/}} the prim's position}}}} | {{#vardefine:position_const|{{LSL Const|PRIM_POSITION|integer|6|c=Used to {{GetSet|{{{1|}}}|get|set|/}} the prim's position}}}} | ||
{{#vardefine: | {{#vardefine:p_positionget_desc|position in [[Viewer_coordinate_frames#region|region coordinates]].}} | ||
{{#vardefine:p_positionget_hover|position in region coordinates.}} | |||
{{#vardefine:caveats-set|{{#ifeq:{{{1|}}}|set|**|*}} Depending upon the situation '''position''' may need to be in [[Viewer_coordinate_frames#local|local coordinates]] or [[Viewer_coordinate_frames#region|region coordinates]], See [[llSetPos#Specification]] for details. | {{#vardefine:p_positionset_desc|position in [[Viewer_coordinate_frames#local|local]] or [[Viewer_coordinate_frames#region|regional]] coordinates depending upon the situation.}} | ||
{{#vardefine:p_positionset_hover|position in local or regional coordinates depending upon the situation.}} | |||
{{#vardefine:caveats-get|* '''{{LSL Param|positionget|position}}''' is always in [[Viewer_coordinate_frames#region|region coordinates]], even if the prim is a child or the root prim of an [[attachment]].}} | |||
{{#vardefine:caveats-set|{{#ifeq:{{{1|}}}|set|**|*}} Depending upon the situation '''{{LSL Param|positionset|position}}''' may need to be in [[Viewer_coordinate_frames#local|local coordinates]] or [[Viewer_coordinate_frames#region|region coordinates]], See [[llSetPos#Specification]] for details. | |||
{{#ifeq:{{{1|}}}|set|**|*}} The range the prim can move is limited if it is an unattached root prim. The distance is capped to 10m per {{#var:position_const}} 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. | {{#ifeq:{{{1|}}}|set|**|*}} The range the prim can move is limited if it is an unattached root prim. The distance is capped to 10m per {{#var:position_const}} 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. | ||
{{#ifeq:{{{1|}}}|set|**|*}} Moving a prim that an avatar is seated upon will not move the avatar; the sit target will not be updated. | {{#ifeq:{{{1|}}}|set|**|*}} Moving a prim that an avatar is seated upon will not move the avatar; the sit target will not be updated. | ||
| Line 13: | Line 20: | ||
{{#ifeq:{{{1|}}}|set|***|**}} Moving an avatar does not move the prim they sat upon. | {{#ifeq:{{{1|}}}|set|***|**}} Moving an avatar does not move the prim they sat upon. | ||
{{#ifeq:{{{1|}}}|set|***|**}} Sit-target coordinates do not easily map to prim coordinates, use [[llSitTarget#Useful_Snippets|UpdateSitTarget]]. | {{#ifeq:{{{1|}}}|set|***|**}} Sit-target coordinates do not easily map to prim coordinates, use [[llSitTarget#Useful_Snippets|UpdateSitTarget]]. | ||
{{#ifeq:{{{1|}}}|set|***|**}} If '''position''' is greater than 54 meters away from the center, the repositioning will silently fail.}} | {{#ifeq:{{{1|}}}|set|***|**}} If '''{{LSL Param|positionset|position}}''' is greater than 54 meters away from the center, the repositioning will silently fail.}} | ||
{{#vardefine:caveats| | {{#vardefine:caveats| | ||
| Line 23: | Line 30: | ||
|#default={{#var:caveats}} | |#default={{#var:caveats}} | ||
}}}} | }}}} | ||
{{#vardefine:PRIM_POSITION/SLPP&A| | {{#vardefine:PRIM_POSITION/SLPP&A| | ||
Revision as of 10:06, 2 March 2010
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Description
Constant: integer PRIM_POSITION = 6;The integer constant PRIM_POSITION has the value 6
PRIM_POSITION is used to get or set the prim's position.
llSetPrimitiveParams
llSetPrimitiveParams([ ..., PRIM_POSITION, vector position, ... ]);| • vector | position | – | position in local or regional coordinates depending upon the situation. |
The same syntax applies to llSetLinkPrimitiveParams, but with the addition of a link parameter.
Caveats
- Depending upon the situation position may need to be in local coordinates or region coordinates, See llSetPos#Specification for details.
- 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 a prim that an avatar is seated upon will not move the avatar; the sit target will not be updated.
- To mimic updating of a sit-target, use UpdateSitTarget.
- 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 position is greater than 54 meters away from the center, the repositioning will silently fail.
Avatars
Avatars sitting on the object can be moved with llSetLinkPrimitiveParams and PRIM_POSITION. This was originally a mis-feature but according to Andrew Linden LL has decided to support it.
Examples
The below example moves an avatar to x,y,z without moving the prim they are sitting on. If x,y,z is more than 54 meters away the call will silently fail. Remember x,y,z is in object relative coordinates just like any other linked prim in a set.
Avatars are always the last prims in the set, so llGetNumberOfPrims can be used for a single avatar sitting on a vehicle.
Example: <lsl>llSetLinkPrimitiveParams(llGetNumberOfPrims(), [PRIM_POSITION, <x,y,z>]);</lsl>
llGetPrimitiveParams
llGetPrimitiveParams([ ..., PRIM_POSITION, ... ]);Returns the list [ vector position ]
| • vector | position | – | position in region coordinates. |
Caveats
- position is always in region coordinates, even if the prim is a child or the root prim of an attachment.
Caveats
Related Articles
Constants
| • | PRIM_ROTATION |
Functions
| • | llGetPrimitiveParams | |||
| • | llSetPrimitiveParams | |||
| • | llSetLinkPrimitiveParams | |||
| • | llGetPos | |||
| • | llSetPos | |||
| • | llGetLocalPos | |||
| • | llGetRootPosition | |||
| • | llGetObjectDetails |
Articles
| • | warpPos |