Navigator ChartTracker HUD

From Second Life Wiki
Revision as of 00:32, 11 September 2011 by Rufus Darkfold (talk | contribs) (Created page with "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 oft…")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

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.

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 Navigator'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 Map" is at the top left, and will bring up a dialog of the configured maps. "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 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.

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).

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 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.

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

Both the mapper and the charttracker huds are included in the package.