Difference between revisions of "Navigator ChartTracker HUD"

From Second Life Wiki
Jump to navigation Jump to search
(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…")
 
 
(5 intermediate revisions by the same user not shown)
Line 1: Line 1:
NEW FEATURES IN V.315: http maps, UI improvements
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.


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.   
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 15: Line 16:
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]]


"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.   
"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).
"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 tools to get the preferences menuThere you can adjust the size and number of markers and maximum map size.   See note below on changing the number of markers.
 
Click on the map to get parcel information for the location clicked on.  An slurl will appear in the chat window for more infoIf 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).
 
[[File: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.   
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 worksYou 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 keyThis 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.
The butterfly icon is flight assist. A short click turns it on or offa longer click brings up a dialog to allow the strength of the assistance to be adjusted.
To select another map without using the menuchat 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.  
[[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.


Both the mapper and the charttracker huds are included in the package.
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.

Latest revision as of 11:21, 26 December 2011

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.