LlMapDestination

Template:Needs Translation/LSL/de Template:Needs Translation/LSL/es Template:Needs Translation/LSL/el Template:Needs Translation/LSL/he Template:Needs Translation/LSL/it Template:Needs Translation/LSL/ko Template:Needs Translation/LSL/nl Template:Needs Translation/LSL/hu Template:Needs Translation/LSL/no Template:Needs Translation/LSL/da Template:Needs Translation/LSL/sv Template:Needs Translation/LSL/tr Template:Needs Translation/LSL/pl Template:Needs Translation/LSL/pt Template:Needs Translation/LSL/ru Template:Needs Translation/LSL/th Template:Needs Translation/LSL/uk Template:Needs Translation/LSL/zh-Hans Template:Needs Translation/LSL/zh-Hant

/LSL

MapDestination

llMapDestination

Summary

4/5 Bugs

Function: llMapDestination( string simname, vector pos, vector look_at );

309	Function ID
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.

Important Issues

~ All Issues ~ Search JIRA for related Bugs

		SVC-3455	A		llMapDestination ignores look_at parameter
		SVC-1795	A		llMapDestination in attachments opens a map on owner's screen even when touched by someone else
		VWR-2060	A		llMapDestination pos parameter is sometimes replaced with incorrect data (workaround included)
		VWR-7331	A		height in pos is capped to 1000m (code patch included)

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

All Issues

~ Search JIRA for related Issues

		SVC-3455	A		llMapDestination ignores look_at parameter
		SVC-1038	A		Throttle llMapDestination to prevent "map bombing".
		SVC-1795	A		llMapDestination in attachments opens a map on owner's screen even when touched by someone else
		VWR-2060	A		llMapDestination pos parameter is sometimes replaced with incorrect data (workaround included)
		VWR-7331	A		height in pos is capped to 1000m (code patch included)

Signature
function void llMapDestination( string simname, vector pos, vector look_at );