llGetParcelDetails
Revision as of 01:54, 27 April 2011 by Pauline Darkfury (talk | contribs) (Simplified the example, llGetRegionCorner is irrelevant to this function, nothing useful is returned by using it instead of llGetPos (it just gives the parcel details for the parcel at 256,256))
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: list llGetParcelDetails( vector pos, list params );| 0.0 | Forced Delay |
| 10.0 | Energy |
Returns a list that is the parcel details specified in params (in the same order) for the parcel at pos.
| • vector | pos | – | only x and y are important and to be given in region coordinates | |
| • list | params | – | a list of PARCEL_DETAILS_* flags. |
| Flag | Meaning | Max Length | Return | |
|---|---|---|---|---|
| PARCEL_DETAILS_NAME | 0 | The name of the parcel. | 63 Characters | string |
| PARCEL_DETAILS_DESC | 1 | The description of the parcel. | 127 Characters | string |
| PARCEL_DETAILS_OWNER | 2 | The parcel owner's key. | (36 Characters) | key |
| PARCEL_DETAILS_GROUP | 3 | The parcel group's key. | (36 Characters) | key |
| PARCEL_DETAILS_AREA | 4 | The parcel's area, in sqm. | (5 Characters) | integer |
| PARCEL_DETAILS_ID | 5 | The parcel's key. | (36 Characters) | key |
| PARCEL_DETAILS_SEE_AVATARS | 6 | The parcel's avatar visibility setting[1] | (1 character) | integer - boolean |
| PARCEL_DETAILS_PRIM_CAPACITY | 7 | This parcel's prim capacity. | integer | |
| PARCEL_DETAILS_PRIM_USED | 8 | The prim usage on this parcel. | integer | |
| PARCEL_DETAILS_LANDING_POINT | 9 | Landing point set for this parcel, if any. | vector | |
| PARCEL_DETAILS_LANDING_LOOKAT | 10 | Look at vector set for the landing point on this parcel, if any. | vector | |
| PARCEL_DETAILS_TP_ROUTING | 11 | Teleport routing for this parcel.
Note that routing rules are only enforced if the landing point is set. |
integer | |
| PARCEL_DETAILS_FLAGS | 12 | Parcel flags set for this parcel.
See llGetParcelFlags for a listing of the flags and their meaning. |
integer | |
| PARCEL_DETAILS_SCRIPT_DANGER | 13 | Is the script in danger in the indicated parcel.
See llScriptDanger for a discussion of script danger. |
integer - boolean | |
| Max Lengths in parentheses represent how many characters required when it is typecast to a string. | ||||
Caveats
- There is also no PARCEL_DETAILS_LANDING_POINT or PARCEL_DETAILS_TELEPORT_ROUTING. SVC-4413
- Does not detect across region boundaries using over range vector.
Examples
A very simple example to return the parcel name and description for the current parcel.
<lsl>default {
touch_start(integer total_number)
{
list details = llGetParcelDetails(llGetPos(), [PARCEL_DETAILS_NAME, PARCEL_DETAILS_DESC]);
llSay(0, "Local Parcel Name:" + llList2String(details ,0));
llSay(0, "Local Parcel Desc:" + llList2String(details ,1));
}
}</lsl>
See Also
Functions
| • | llGetParcelFlags | |||
| • | llGetRegionFlags | |||
| • | llRequestSimulatorData | |||
| • | llGetObjectDetails |
Deep Notes
Footnotes
- ^ The parcel avatar visibility setting is used to hide avatars, their chat, and objects they sit on when they are in other parcels.
Signature |
|---|
function list llGetParcelDetails( vector pos, list params ); |