Navigator ChartTracker HUD

From Second Life Wiki
Jump to navigation Jump to search

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.

The HUD runs the "navigator" script that the navigator beacons run, and can be used to update the script in any beacons you own. There is an additional "mapper" script to handle the maps. Navigator HUD has all the other features of navigator, including the ability to check any location in the sim for banlines, full parcels, reefs, etc., and to forward requests to other navigators as needed. You can also click on the map to get information on any location displayed if it is in the same sim, or if the sim selected has a Navigator beacon.

Most forwarding is now done via http/http-in. Navigator beacons register with the objDNS service on appspot.com. Maps are obtained via either of two APIs: Tyche Shepherd's gridsurvey API (http://www.gridsurvey.com/api.php) or the map api on subnova.com.

It is now possible to have proxies for sims in which it is not possible to install beacons. These will not have the real-time data that a real beacon would provide, but they can be used to warn vehicles away from private sims and their hidden banlines. If the whole sim is off-limits, there is little need for real-time data from it anyway. Proxies could also be used for sims that are all deep Linden water.

The HUD checks the area 10m ahead of the avatar — "ahead" meaning whichever direction the camera is looking, not necessarily the direction the avatar is moving. The 10m lookahead increases with avatar speed (currently to a max of 50m). If that distance crosses a sim boundary, the hud will attempt to query the navigator in the next sim. If there is none there, a "[ NOSERVICE! ]" warning is displayed.

The HUD will generally display the sim name and coordinates it checked and information about the parcel, e.g:

Sentry:<226,184,144> [ SAMEOWNER ] (488/1289) ^104 "Egyptian Museum (Open During Construction)" Rufus Darkfold

Comet:<30,79,131> [ BANLINE!! ] (105/117) ^107 "Erindale" <--- with !! and in red, because you would be within 50m of ground and hit the banlines.

Comet:<30,79,191> [ BANLINE ] (105/117) ^107 "Erindale" <--- no !! and in white, because you would be above the banlines.

[ NOSERVICE! ] is displayed if the location being queried is in another sim and that sim has no Navigator beacon.

"(105/117)" is (prims-in-use/prims-available). In addition, if the prim allowance is already exceeded on the parcel, a "PARCELFULL!!" warning is displayed.

"^107" is the ground height.

Under water locations replace the ^height with ~depth, e.g.:

The Sea:<23,77,20>[](10/1222) ~14 "somewhere that is 14 meters deep"

A proxy response may omit much of this. The one currently being tested just returns, "[ PRIVATE SIM!! BANLINES!! ]"

A single  ! is a warning (such as NOSERVICE!), 2 ! ("!!") indicates a banline or a full parcel, either of which are hazardous to vehicles.