The tool is a zero install tool - no install process is required, the user just need to download the AWS_Mapper.zip file, unpack (unzip) the file and run the “AWS Mapper.exe” file.

The AWS_Mapper.zip file contains 4 files:

AWS Mapper.exe - the tool
Settings.xml - the tool’s settings (maintained by the tool itself)

The settings setup comes with Outposts, revive boundaries and ore claims already setup (if the files are places in C:\AWS\)

Help.htm - a link to this document
Sample data points.

Sample Ore Claims
AWS version C220 outposts

Note: the tool requires the .Net Framework 4.5 runtime to have been installed on the PC. If the PC does not have this installed, the user can download and install it from http://www.microsoft.com/en-nz/download/details.aspx?id=3065

Initial Settings

The initial install does not come with the World Map, this can be downloaded from this link (https://drive.google.com/file/d/0B9pYqNXb8zJceVliN2NIeVJxVEE).

The Settings are already setup with the world coordinates for the above World Map.

However, the first run

The Sample data points should be copied to folder C:/AWS/. The Settings are setup to expect the sample to be placed in the above folder.

Note: if the data file does not exist, the tool does not complain about this - it simply skips any attempt to load the data points.

Note: the user can place the sample data point files anywhere they choose and repoint the Input File values in the Map Data settings to this location.

Data file formats

Currently there is only one type of data: Point (Name,N,E).

Other types of data will be added in the future.

All data types are TAB delimited

Data Types

Point (Name,N,E)

Format: <name><tab><north><tab><east>

<name>: the name of the data point

<north>: the north value of the world coordinates for the point

<east>: the east value of the world coordinates for the point

Revive (Name,N,E)

Format: <name><tab><north><tab><east>

<name>: the name of the revive

<north>: the north value of the world coordinates for the revive point

<east>: the east value of the world coordinates for the revive point

Note: The revive boundaries have an error margin of about 0.10 degrees. Setting the revive line size to 40, painting the line on the map and reviving away from this line is recommend.

Main form

The main form of the tool is shown below.

This form allows the user to zoom in and out of the map, scroll the map, show which data point are under the mouse and choose types of data to display.

Main form parts

The form contains the following parts.

Menu Bar

Viewport

Scroll bars are shown when the World Map is wider/higher than the viewport (i.e. when the view is zoomed)

Markups

Single point

Multiple overlapping points with transparency

Same data with smaller points and no transparency

Revive boundaries

Note: The revive boundaries have an error margin of about 0.10 degrees. Setting the revive line size to 40, painting the line on the map and reviving away from this line is recommend.

Mouse location information

This shows the current World Coordinates, the closest revive location to the mouse and a list of Ore Claims that overlap the current coordinates with a count of how many claims have the same name

Mouse World coordinates

This shows the current World Coordinates under the mouse

Zoom bar

This item Zooms in and out of the World Map.

Main form items

The form contains the following items.

Settings

This menu item opens the Settings form, allowing the user to change the World Map used and the type of information displayed on mouse positioning.

Map Data

This menu item opens the Map Data form, allowing the user to choose where the tool reads map data from and allowing the user to define the type and appearance of the markup on the World Map.

Select Data

This menu item opens the Select Data form, allowing the user to choose which data points contained in the Map Data input file to display on the World Map.

Refresh

This menu item refreshed that World Map markups, rereading the data points from the input files specified in the Map Data page.

Help

This menu item opens the Help page (this document).

Exit

This menu item ends the tool.

How to zoom and pan the World Map

Zooming

The World Map can be zoomed (magnified / reduced) the following ways

Using the Zoom Bar

The zoom bar magnifies the map shown in the Viewport .

Zoom level 1 shows the full map.

The maximum zoom level is 30.

By scrolling the mouse wheel
By drawing a rectangle with the RIGHT mouse button held down (magnify only). The area inside the rectangle becomes the new view.

Panning

The World Map can be panned (scrolled) the following ways

By holding the LEFT mouse down and dragging the map
Using the scroll bars when shown

Adding and hiding markups to the World Map

The Map Data is read from the Input files and painted onto either the ViewPort or the World Map depending on the Map Data settings at the coordinates specified in the files.

Markups painted on the viewport remain the same size irrespective of zoom level.

Markups painted on the world map zoom and reduce in the same way as the World map does.

Currently all markups are DOTs whose size, colour and transparency can be controlled by the user.

The markups can be individually hidden by the data point name; or all markups associated to an input file can be hidden.

Settings form

Clicking the Settings menu item will display the Settings form.

In this form, the user can choose a World Map image that the tool with use and define the coordinates that this World Map represents.

In addition, the form allows the user to decide if and what information is displayed when the mouse is within the Viewport.

The user should only need to invoke this form when doing the initial setup; or when the user wants to change the markup information displays.

Settings items

The form contains the following items

Map Image

File Name

The full path to the World Map image.

This image is applied immediately to allow the user to verify the image.

Map boundaries

North

The game coordinates for the North edge of World Map.

South

The game coordinates for the South edge of World Map.

East

The game coordinates for the East edge of World Map.

West

The game coordinates for the West edge of World Map.

Display Coordinates on map

Tick this option to show the world coordinates under the mouse.

Display names on map

Tick this option to show the names of the markups, whose boundaries contain the mouse position.

Display revive names on map

Tick this option to show the name of the revive that is closest to the mouse position.

Note: this is only displayed if you have a entry in the Map Data of type “Revive (Name, N, E)”

Save button

Validates and saves the values shown.

Restarts the tool to apply the values.

Cancel button

Discards the changes made to the form.

Restarts the tool to apply the values.

Map Data form

Clicking the Map Data menu item will display the Settings form.

Map Data items

The form contains the following items

Name (mandatory)

A unique name that describes the data within the Input File

Type (mandatory)

The type of markup that this input file contains.

There are two types:

Point (Name, N, E)
Revive (Name, N, E)

Each data type consists of a Name then TAB then North coordinate then TAB then East coordinate.

Note: there can only be one Revive (Name, N, E) type

Show on map

Check to show all data points.

Untick to hide all data points.

Input file

The full path of the file which will contain details of the data points to markup on the map.

The tool does not care if the file exists or not.

If the file exists, the file is read and the data points used.

If the file does not exist, the file is skipped.

Color

The color of the markup.

The user can choose one of 138 system named colors; or they can choose Automatic in which case the system will assign a color per group of data points of the same data point name.

Transparency

The transparency of the markup.

A value of 0 is totally transparent.

A value of 255 is totally solid.

A value between 0 and 255 represents various values of opaqueness.

Shape

The shape to paint on the map.

Currently only DOT is available.

Size

The size of the markup (1 - 100).

When this markup is Paint on view - this size is the pixel size to paint on the Viewport.

When this markup is Paint on mao - this size is the pixel size to paint on the map. The value shown

Paint on view

Paints the data point on the Viewport, enabling these to be shown the same size irrespective of zoom level.

Good for keeping data visible.

Paint on map

Paints the data point on the Viewport, allowing these to be shown in World Map scale.

Good for showing the size of something in actual world sizes.

Save

Saves the changes and closes the form

Cancel

Discards the changes and closes the form

Select Data form

Clicking the Select Data menu item will display the Select Data form.

Select Data items

The form contains the following items

Data selection

The user can choose to

Hide all data points for a Data Name (e.g. by checking Revive)
Hide a particular set of point names (e.g. Saransk)
Uncheck all (hide) point names by unchecking “(Select All)”

Changes made are immediately shown on the Main form

Save button

Saves the changes and then closes the form.

Close button

Discards the changes and closes the form.

How to …

Add data file of new data points to markup

Open the Map Data form.
Select an empty row

Enter a unique Name for the data points
Choose the Type of data held in the file
Enter the full name to the Input File containing the data points; or double click the Input File text box to bring up a file chooser.

Choose a Color.
Choose the Transparency level.
Choose the Shape of the markup.
Choose the Size of shape.
Choose whether the markup will be the same size irrespective of the Zoom level (Paint on view) or whether the markup will change in size to reflect the Zoom level (Paint on map).

Make the data points show density

The trick to making show how densely data points are packed is a combination of Transparency and shape Size.

With the Transparency set to 255, increase the Size of the shape until the shapes form a solid block of data.

Reduce Transparency down from 255 until transparent and semi-transparent regions are shown.

Add revive locations

Open the Map Data form.
Select an empty row

Enter a unique Name for the revive points
Choose a Type of Revive (Name, N, E)
Enter the full name to the Input File containing the data points that represent your all game revive points (i.e. outposts where your DNA is registered); or double click the Input File text box to bring up a file chooser.

Choose a Color.
Choose the Transparency level.
Choose the Shape of the markup.
Choose the Size of shape.
Choose whether the markup will be the same size irrespective of the Zoom level (Paint on view) or whether the markup will change in size to reflect the Zoom level (Paint on map)
Open the Select Data form
Ensure that the above (step 2) name only has revives where you have registered your DNA