Difference between revisions of "LlSetRegionPos"
Jump to navigation
Jump to search
m |
m |
||
| Line 1: | Line 1: | ||
{{LSL Function | {{LSL Function | ||
|func_id=?|func_sleep=0.0|func_energy=0.0 | |func_id=?|func_sleep=0.0|func_energy=0.0 | ||
|func=llSetRegionPos | |func=llSetRegionPos | ||
| Line 6: | Line 5: | ||
|return_type=integer | |return_type=integer | ||
|return_text=[[boolean]], [[TRUE]] if the object is successfully placed within 0.1 m of '''{{LSL Param|position}}''', [[FALSE]] otherwise. See [[#Specification]] for details. | |return_text=[[boolean]], [[TRUE]] if the object is successfully placed within 0.1 m of '''{{LSL Param|position}}''', [[FALSE]] otherwise. See [[#Specification]] for details. | ||
|func_desc=Tries to | |func_desc=Tries to move the entire object so that the root prim is within 0.1m of '''{{LSL Param|position}}'''. | ||
|func_footnote=Only if [[TRUE]] is returned does the object move, if [[FALSE]] is returned, the object does not change position. | |func_footnote=Only if [[TRUE]] is returned does the object move, if [[FALSE]] is returned, the object does not change position. | ||
|spec= | |spec= | ||
| Line 31: | Line 30: | ||
This function is intended to replace [[WarpPos]]. | This function is intended to replace [[WarpPos]]. | ||
|history= | |history= | ||
* New LSL function integer llSetRegionPos(vector position) in Second Life | * New LSL function integer llSetRegionPos(vector position) in Second Life Server 12.01.24.248357 | ||
*: The object with the script will move the root prim position to the given location. The position is any position within the region. If the position is below ground, it will be set to the ground level at that X,Y spot. The function has no delay or throttle. | *: The object with the script will move the root prim position to the given location. The position is any position within the region. If the position is below ground, it will be set to the ground level at that X,Y spot. The function has no delay or throttle. | ||
*:* Returns 1 if the object is successfully placed within 0.1 m of position. | *:* Returns 1 if the object is successfully placed within 0.1 m of position. | ||
| Line 37: | Line 36: | ||
*:* Returns 0 and does not move the object if the object is dynamic (has physics enabled). | *:* Returns 0 and does not move the object if the object is dynamic (has physics enabled). | ||
*:* Returns 0 and does not move the object if the object can not move to position due to object entry rules, prim limits, bans, etc. | *:* Returns 0 and does not move the object if the object can not move to position due to object entry rules, prim limits, bans, etc. | ||
|cat1=Movement | |cat1=Movement | ||
|cat2=Prim | |cat2=Prim | ||
Revision as of 11:38, 1 February 2012
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: integer llSetRegionPos( vector position );| 0.0 | Forced Delay |
| 0.0 | Energy |
Tries to move the entire object so that the root prim is within 0.1m of position.
Returns an integer boolean, TRUE if the object is successfully placed within 0.1 m of position, FALSE otherwise. See #Specification for details.
| • vector | position | – | position in region coordinates |
Only if TRUE is returned does the object move, if FALSE is returned, the object does not change position.
Specification
The object with the script will move the root prim position to the given location. The position is any position within the region. If the position is below ground, it will be set to the ground level at that X,Y spot. The function has no delay or throttle.
- Returns TRUE if the object is successfully placed within 0.1 m of position.
- Returns FALSE and does not move the object if...
- position is more than 10m off region or above 4096m.
- The x & y components of position must be in the range [-10.0, 266.0].[1]
- The z component must be in the range [0.0, 4096].
- the object is dynamic (has physics enabled).
- the object can not move to position due to parcel/region restrictions (object entry rules, prim limits, bans, etc).
- position is more than 10m off region or above 4096m.
Examples
Notes
This function is intended to replace WarpPos.
See Also
Functions
| • | llGetLocalPos | – | Returns the prim's local position if it is attached or non-root (otherwise it returns the global position) | |
| • | llGetRootPosition | – | Gets the root prims position | |
| • | llGetPos | – | Returns the prim's global position, even if it is attached or non-root | |
| • | llSetPos |
Deep Notes
History
- New LSL function integer llSetRegionPos(vector position) in Second Life Server 12.01.24.248357
- The object with the script will move the root prim position to the given location. The position is any position within the region. If the position is below ground, it will be set to the ground level at that X,Y spot. The function has no delay or throttle.
- Returns 1 if the object is successfully placed within 0.1 m of position.
- Returns 0 and does not move the object if position is more than 10m off region or above 4096m.
- Returns 0 and does not move the object if the object is dynamic (has physics enabled).
- Returns 0 and does not move the object if the object can not move to position due to object entry rules, prim limits, bans, etc.
- The object with the script will move the root prim position to the given location. The position is any position within the region. If the position is below ground, it will be set to the ground level at that X,Y spot. The function has no delay or throttle.
Footnotes
- ^ The ranges in this article are written in Interval Notation.
Signature |
|---|
function integer llSetRegionPos( vector position ); |