Difference between revisions of "LlMapDestination"
Jump to navigation
Jump to search
Kireji Haiku (talk | contribs) m |
m (put some monospaced type on code) |
||
| (6 intermediate revisions by 4 users not shown) | |||
| Line 2: | Line 2: | ||
|inject-2={{Issues/SVC-3455}}{{Issues/SVC-1038}}{{Issues/SVC-1795}}{{Issues/VWR-2060}}{{Issues/VWR-7331}} | |inject-2={{Issues/SVC-3455}}{{Issues/SVC-1038}}{{Issues/SVC-1795}}{{Issues/VWR-2060}}{{Issues/VWR-7331}} | ||
{{LSL Function/position|pos|region=*}} | {{LSL Function/position|pos|region=*}} | ||
{{LSL Function/position|look_at| | {{LSL Function/position|look_at|local=*}} | ||
|func_id=309|func_sleep=1.0|func_energy=10.0 | |func_id=309|func_sleep=1.0|func_energy=10.0 | ||
|func=llMapDestination|sort=MapDestination | |func=llMapDestination|sort=MapDestination | ||
| Line 16: | Line 16: | ||
|constants | |constants | ||
|examples= | |examples= | ||
< | <syntaxhighlight lang="lsl2"> | ||
string simName = "Help Island Public"; | string simName = "Help Island Public"; | ||
vector tpDest = <128.0, 128.0, 24.0>; | vector tpDest = <128.0, 128.0, 24.0>; | ||
| Line 33: | Line 33: | ||
key id = llDetectedKey(0); | key id = llDetectedKey(0); | ||
string | string oldSlurlPrefix = "http://slurl.com/secondlife/"; | ||
string | string newSlurlPrefix = "http://maps.secondlife.com/secondlife/"; | ||
string | string slurlSuffix = llEscapeURL(simName) | ||
+ "/" + (string)llRound(tpDest.x) | |||
+ "/" + (string)llRound(tpDest.y) | |||
+ "/" + (string)llRound(tpDest.z); | |||
llInstantMessage(id, | llInstantMessage(id, oldSlurlPrefix + slurlSuffix); | ||
llInstantMessage(id, | llInstantMessage(id, newSlurlPrefix + slurlSuffix); | ||
llMapDestination(simName, tpDest, lookAt); | llMapDestination(simName, tpDest, lookAt); | ||
} | } | ||
} | } | ||
</ | </syntaxhighlight> | ||
|helpers | |helpers | ||
|also_functions= | |also_functions= | ||
| Line 53: | Line 56: | ||
* {{LSLP|pos}} will work with [[Viewer_coordinate_frames#Region|Region]] coordinates not inside {{LSLP|simname}}. (like those returned by [[llRequestInventoryData]]) | * {{LSLP|pos}} will work with [[Viewer_coordinate_frames#Region|Region]] coordinates not inside {{LSLP|simname}}. (like those returned by [[llRequestInventoryData]]) | ||
* if called from non {{LSLGC|Touch|touch}} events, it only works for the {{LSLGC|Owner|owner}}. | * if called from non {{LSLGC|Touch|touch}} events, it only works for the {{LSLGC|Owner|owner}}. | ||
* if called from touch, it may only work for the first or last touch in the event queue (example: num_touched > 1) | * if called from touch, it may only work for the first or last touch in the event queue (example: {{Mono|num_touched > 1}}) | ||
* if called inside an [[attachment]], it only works for the owner. | * if called inside an [[attachment]], it only works for the owner. | ||
|permission | |permission | ||
Latest revision as of 09:32, 10 February 2023
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: llMapDestination( string simname, vector pos, vector look_at );
| 1.0 | Forced Delay |
| 10.0 | Energy |
Opens world map centered on simname with pos highlighted.
Only works for scripts attached to avatar, or during touch events.
| • string | simname | – | Region name | |
| • vector | pos | – | position in region coordinates | |
| • vector | look_at | – | position in local coordinates (not used) |
(NOTE: look_at currently does nothing)
Caveats
- This function causes the script to sleep for 1.0 seconds.
- if simname is omitted or invalid, the map will open centered on object, but pos will not be highlighted. Since this function requests the client to perform a task, there is no way for script to know if it has failed.
Examples
string simName = "Help Island Public";
vector tpDest = <128.0, 128.0, 24.0>;
vector lookAt = ZERO_VECTOR;
default
{
state_entry()
{
// set white, opaque floattext with teleport destination
llSetText("click to teleport\nto '" + simName + "'", <1.0, 1.0, 1.0>, (float)TRUE);
}
touch_start(integer num_detected)
{
key id = llDetectedKey(0);
string oldSlurlPrefix = "http://slurl.com/secondlife/";
string newSlurlPrefix = "http://maps.secondlife.com/secondlife/";
string slurlSuffix = llEscapeURL(simName)
+ "/" + (string)llRound(tpDest.x)
+ "/" + (string)llRound(tpDest.y)
+ "/" + (string)llRound(tpDest.z);
llInstantMessage(id, oldSlurlPrefix + slurlSuffix);
llInstantMessage(id, newSlurlPrefix + slurlSuffix);
llMapDestination(simName, tpDest, lookAt);
}
}
Notes
- pos will work with Region coordinates not inside simname. (like those returned by llRequestInventoryData)
- if called from non touch events, it only works for the owner.
- if called from touch, it may only work for the first or last touch in the event queue (example: num_touched > 1)
- if called inside an attachment, it only works for the owner.
See Also
Functions
| • | llRequestInventoryData |
Deep Notes
Signature |
|---|
function void llMapDestination( string simname, vector pos, vector look_at ); |