Difference between revisions of "LlMapBeacon"

Latest revision as of 08:51, 8 November 2024

Function: llMapBeacon( string region_name, vector pos, list options );


1.0	Forced Delay
10.0	Energy

Asks the viewer to create a beacon for the user and optionally opens the world map centered on the location.

• string	region_name	–	Region name
• vector	pos	–	position in region coordinates
• list	options

Requests that a user's viewer set a beacon in the world and optionally opens the world map centered on the specified location.

Parameter		Return Values / Additional Parameters		Description
[ BEACON_MAP ]	1	[ BEACON_MAP, integer open_map, integer focus_map ]		Requests viewer world map behavior. If the first parameter is TRUE the viewer should open the world map. If the second parameter is TRUE this function also requests that the map should receive focus. Note that setting both values to true mimics the behavior of llMapDestination. Also, the focus_map parameter is only meaningful if open_map is TRUE

This function causes the script to sleep for 1.0 seconds.
Since this function requests the client to perform a task, there is no way for script to know if it has failed.

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.

Signature
function void llMapBeacon( string region_name, vector pos, list options );

@@ Line 5: / Line 5: @@
 |func_id=309|func_sleep=1.0|func_energy=10.0
 |func=llMapBeacon|sort=MapBeacon
-|p1_type=string|p1_name=simname|p1_desc=Region name
+|p1_type=string|p1_name=region_name|p1_desc=Region name
 |p2_type=vector|p2_name=pos
 |p3_type=list|p3_name=options