Difference between revisions of "Navigator ChartTracker HUD"

From Second Life Wiki
Jump to navigation Jump to search
Line 1: Line 1:
NEW FEATURES in V.4: The return of teleport via slurl.  Improved user interface, now using dialogger framework.


NEW FEATURES IN V.315: http maps, UI improvements


Navigator charttracker is a version of the Navigator HUD that can use arbitrary maps supplied by the user (such as the ones often sent out with race and cruise announcements) instead of tiles of sim maps obtained from the server.  The hud needs to be configured with the global coordinates of the southwest corner of the map,  and the dimensions of the area covered by the map.   
Navigator charttracker is a mapping HUD that can use arbitrary maps supplied by the user (such as the ones often sent out with race and cruise announcements).
The hud comes with road maps of the continents.    It can also get maps of the current sim and web maps of blocks of 4, 16, and 64 sims.
 
To add new maps to the hud, it needs to be configured with the global coordinates of the southwest corner of the map,  and the dimensions of the area covered by the map.   


These should be in the  HUD's "configuration" notecard, in the following format:
These should be in the  HUD's "configuration" notecard, in the following format:
Line 17: Line 18:
z coordinates must be present but are ignored.
z coordinates must be present but are ignored.


The map texture needs to be added to the Navigator's inventory.
The map texture needs to be added to the hud's inventory..


Up to 12 maps can be configured (limitation of the llDialog API).  If you have more than 12 maps loaded,  you can switch maps using chat (see below).


The UI is on the frame above and below the map.   
"Load Maps" is at the top center, and will bring up a dialog of the configured maps.
[[File:charttracker-load-map-screenshot.jpg]]
"map.secondlife.com" displays a map of 1, 4, 16, or 64 regions including the current region.  4, 16, and 64 require Secondlife Viewer 2 or a 3rd-party viewer that supports Viewer 2 http-on-a-prim functionality.  1-region display works the same way as in previous versions (despite the way the button is now labeled) and will still work with Viewer 1. 
"Transparency" controls the transparency/opaqueness of the map display, as in the other HUDs.    The button with the U-turn arrow resets the HUD.  The button with the man on it is avatar radar.  Click there and it will drop oranger markers on the map for any avatars within 96m, tagged with the name of the avatar.  Click on the orange marker to bring up the profile for the avatar.  The radar does not run continuously, but only scans when you click it.  You can also scan for specific objects (see below).   


"Load Map" is at the top left, and will bring up a dialog of the configured maps.
Click on the map to get parcel information for the location clicked on. An slurl will appear in the chat window for more info.  If the viewer supports media-on-a-prim, a "Places" tab for the location will be opened.  You can teleport from that tab.  (This way you know what you are teleporting into,  unlike when you teleport by clicking the regular viewer map).
"map.secondlife.com" displays a map of 1, 4, 16, or 64 regions including the current region.  4, 16, and 64 require Secondlife Viewer 2 or a 3rd-party viewer that supports Viewer 2 http-on-a-prim functionality.  1-region display works the same way as in previous versions (despite the way the button is now labeled) and will still work with Viewer 1. 
[[File:charttracker-screenshot.jpg]]
"Transparency" controls the transparency/opaqueness of the map display, as in the other Navigator HUD.    The button with the U-turn arrow resets the HUD.  The button with the man on it is avatar radar.  Click there and it will drop oranger markers on the map for any avatars within 96m, tagged with the name of the avatar.  The radar does not run continuously, but only scans when you click it.  You can also scan for specific objects (see below).
Click on the tools to get the preferences menu.  There you can adjust the size and number of markers and maximum map size.   See note below on changing the number of markers.
Dragging the map will move it on the screen.  Dragging the handle in the bottom right corner will resize it, but maintain aspect ratio.  Dragging the up-down arrow to the left of that will resize the y dimension only.   
Dragging the map will move it on the screen.  Dragging the handle in the bottom right corner will resize it, but maintain aspect ratio.  Dragging the up-down arrow to the left of that will resize the y dimension only.   
   
   
You can drop landmarks onto the map.  They will be displayed with their names.    To allow the marker for a landmark to be re-used,  click on it for 1/2 second or more.  It will not be removed immediately,  but will be returned to the pool of available markers for re-use.  Resetting the HUD currently removes all landmarks dropped on it (this may change in a future release).
You can drop landmarks onto the map.  They will be displayed with their names.    To allow the marker for a landmark to be re-used,  click on it for 1 second or more.  It will not be removed immediately,  but will be returned to the pool of available markers for re-use.  Resetting the HUD currently removes all landmarks dropped on it (this may change in a future release).
 
When you click on the map, the hud will llOwnerSay the slurl for the location.  This slurl is relative to the current sim so it looks funny, but it works.  You can teleport to the location if there is a sim there and it allows you to teleport there.


To do a single scan for a specific object within 96m,  chat on channel 11 the characters ?& followed by the name of the object, or ?&& followed by its key.  This interface is experimental and will likely change.
To do a single scan for a specific object within 96m,  chat on channel 11 the characters ?& followed by the name of the object, or ?&& followed by its key.  This interface is experimental and will likely change.
To select another map without using the menu,  chat the name of the map on channel 11.  It is still necessary to have the position and size of the map configured as described above.  This avoids the 12-map limitation of the dialog.


Note that you must be in a place where you have rez permissions and script-running permissions to change the number of markers.  After changing the setting on the slider and clicking "OK", you will be asked to "drop" the HUD.    The HUD will either create new prims and link them, or unlink some prims and send them a script to tell them to die.   The HUD will re-attach when it is done.  Best not to do this in a place with aggressive auto-return settings.    The timer starts when the objects enters the property, even if it is attached, so it could be returned instantly when you drop it if you have been on the property long enough.  
The butterfly icon is flight assist.  A short click turns it on or off, a longer click brings up a dialog to allow the strength of the assistance to be adjusted.
[[File:charttracker-flight-assist-screenshot.jpg]]


An example map and associated configuration is included.
Some distributions may come with addditional maps.
Some distributions may come with addditional maps.

Revision as of 16:04, 21 November 2011


Navigator charttracker is a mapping HUD that can use arbitrary maps supplied by the user (such as the ones often sent out with race and cruise announcements). The hud comes with road maps of the continents. It can also get maps of the current sim and web maps of blocks of 4, 16, and 64 sims.

To add new maps to the hud, it needs to be configured with the global coordinates of the southwest corner of the map, and the dimensions of the area covered by the map.

These should be in the HUD's "configuration" notecard, in the following format:

texturename=<globalcoordinates> <area-covered>

e.g.:

Egyptian Museum Area=<291718, 279552, 0> <200, 200, 1>

In the above example, the lower left (SW) corner of the map is at global coordinate <291718, 279552, 0> and the map covers a 200m x 200m area.

z coordinates must be present but are ignored.

The map texture needs to be added to the hud's inventory..


"Load Maps" is at the top center, and will bring up a dialog of the configured maps. Charttracker-load-map-screenshot.jpg "map.secondlife.com" displays a map of 1, 4, 16, or 64 regions including the current region. 4, 16, and 64 require Secondlife Viewer 2 or a 3rd-party viewer that supports Viewer 2 http-on-a-prim functionality. 1-region display works the same way as in previous versions (despite the way the button is now labeled) and will still work with Viewer 1. "Transparency" controls the transparency/opaqueness of the map display, as in the other HUDs. The button with the U-turn arrow resets the HUD. The button with the man on it is avatar radar. Click there and it will drop oranger markers on the map for any avatars within 96m, tagged with the name of the avatar. Click on the orange marker to bring up the profile for the avatar. The radar does not run continuously, but only scans when you click it. You can also scan for specific objects (see below).

Click on the map to get parcel information for the location clicked on. An slurl will appear in the chat window for more info. If the viewer supports media-on-a-prim, a "Places" tab for the location will be opened. You can teleport from that tab. (This way you know what you are teleporting into, unlike when you teleport by clicking the regular viewer map). Charttracker-screenshot.jpg Dragging the map will move it on the screen. Dragging the handle in the bottom right corner will resize it, but maintain aspect ratio. Dragging the up-down arrow to the left of that will resize the y dimension only.

You can drop landmarks onto the map. They will be displayed with their names. To allow the marker for a landmark to be re-used, click on it for 1 second or more. It will not be removed immediately, but will be returned to the pool of available markers for re-use. Resetting the HUD currently removes all landmarks dropped on it (this may change in a future release).

To do a single scan for a specific object within 96m, chat on channel 11 the characters ?& followed by the name of the object, or ?&& followed by its key. This interface is experimental and will likely change.

The butterfly icon is flight assist. A short click turns it on or off, a longer click brings up a dialog to allow the strength of the assistance to be adjusted. Charttracker-flight-assist-screenshot.jpg

Some distributions may come with addditional maps.

Retrieved from "https://wiki.secondlife.com/w/index.php?title=Navigator_ChartTracker_HUD&oldid=1158266"