Second Life Wiki - User contributions [en]

LlMapDestination

2009-10-10T21:26:51Z

Yingzi Xue:

{{Issues/SVC-1038}}{{Issues/SVC-1795}}{{Issues/VWR-2060}}{{Issues/VWR-7331}}{{LSL_Function
|func_id=309|func_sleep=1.0|func_energy=10.0
|func=llMapDestination|sort=MapDestination
|p1_type=string|p1_name=simname|p1_desc=Region name
|p2_type=vector|p2_name=pos|p2_desc=[[Viewer_coordinate_frames#Region|Region]] coordinates
|p3_type=vector|p3_name=look_at|p3_desc=not used
|func_footnote=(NOTE: '''look_at''' currently does nothing)
|func_desc=Opens world map centered on '''simname''' with '''pos''' highlighted. Only works for scripts [[attach]]ed to avatar, or during {{LSLGC|Touch|touch}} events.
|return_text
|spec
|caveats=
* if '''simname''' is {{HoverText|omitted|an empty string: {{String}}}} 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.
|constants
|examples=<lsl>//Click the object this script is in and your map opens up in the middle of Oasis.
default
{
touch_start(integer num)
{
llMapDestination("Oasis", <128, 128, 0>, ZERO_VECTOR);
}
}</lsl>
<lsl>
// Get a teleport map, via touch_start, from the name of the first landmark in inventory.
// NOTE: Requires a landmark that contains name, region and position data.
// The correct format is "name, region (x, y, z)". If a landmark's
// name is too long the position data is truncated from the end,
// which will cause the position to be wrong.
default
{
touch_start(integer num)
{
// Parse the name of the first landmark found in inventory into a list using
// commas as separators.
list lstTemp = llParseString2List(llGetInventoryName(
INVENTORY_LANDMARK,0),[","],[]);

// Get list length and subtract 3 to get the correct element containing
// the region name. Moving backward from the end of the list keeps
// commas in the landmark name from giving us grief with misaligned
// and incorrect data.
integer intElement = llGetListLength(lstTemp)-3;

// Get the region name from the list element, eliminating unneeded
// characters in the string and trimming leading/trailing spaces.
string strSimname = llStringTrim(llGetSubString(llList2String(lstTemp,
intElement),0,llSubStringIndex(llList2String(lstTemp,intElement),"(")-1),
STRING_TRIM);

// The vector is pulled from the landmark name, based on the
// position of "(" in the string starting with the next
// character and ending with the second to the last character.
vector vecVector = (vector)("<"+llGetSubString(llGetInventoryName(
INVENTORY_LANDMARK,0),llSubStringIndex(llGetInventoryName(
INVENTORY_LANDMARK,0),"(")+1,-2)+">");

// Bring up the teleport map using the data we extracted.
llMapDestination(strSimname,vecVector,ZERO_VECTOR);
}
}</lsl>
|helpers
|also_functions=
{{LSL DefineRow||[[llRequestInventoryData]]|}}
|also_tests
|also_events
|also_articles
|notes=
* '''pos''' will work with [[Viewer_coordinate_frames#Region|Region]] coordinates not inside '''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 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.
|permission
|inventory
|negative_index
|cat1=Dialog
|cat2=Attachment
|cat3=Avatar
|cat4=Touch
|issues
}}

LlMapDestination

2009-10-10T21:25:59Z

Yingzi Xue:

{{Issues/SVC-1038}}{{Issues/SVC-1795}}{{Issues/VWR-2060}}{{Issues/VWR-7331}}{{LSL_Function
|func_id=309|func_sleep=1.0|func_energy=10.0
|func=llMapDestination|sort=MapDestination
|p1_type=string|p1_name=simname|p1_desc=Region name
|p2_type=vector|p2_name=pos|p2_desc=[[Viewer_coordinate_frames#Region|Region]] coordinates
|p3_type=vector|p3_name=look_at|p3_desc=not used
|func_footnote=(NOTE: '''look_at''' currently does nothing)
|func_desc=Opens world map centered on '''simname''' with '''pos''' highlighted. Only works for scripts [[attach]]ed to avatar, or during {{LSLGC|Touch|touch}} events.
|return_text
|spec
|caveats=
* if '''simname''' is {{HoverText|omitted|an empty string: {{String}}}} 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.
|constants
|examples=<lsl>//Click the object this script is in and your map opens up in the middle of Oasis.
default
{
touch_start(integer num)
{
llMapDestination("Oasis", <128, 128, 0>, ZERO_VECTOR);
}
}</lsl>
<lsl>
// Get a teleport map (on touch_start) from the name of the first landmark in inventory.
// NOTE: Requires a landmark that contains name, region and position data.
// The correct format is "name, region (x, y, z)". If a landmark's
// name is too long the position data is truncated from the end,
// which will cause the position to be wrong.
default
{
touch_start(integer num)
{
// Parse the name of the first landmark found in inventory into a list using
// commas as separators.
list lstTemp = llParseString2List(llGetInventoryName(
INVENTORY_LANDMARK,0),[","],[]);

// Get list length and subtract 3 to get the correct element containing
// the region name. Moving backward from the end of the list keeps
// commas in the landmark name from giving us grief with misaligned
// and incorrect data.
integer intElement = llGetListLength(lstTemp)-3;

// Get the region name from the list element, eliminating unneeded
// characters in the string and trimming leading/trailing spaces.
string strSimname = llStringTrim(llGetSubString(llList2String(lstTemp,
intElement),0,llSubStringIndex(llList2String(lstTemp,intElement),"(")-1),
STRING_TRIM);

// The vector is pulled from the landmark name, based on the
// position of "(" in the string starting with the next
// character and ending with the second to the last character.
vector vecVector = (vector)("<"+llGetSubString(llGetInventoryName(
INVENTORY_LANDMARK,0),llSubStringIndex(llGetInventoryName(
INVENTORY_LANDMARK,0),"(")+1,-2)+">");

// Bring up the teleport map using the data we extracted.
llMapDestination(strSimname,vecVector,ZERO_VECTOR);
}
}</lsl>
|helpers
|also_functions=
{{LSL DefineRow||[[llRequestInventoryData]]|}}
|also_tests
|also_events
|also_articles
|notes=
* '''pos''' will work with [[Viewer_coordinate_frames#Region|Region]] coordinates not inside '''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 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.
|permission
|inventory
|negative_index
|cat1=Dialog
|cat2=Attachment
|cat3=Avatar
|cat4=Touch
|issues
}}

LlMapDestination

2009-10-09T15:11:34Z

Yingzi Xue:

{{Issues/SVC-1038}}{{Issues/SVC-1795}}{{Issues/VWR-2060}}{{Issues/VWR-7331}}{{LSL_Function
|func_id=309|func_sleep=1.0|func_energy=10.0
|func=llMapDestination|sort=MapDestination
|p1_type=string|p1_name=simname|p1_desc=Region name
|p2_type=vector|p2_name=pos|p2_desc=[[Viewer_coordinate_frames#Region|Region]] coordinates
|p3_type=vector|p3_name=look_at|p3_desc=not used
|func_footnote=(NOTE: '''look_at''' currently does nothing)
|func_desc=Opens world map centered on '''simname''' with '''pos''' highlighted. Only works for scripts [[attach]]ed to avatar, or during {{LSLGC|Touch|touch}} events.
|return_text
|spec
|caveats=
* if '''simname''' is {{HoverText|omitted|an empty string: {{String}}}} 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.
|constants
|examples=<lsl>//Click the object this script is in and your map opens up in the middle of Oasis.
default
{
touch_start(integer num)
{
llMapDestination("Oasis", <128, 128, 0>, ZERO_VECTOR);
}
}</lsl>
<lsl>
// Get a teleport map from the name of the first landmark in inventory.
// NOTE: Requires a landmark that contains name, region and position data.
// The correct format is "name, region (x, y, z)". If a landmark's
// name is too long the position data is truncated from the end,
// which will cause the position to be wrong.
default
{
touch_start(integer num)
{
// Parse the name of the first landmark found in inventory into a list using
// commas as separators.
list lstTemp = llParseString2List(llGetInventoryName(
INVENTORY_LANDMARK,0),[","],[]);

// Get list length and subtract 3 to get the correct element containing
// the region name. Moving backward from the end of the list keeps
// commas in the landmark name from giving us grief with misaligned
// and incorrect data.
integer intElement = llGetListLength(lstTemp)-3;

// Get the region name from the list element, eliminating unneeded
// characters in the string and trimming leading/trailing spaces.
string strSimname = llStringTrim(llGetSubString(llList2String(lstTemp,
intElement),0,llSubStringIndex(llList2String(lstTemp,intElement),"(")-1),
STRING_TRIM);

// The vector is pulled from the landmark name, based on the
// position of "(" in the string starting with the next
// character and ending with the second to the last character.
vector vecVector = (vector)("<"+llGetSubString(llGetInventoryName(
INVENTORY_LANDMARK,0),llSubStringIndex(llGetInventoryName(
INVENTORY_LANDMARK,0),"(")+1,-2)+">");

// Bring up the teleport map using the data we extracted.
llMapDestination(strSimname,vecVector,ZERO_VECTOR);
}
}</lsl>
|helpers
|also_functions=
{{LSL DefineRow||[[llRequestInventoryData]]|}}
|also_tests
|also_events
|also_articles
|notes=
* '''pos''' will work with [[Viewer_coordinate_frames#Region|Region]] coordinates not inside '''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 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.
|permission
|inventory
|negative_index
|cat1=Dialog
|cat2=Attachment
|cat3=Avatar
|cat4=Touch
|issues
}}

LlMapDestination

2009-10-09T15:10:13Z

Yingzi Xue:

{{Issues/SVC-1038}}{{Issues/SVC-1795}}{{Issues/VWR-2060}}{{Issues/VWR-7331}}{{LSL_Function
|func_id=309|func_sleep=1.0|func_energy=10.0
|func=llMapDestination|sort=MapDestination
|p1_type=string|p1_name=simname|p1_desc=Region name
|p2_type=vector|p2_name=pos|p2_desc=[[Viewer_coordinate_frames#Region|Region]] coordinates
|p3_type=vector|p3_name=look_at|p3_desc=not used
|func_footnote=(NOTE: '''look_at''' currently does nothing)
|func_desc=Opens world map centered on '''simname''' with '''pos''' highlighted. Only works for scripts [[attach]]ed to avatar, or during {{LSLGC|Touch|touch}} events.
|return_text
|spec
|caveats=
* if '''simname''' is {{HoverText|omitted|an empty string: {{String}}}} 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.
|constants
|examples=<lsl>//Click the object this script is in and your map opens up in the middle of Oasis.
default
{
touch_start(integer num)
{
llMapDestination("Oasis", <128, 128, 0>, ZERO_VECTOR);
}
}</lsl>
<lsl>
// Get a teleport map from the name of the first landmark in inventory.
// NOTE: Requires a landmark that contains name, region and position data.
// The correct format is "name, region (x, y, z)". If a landmark's
// name is too long the position data is truncated from the end,
// which will cause the position to be wrong.
default
{
touch_start(integer num)
{
// Parse the name of the first landmark found in inventory into a list using
// commas as separators.
list lstTemp = llParseString2List(llGetInventoryName(
INVENTORY_LANDMARK,0),[","],[]);

// Get list length and subtract 3 to get the correct element containing
// the region name. Moving backward from the end of the list keeps
// commas in the landmark name from giving us grief with misaligned
// and incorrect data.
integer intElement = llGetListLength(lstTemp)-3;

// Get the region name from the list element, eliminating uneeded
// characters in the string and trimming leading/trailing spaces.
string strSimname = llStringTrim(llGetSubString(llList2String(lstTemp,
intElement),0,llSubStringIndex(llList2String(lstTemp,intElement),"(")-1),
STRING_TRIM);

// The vector is pulled from the landmark name, based on the
// position of "(" in the string starting with the next
// character and ending with the second to the last character.
vector vecVector = (vector)("<"+llGetSubString(llGetInventoryName(
INVENTORY_LANDMARK,0),llSubStringIndex(llGetInventoryName(
INVENTORY_LANDMARK,0),"(")+1,-2)+">");

// Bring up the teleport map using the data we extracted.
llMapDestination(strSimname,vecVector,ZERO_VECTOR);
}
}</lsl>
|helpers
|also_functions=
{{LSL DefineRow||[[llRequestInventoryData]]|}}
|also_tests
|also_events
|also_articles
|notes=
* '''pos''' will work with [[Viewer_coordinate_frames#Region|Region]] coordinates not inside '''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 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.
|permission
|inventory
|negative_index
|cat1=Dialog
|cat2=Attachment
|cat3=Avatar
|cat4=Touch
|issues
}}

LlMapDestination

2009-10-09T15:07:00Z

Yingzi Xue: Get a teleport map from the name of the first landmark in inventory.

{{Issues/SVC-1038}}{{Issues/SVC-1795}}{{Issues/VWR-2060}}{{Issues/VWR-7331}}{{LSL_Function
|func_id=309|func_sleep=1.0|func_energy=10.0
|func=llMapDestination|sort=MapDestination
|p1_type=string|p1_name=simname|p1_desc=Region name
|p2_type=vector|p2_name=pos|p2_desc=[[Viewer_coordinate_frames#Region|Region]] coordinates
|p3_type=vector|p3_name=look_at|p3_desc=not used
|func_footnote=(NOTE: '''look_at''' currently does nothing)
|func_desc=Opens world map centered on '''simname''' with '''pos''' highlighted. Only works for scripts [[attach]]ed to avatar, or during {{LSLGC|Touch|touch}} events.
|return_text
|spec
|caveats=
* if '''simname''' is {{HoverText|omitted|an empty string: {{String}}}} 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.
|constants
|examples=<lsl>//Click the object this script is in and your map opens up in the middle of Oasis.
default
{
touch_start(integer num)
{
llMapDestination("Oasis", <128, 128, 0>, ZERO_VECTOR);
}
}</lsl>
<lsl>
// Get a teleport map from the name of the first landmark in inventory.
// NOTE: Requires a landmark that contains name, region and position data.
// The correct format is "name, region (x, y, z)". If a landmark's
// name is too long the position data is truncated from the end,
// which will cause the position to be wrong.
default
{
touch_start(integer num)
{
// Parse the name of the first landmark found in inventory into a list using
// commas as separators.
list lstTemp = llParseString2List(llGetInventoryName(
INVENTORY_LANDMARK,0),[","],[]);

// Get list length and subtract 3 to get the correct element containing
// the region name. Moving backward from the end of the list keeps
// commas in the landmark name from giving us grief with misaligned
// and incorrect data.
integer intElement = llGetListLength(lstTemp)-3;

// Get the region name from the list element, removing "(" and trimming
// any leading and trailing spaces.
string strSimname = llStringTrim(llGetSubString(llList2String(lstTemp,
intElement),0,llSubStringIndex(llList2String(lstTemp,intElement),"(")-1),
STRING_TRIM);

// The vector is pulled from the landmark name, based on the
// position of "(" in the string starting with the next
// character and ending with the second to the last character.
vector vecVector = (vector)("<"+llGetSubString(llGetInventoryName(
INVENTORY_LANDMARK,0),llSubStringIndex(llGetInventoryName(
INVENTORY_LANDMARK,0),"(")+1,-2)+">");

// Bring up the teleport map using the data we extracted.
llMapDestination(strSimname,vecVector,ZERO_VECTOR);
}
}</lsl>
|helpers
|also_functions=
{{LSL DefineRow||[[llRequestInventoryData]]|}}
|also_tests
|also_events
|also_articles
|notes=
* '''pos''' will work with [[Viewer_coordinate_frames#Region|Region]] coordinates not inside '''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 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.
|permission
|inventory
|negative_index
|cat1=Dialog
|cat2=Attachment
|cat3=Avatar
|cat4=Touch
|issues
}}