GPS & Routes

The GPS menu has the following options…

Clear Route       Clears the currently-selected route.
Pick Route         Displays a list of available routes in a menu.
Say Route         Lists the waypoints in the current route in local chat.
New Route        Opens the New Route menu.
Say Coords       Outputs current coords in local chat – display is in standard ATON format.
Reset                 Zeros values in the GPS panel and refreshes the list of routes.
Main Menu        Return to the main menu.
The route system uses global coordinates and resolves positions to the nearest metre. Each route is stored in the hud as a notecard, and each notecard name must start with “Route “, including the trailing space. Here are some example route notecard names…

        Route Stations
        Route My Patrol
        Route Favourites

The hud looks in its inventory for route notecards, and then builds the route selection menu using the parts of the notecard names after “Route “. So, a route selection menu based on the above examples would have buttons that look like this…

        [ Stations ]    [ My Patrol ]    [ Favourites ]

Note that the SL menu system limits the number of characters that are displayed in each button. If the ‘button’ part of your route notecard name is too long, the extra characters will not be displayed. Experiment with names to see what displays cleanly. Sometimes, it’s better to use abbreviations than to have text cut off half way through. (The hud uses ‘WPT’ instead of ‘Waypoint’ in its menus for this very reason.)

The hud can display a maximum of 12 routes – the number of options available in a menu. If there are more than 12, it will display the first 12 it finds, and they are selected in alphabetical order.
When you click the Pick Route menu option and select a route, the following happens…

        The waypoints for that route are loaded into memory.
        The waypoint list is displayed in the chat window, using text visible only to the hud’s owner.
        The target panel activates and shows the data for the first waypoint in the route.
        Some yellow lights appear around the compass – round at top-left, two arrows along the bottom.
        The red target pointer appears in the middle of the compass.

The two arrows are buttons which cycle through the waypoints. The left arrow is previous, and the right arrow is next. The waypoint display in the shout panel loops around if you are at the first or last waypoints. Note that the lowest line in the target panel includes two numbers – the first is the number of the waypoint as it was read from the notecard, and the second (in brackets) is the number of waypoints in the route. Thus, you have an indication of where the current waypoint is in the route.

If the last waypoint in the route is currently displayed, pressing next will loop around to the first waypoint, and pressing previous when at the first waypoint brings up the last waypoint in the route.
The hud can have both a shout and a route active at the same time. The round yellow and red lamps tell you which is currently being displayed. Each lamp also has a circular surround in a darker shade of the same colour. Here’s what the indicators tell you…

When a route is active, the darker surround of the yellow lamp is lit
When a shout is active , the darker surround of the red lamp is lit.
When a route is currently displayed, the brighter centre of the yellow lamp is lit
When a shout is currently displayed, the brighter centre of the red lamp is lit.

Active – a route or shout is stored in memory.
Current – a route or shout is being pointed at by the target pointer and target panel.

So, if the yellow lamp is lit, the target pointer and target panel tell you about the current waypoint. If the red lamp is lit, they tell you about the shout’s EPIRB position.
When both a route and a shout are active, the lamps also function as buttons. If the current display is for a shout, then the red shout lamp is lit, its red surround is lit, and the yellow surround for the route lamp is lit. Clicking the yellow lamp will switch off the red shout lamp (but leave its darker surrund lit), and light the yellow lamp. The target pointer and shout panel change to show the current waypoint. You can toggle between shout location and current waypoint by clicking the appropriate lamp.

The previous and next arrows can also be clicked when a shout is active – the red lamp goes off, the yellow lamp goes on, and the display immediately changes to the next or previous waypoint.

The Say Coords menu option gives coordinate information in local chat, which you can then copy and paste into other tools used for navigation, such as a list of buoys in a notecard. Here’s an example of the position information given when you do Say Coords..
[5:58]  ZM Navmaster HUD v1.03 whispers: Copy/paste the coordinates below…
<290943.50000, 270044.80000, 26.60694><127.46960, 220.84260, 26.60694>



The Create New Route menu has the following options…

Add WPT             Adds your current position to the new route.
Name WPT         Listens for a short text description that you type in local chat.
List WPTs           Lists the current waypoints in the route, in route notecard format.
Clear Route       Clears the current list of waypoints and descriptions.
GPS Menu          Returns to the GPS menu.
Main Menu        Returns to the main menu.

When in the New Route Menu, follow this procedure to create a new route…

Start by listing waypoints. If there are waypoints already in the hud’s memory, you can remove them by picking Clear Route.
Go to your first location and click Add WPT.
Click Name WPT and type a short description.
Continue adding waypoints and descriptions.
When you’re finished, click List WPTs. You will see chat text like this…

        [16:03]  ZM Navmaster HUD v1.03q whispers: New Route…
        WPT 290922 270033 27 # test 1
        WPT 290941 270043 27 # test 2

Copy all of the lines that start with ‘WPT’, and paste them into a notecard.
Rename the notecard to use the route notecard naming convention described in the GPS menu section.
Put a copy of the new route notecard into the hud’s inventory.

The hud automatically detects the addition or removal of items in its inventory, and your new route should now be available in the route selection menu.

You can edit the contents of the notecard afterwards. Every line that contains a waypoint must start with “WPT “. All other lines are ignored. So, this would be a valid route notecard…

        A start and finish in NYC
        WPT 290922 270033 27 # Start
        WPT 290941 270043 27 # Finish

In this example, an extra line has been put in at the start to tell me about the route, and I have edited the original “test 1″ and “test 2″ text to something more meaningful. If the notecard for the active route has been edited, the hud automatically reloads it.

Since the routes are plain text notecards, they can be shared with others, and their contents can be copied and pasted into local SL chat, posted on forums, etc.

Comments are closed.