Global Mapper User's Manual

Click to see a discussion thread that includes several screenshots with custom maps displayed on Garmin
devices.

Map GPS Coordinates - GPS Map Coordinates - GPSCoordinates Map 191

 Global Mapper User's Manual

Scripting Language Reference

Contents

• General Overview
• Batch Mode Operation
• Comments
• Commands
♦ ADD_MEASURE_ATTRS - Adds/Updates Measure Attributes to Features in a Layer
♦ ASSIGN_TYPE - Assigns Feature Types Based on Attribute Values
♦ COMBINE_TERRAIN - Combines Two Loaded Terrain Layers to Generate a New Terrain
Layer
♦ DEFINE_PROJ - Define a Projection for Later Use
♦ DEFINE_SHAPE - Define a Shape (i.e. Polygon) for Later Use
♦ DIR_LOOP_END - Ends a Loop of Commands Over Files in a Directory
♦ DIR_LOOP_START - Start a Loop of Commands Over Files in a Directory
♦ EMBED_SCRIPT - Runs Another Script File Within This Script
♦ EXPORT_ELEVATION - Export Elevation Data to a File
♦ EXPORT_METADATA - Export Metadata for a Layer to a File
♦ EXPORT_PACKAGE - Export Data to a Global Mapper Package File
♦ EXPORT_RASTER - Export Raster and Elevation Data to a File
♦ EXPORT_VECTOR - Export Vector Data to a File
♦ GENERATE_CONTOURS - Generate Contours from Elevation Data
♦ GENERATE_ELEV_GRID - Generates an Elevation Grid from Loaded 3D Vector Data
♦ GENERATE_LAYER_BOUNDS - Generates a Layer with Bounding Area Features for each
Loaded Layer
♦ GENERATE_PATH_PROFILE - Generate a 3D Path Profile and Save it to a XYZ File
♦ GENERATE_REPORT - Generates a Report on the Loaded Vector Features
♦ GLOBAL_MAPPER_SCRIPT - Script Header Line
♦ IMPORT - Import Data From a File
♦ IMPORT_ARCHIVE - Import Data From an Archive File (.zip, .tar.gz, etc.)
♦ IMPORT_ASCII - Import Generic ASCII Data from a File
♦ IMPORT_DIR_TREE - Import All Data Files in a Directory Tree
♦ IMPORT_TERRASERVER - Import TerraServer Imagery or Topo Maps
♦ LOAD_PROJECTION - Loads a New Global Projection From a PRJ File
♦ LOAD_STYLE_FILE - Loads a Style/Type File (.gm_style)
♦ LOAD_TYPE_FILTER - Loads a Type Filter from a GMF (Global Mapper Filter) File
♦ PLAY_SOUND - Plays a Beep or a Specified Sound File
♦ RESTORE_LAST_SAVED_VIEW - Restores Last Saved View
♦ SAVE_CURRENT_VIEW - Saves Current View
♦ SAVE_PROJECTION - Saves the Current Global Projection to a PRJ File
♦ SET_BG_COLOR - Sets the Background Color
♦ SET_LOG_FILE - Sets the Name of the Log File
♦ SET_VERT_DISP_OPTS - Sets the Vertical Display Options
♦ SHOW_3D_VIEW - Displays the 3D View Window
♦ UNLOAD_ALL - Unloads All Currently Loaded Data
♦ UNLOAD_LAYER - Unloads a Single Layer
• Samples
♦ Crop, Merge, and Reproject 4 USGS DRGs into new GeoTIFF and JPEG files
♦ Generate Contours from all USGS DEMs in a Folder and Export them to DXF and Shape
files

Map GPS Coordinates - GPS Map Coordinates - GPSCoordinates Map 192

 Global Mapper User's Manual
♦ Reclassify Features Based on an Attribute and Display Label

General Overview

Global Mapper script files allow the user to create custom batch processes that make use of the functionality
built in to Global Mapper. From a script, one can import data in any of the numerous formats supported by
the software, reproject that data if desired, and export it to a new file.

Global Mapper script files consist of a series of command lines. Each command line begins with a command.
A series of parameter/value pairs should follow the command. These pairs should be written as
parameter=value. No spaces should exist before or after the equal sign. Individual parameter/value pairs
should be separated by spaces. If a pair requires spaces internal to the value, quotes may be used around the
entire value. For example, for a filename with spaces, the pair could look like FILENAME="c:\\my
documents\\test.tif".

Command lines typically consist of one line each. To extend a command to another line, use the backslash
character (\) at the end of the line. There are a few exceptions to this, including the DEFINE_PROJ and
DEFINE_SHAPE commands and the looping functionality provided by the DIR_LOOP_START and
DIR_LOOP_END commands.

Batch Mode Operation

You can run a Global Mapper script file automatically be passing it on the command line to the Global
Mapper .exe file. The script file will be run with no user interface displayed and Global Mapper will
immediately exit when the script file completes processing. This allows you to easily run Global Mapper
scripts from another application or from a DOS batch file. Note that your script files need to have an extension
of .gms for this to work.

Comments

Any lines that begin with the forward slash character (/) are considered comments and are ignored by the
script processing engine. This means that you can use C or C++ style comments like // or /* at the start of your
line.

ADD_MEASURE_ATTRS

The ADD_MEASURE_ATTRS command allows you to add/update feature measure attributes to all of the
line and area features in a loaded vector layer.

The following parameters are supported by the command:

• FILENAME - filename of the layer to update. If an empty value is passed in, all layers that were
created by the script, such as those from a GENERATE_CONTOURS command, will be updated.
You can also pass in the value 'USER CREATED FEATURES' when running a script in the context
of the main map view or loading a workspace to have the 'User Created Features' layer updated.

Map GPS Coordinates - GPS Map Coordinates - GPSCoordinates Map 193

 Global Mapper User's Manual

ASSIGN_TYPE

The ASSIGN_TYPE command allows you to assign feature types (classifications) based on one or more
attribute or label values. You can choose to update area, line, and or point features with a single operation.
You can also supply multiple COMPARE_STR parameters to apply multiple criteria, all of which must be
true, in order to assign a type.

The following parameters are supported by the command:

• FILENAME - filename of the layer to assign types to. If an empty value is passed in, all layers that
were created by the script, such as those from a GENERATE_CONTOURS command, will be
updated. You can also pass in the value 'USER CREATED FEATURES' when running a script in the
context of the main map view or loading a workspace to have the 'User Created Features' layer
updated.
• AREA_TYPE - specifies the name of the Global Mapper area type to assign to matching area
features.
• LINE_TYPE - specifies the name of the Global Mapper line type to assign to matching line features.
• POINT_TYPE - specifies the name of the Global Mapper point type to assign to matching point
features.
• COMPARE_STR - specifies a comparison operation to perform to see if a feature is one that needs to
be reclassified. The format is attr_name=attr_value. For example if you have an attribute named
CFCC and you want to match when the value of that attribute starts with an 'A', you can use
COMPARE_STR="CFCC=A*" as your parameter. You can add multiple COMPARE_STR
parameters to a single command to combine multiple criteria for your search. If you would like to
compare against a feature label rather than an attribute, use <Feature Name> for your attribute name.
To compare against a feature type name rather than an attribute, use <Feature Type> for your attribute
name. To compare against the feature description, use <Feature Desc> for your attribute name.
• CASE_SENSITIVE - specifies whether or not text comparisons are case sensitive or not. Use
CASE_SENSITIVE=YES to enable, by default comparisons are not case sensitive.

For an example of how to use the ASSIGN_TYPE command, see the sample at the bottom of this document.

COMBINE_TERRAIN

The COMBINE_TERRAIN command generates a new terrain (gridded elevation) layer by combining two
loaded terrain layers through some operation, like addition, subtraction (difference), average, min/max, etc.
The new terrain layer can then be operated on just like any other terrain layer.

The following parameters are used by the COMBINE_TERRAIN command:

• LAYER1_FILENAME - full path and filename of the first loaded terrain layer to use. You can also
pass in the full description of the loaded layer to use in case you want to use a layer not loaded from a
file.
• LAYER2_FILENAME - full path and filename of the second loaded terrain layer to use. You can also
pass in the full description of the loaded layer to use in case you want to use a layer not loaded from a
file.
• COMBINE_OP - defines the operation to perform when combining the layers. The following
operations are supported:

Map GPS Coordinates - GPS Map Coordinates - GPSCoordinates Map 194

 Global Mapper User's Manual

♦ ADD - adds the values from the first layer to the second
♦ SUBTRACT_SIGNED - subtracts the values of the second layer from the first and saves the
signed result.
♦ SUBTRACT_UNSIGNED - subtracts the values of the second layer from the first and saves
the magnitude of the result.
♦ AVERAGE - saves the average of the values from the first and second layers.
♦ MINIMUM - saves the smaller of the values from the first and second layers.
♦ MAXIMUM - saves the larger of the values from the first and second layers.
♦ FILTER_KEEP_FIRST - saves the first layer value if the second layer value is valid.
♦ FILTER_KEEP_FIRST_IF_GT_SECOND - saves the first layer value if the second layer
value is valid and the first layer value is greater than the second layer value.
♦ FILTER_KEEP_FIRST_IF_LT_SECOND - saves the first layer value if the second layer
value is valid and the first layer value is less than the second layer value.
• LAYER_DESC - specifies the name to assign to the newly generated terrain layer. If no layer
description is provided, the default name of "Combined Elevation Grid" will be used.
• ELEV_UNITS - specify elevation units to use in new terrain layer
♦ FEET - export in US feet
♦ DECIFEET - export in 10ths of US feet
♦ METERS - export in meters
♦ DECIMETERS - export in 10ths of meters
♦ CENTIMETERS - export in centimeters
• SPATIAL_RES - specifies spatial resolution. Defaults to the minimum spatial resolution of the two
layers if not specified. Should be formatted as x_resolution,y_resolution. The units are the units of the
current global projection. For example, if UTM was the current global projection and you wanted to
export at 30 meter spacing, the parameter/value pair would look like SPATIAL_RES=30.0,30.0.
• GLOBAL_BOUNDS - specifies the combine bounds in units of the current global projection. There
should be 4 values in a comma-delimited list following the parameter name. The values should be in
order of minimum x, minimum y, maximum x, maximum y.
• GLOBAL_BOUNDS_SIZE - specifies the combine bounds in units of the current global projection.
There should be 4 values in a comma-delimited list following the parameter name. The values should
be in order of minimum x, minimum y, width in x, width in y.
• LAT_LON_BOUNDS - specifies the combine bounds in latitude/longitude degrees. There should be
4 values in a comma-delimited list following the parameter name. The values should be in order of
westmost longitude, southernmost latitude, easternmost longitude, northernmost latitude.
• LAYER_BOUNDS - specifies that the operation should use the bounds of the loaded layer(s) with the
given filename. For example, to export to the bounds of the file "c:\test.tif", you would use
LAYER_BOUNDS="c:\test.tif". Keep in mind that the file must be currently loaded.
• LAYER_BOUNDS_EXPAND - specifies that the operation should expand the used
LAYER_BOUNDS bounding box by some amount. The amount to expand the bounding rectangle by
should be specified in the current global projection. For example, if you have a UTM/meters
projection active and want to expand the bounds retrieved from the LAYER_BOUNDS parameter by
100 meters on the left and right, and 50 meters on the top and bottom, you could use
LAYER_BOUNDS_EXPAND="100.0,50.0". You can also specify a single value to apply to all 4
sides, or supply 4 separate values in the order left,top,right,bottom.
• FILL_GAPS - specifies that small gaps in between and within the data sets being combined will be
filled in by interpolating the surrounding data to come up with an elevation for the point in question.
This option is off by default, specify FILL_GAPS=NO to turn off.
• POLYGON_CROP_FILE - specifies the full path and filename of a vector file containing a polygon
feature to which the operation should be cropped. If multiple polygons are found in the specified file
the polygon which has the largest intersection with the data to be combined will be used as the crop
polygon (see POLYGON_CROP_USE_ALL or POLYGON_CROP_USE_EACH for exceptions).

Map GPS Coordinates - GPS Map Coordinates - GPSCoordinates Map 195

 Global Mapper User's Manual
• POLYGON_CROP_NAME - specifies the name of a polygon shape previously defined using the
DEFINE_SHAPE command to which the export should be cropped. The coordinates in the shape
need to have been provided in whatever projection the new terrain layer will be in (i.e. the current
projection).
• POLYGON_CROP_USE_ALL - specifies that if a POLYGON_CROP_FILE is specified that
contains multiple polygons, the operation will be cropped to all polygons in that file rather than just
the best-fit polygon.
• POLYGON_CROP_USE_EACH - specifies that if a POLYGON_CROP_FILE is specified that
contains multiple polygons, the operation will generate a separate export for each polygons in that file
rather than just the best-fit polygon. See the POLYGON_CROP_BBOX_ONLY and
POLYGON_CROP_NAME_ATTR options for naming and other options when using this parameter.
Use POLYGON_CROP_USE_EACH=YES to enable.
• POLYGON_CROP_BBOX_ONLY - specifies that if the POLYGON_CROP_USE_EACH parameter
is specified that each export should just be cropped to the bounding box of each polygon rather than
the actual boundary of the polygon. Use POLYGON_CROP_BBOX_ONLY=YES to enable only
cropping to the bounding box.
• POLYGON_CROP_NAME_ATTR - used to control the filenames generated when cropping to
multiple polygons using the POLYGON_CROP_USE_EACH parameter. This should be the actual
name of the attribute from the polygon features to use for naming, or the special values <Area Display
Label> or <Area Source Filename>. If no value is provided, the exported files will be sequentially
numbered.

DEFINE_PROJ

The DEFINE_PROJ command allows a projection (including datum) to be associated with a name. The
projection name can then be used in later IMPORT, IMPORT_ARCHIVE, IMPORT_ASCII, and
LOAD_PROJECTION commands to specify a projection as needed.

The DEFINE_PROJ command consists of a single command line followed by a series of lines describing the
projection in the format of an ESRI PRJ file. The easiest way to determine the text for a projection is to setup
a projection on the Projection tab of the Tools->Configuration and then use the Save to File button to create a
new .prj file. Then just open the .prj file up in Notepad and copy the contents to the lines following the
DEFINE_PROJ command line.

The DEFINE_PROJ command is terminated with a single line containing only the text END_DEFINE_PROJ.

For a sample of the DEFINE_PROJ command in use, load some data and then save a Global Mapper
workspace file from the File->Save Workspace menu command. Open the resulting .gmw file in an editor and
you can see how the DEFINE_PROJ command is used to define a view projection and the set it.

The following parameters are required by the DEFINE_PROJ command.

• PROJ_NAME - specifies the name to associate with the projection

DEFINE_SHAPE

The DEFINE_SHAPE command allows a multi-point shape (like a polygon) to be associated with a name.
The projection name can then be used in later commands for things like cropping and feathering to polygonal

Map GPS Coordinates - GPS Map Coordinates - GPSCoordinates Map 196

 Global Mapper User's Manual

boundaries.

The DEFINE_SHAPE command consists of a single command line followed by a series of lines describing
the series of XY coordinate pairs that define the shape. Each line should have a single coordinate value with
the X and Y coordinates separated by a comma.

The DEFINE_SHAPE command is terminated with a single line containing only the text
END_DEFINE_SHAPE.

The following parameters are required by the DEFINE_SHAPE command.

• SHAPE_NAME - specifies the name to associate with the shape

Here is an example of a DEFINE_SHAPE command used to define a feather polygon with a name of
'FEATHER_POLY'

DEFINE_SHAPE SHAPE_NAME="FEATHER_POLY"
377493.234,4323974.016
375343.359,4318676.109
381101.953,4314414.750
387014.109,4317178.875
386975.719,4322400.000
381869.766,4324588.266
377493.234,4323974.016
END_DEFINE_SHAPE

DIR_LOOP_END

The DIR_LOOP_END command ends a loop of commands over all of the folders within a directory. See the
DIR_LOOP_START command for details.

DIR_LOOP_START

The DIR_LOOP_START command begins a loop of commands over all of the folders within a directory (and
optionally its subdirectories) that match one or more filename masks. This is a powerful feature allowing you
to do things like easily batch convert a collection of files or perform any other supported operation over a
collection of files. You end a loop over the files in a folder using the DIR_LOOP_END command. Note that it
is also possible to nest loops.

For any commands found within a DIR_LOOP_START...DIR_LOOP end pair defining a loop, the following
special character sequences can be used anywhere (examples of what the values will be based on a current
filename of 'C:\data\my_file.dem' are listed):

• %DIR% - full path to current file (value is 'C:\data\')

• %FNAME_W_DIR% - full path and filename of current file (value is 'C:\data\my_file.dem')
• %FNAME% - filename of current file (value is 'my_file.dem')
• %FNAME_WO_EXT% - filename of current file without extension (value is 'my_file')

For a sample of the DIR_LOOP_START command in use, see the example at the bottom of this reference.

Map GPS Coordinates - GPS Map Coordinates - GPSCoordinates Map 197

 Global Mapper User's Manual

The following parameters are used by the DIR_LOOP_START command.

• DIRECTORY - specifies the directory to search for files in. If you leave this blank, the operation will
be based in the current folder.
• FILENAME_MASKS - space-separated list of filename masks to import. If no value is provided then
all files will be used.
• RECURSE_DIR - specifies whether the loop operation will search subdirectories of the specified
directory as well as the current one. Use RECURSE_DIR=YES to enable. The default value is to
NOT search subdirectories.

EMBED_SCRIPT

The EMBED_SCRIPT command allows you to call another script from within a script. This can be useful in
many situations. For example, if you have a common set of data files that you want to load for each script
operation, you could simply create a script that loaded those files, then embed that script within your other
scripts.

The following parameters are supported by the command:

• FILENAME - full path to script file to run

EXPORT_ELEVATION

The EXPORT_ELEVATION command exports all currently loaded elevation data to a file. The following
parameters are supported by the command.

• FILENAME - full path to file to save the data to

• TYPE - type of elevation file we're exporting to
♦ ARCASCIIGRID - export an Arc ASCII Grid format file.
♦ BIL - export to a BIL format file (simple binary format with header).
♦ BT - export to a BT (Binary Terrain) format grid file.
♦ DXF_3DFACE - export a DXF 3D face format file.
♦ DXF_MESH - export a 3D DXF mesh format file.
♦ DXF_POINT - export a 3D DXF point format file.
♦ ERDAS - export to an Erdas Imagine IMG format file.
♦ FLOATGRID - export a Float/Grid format file.
♦ GEOSOFT_GRID - export to a Geosoft grid format file.
♦ GEOTIFF - export to a GeoTIFF format file.
♦ GLOBAL_MAPPER_GRID - export to a Global Mapper Grid format file.
♦ GRAVSOFT_GRID - export to a Gravsoft Grid format file.
♦ HF2 - export to a HF2/HFZ format file.
♦ IDRISI_RASTER - export to an Idrisi elevation format file.
♦ LEVELLER_HF - export to a Leveller heightfield file.
♦ LIDAR_LAS - export to a Lidar LAS file.
♦ MAPMAKERTERRAIN - export to a MapMaker Terrain format file.
♦ ROCKWORKS_GRID - export to a RockWorks Grid format file.
♦ STL - export to a STL format file

Map GPS Coordinates - GPS Map Coordinates - GPSCoordinates Map 198

 Global Mapper User's Manual
♦ SURFERGRID - export to a Surfer Grid format file. The FORMAT parameter specifies
whether it is an ASCII or binary format Surfer Grid file.
♦ TERRAGEN - export to a Terragen terrain file.
♦ USGS_DEM - export to a native format USGS DEM file.
♦ VRML - export to a VRML file.
♦ VULCAN_3D - export to a Vulcan3D triangulation file.
♦ XYZ_GRID - export to a XYZ Grid file.
• ELEV_UNITS - specify elevation units to use in export
♦ FEET - export in US feet
♦ DECIFEET - export in 10ths of US feet
♦ METERS - export in meters
♦ DECIMETERS - export in 10ths of meters
♦ CENTIMETERS - export in centimeters
• SPATIAL_RES - specifies spatial resolution. Defaults to the minimum spatial resolution of all loaded
data if not specified. Should be formatted as x_resolution,y_resolution. The units are the units of the
current global projection. For example, if UTM was the current global projection and you wanted to
export at 30 meter spacing, the parameter/value pair would look like SPATIAL_RES=30.0,30.0.
• FORCE_SQUARE_PIXELS - if this value is set to YES, the spatial resolution of the resultant
elevation file will be set so that the x and y pixel size are the same, with the minimum default size
being used for both.
• GLOBAL_BOUNDS - specifies the export bounds in units of the current global projection. There
should be 4 values in a comma-delimited list following the parameter name. The values should be in
order of minimum x, minimum y, maximum x, maximum y.
• GLOBAL_BOUNDS_SIZE - specifies the export bounds in units of the current global projection.
There should be 4 values in a comma-delimited list following the parameter name. The values should
be in order of minimum x, minimum y, width in x, width in y.
• LAT_LON_BOUNDS - specifies the export bounds in latitude/longitude degrees. There should be 4
values in a comma-delimited list following the parameter name. The values should be in order of
westmost longitude, southernmost latitude, easternmost longitude, northernmost latitude.
• LAYER_BOUNDS - specifies that the export should use the bounds of the loaded layer(s) with the
given filename. For example, to export to the bounds of the file "c:\test.tif", you would use
LAYER_BOUNDS="c:\test.tif". Keep in mind that the file must be currently loaded.
• LAYER_BOUNDS_EXPAND - specifies that the operation should expand the used
LAYER_BOUNDS bounding box by some amount. The amount to expand the bounding rectangle by
should be specified in the current global projection. For example, if you have a UTM/meters
projection active and want to expand the bounds retrieved from the LAYER_BOUNDS parameter by
100 meters on the left and right, and 50 meters on the top and bottom, you could use
LAYER_BOUNDS_EXPAND="100.0,50.0". You can also specify a single value to apply to all 4
sides, or supply 4 separate values in the order left,top,right,bottom.
• FORMAT (SURFERGRID only) - determines if Surfer Grid export format is ASCII, BINARY_V6, or
BINARY_V7. The default is ASCII if no format is specified.
• GEN_WORLD_FILE (GEOTIFF only) - specifies that a TIFF world file (TFW) should be generated
in addition to the TIFF file. Use GEN_WORLD_FILE=YES to turn on.
• GEN_TAB_FILE (GEOTIFF only) - specifies that a MapInfo TAB file should be generated in
addition to the GeoTIFF file. Use GEN_TAB_FILE=YES to turn on.
• GRID_TYPE_CELL_SIZE - specifies that the export should be gridded into multiple tiles with each
tile having the given size in the export projection. The value should be specified as cell width,cell
height. For example, if you are exporting in a metric projection and want to tile the export into cells
that are 10,000 meters wide by 5,000 meters tall, you would use
GRID_TYPE_CELL_SIZE="10000.0,5000.0".

Map GPS Coordinates - GPS Map Coordinates - GPSCoordinates Map 199

 Global Mapper User's Manual

• GRID_TYPE_PIXEL_SIZE - specifies that the export should be gridded into multiple tiles with each
tile having the given size in pixels/samples. The value should be specified as cell pixel width,cell pixel
height. For example, if you want to tile the export into cells that are 800 pixels wide by 600 meters
tall, you would use GRID_TYPE_PIXEL_SIZE="800,600".
• GRID_TYPE_ROWS_COLS - specifies that the export should be gridded into multiple tiles with a
given number of rows and columns of tiles. The value should be specified as number of rows,number
of columns. For example, if you want to tile the export into a grid of 8 rows each 4 tiles across, you
would use GRID_TYPE_ROWS_COLS="8,4".
• GRID_OVERLAP - specifies how much to overlap tiles when gridding an export into multiple tiles.
This is a percentage value from 0 to 100 and only applies when on of the GRID_TYPE_* parameters
is used. For example, to make your grid tiles overlap by 5% of the grid tile size, use
GRID_OVERLAP="5.0". The default value is 0.0, meaning that the tiles do not overlap.
• GRID_KEEP_CELL_SIZE - specifies that the size of the grid cells should be maintained over sample
spacing. This means that if you specify a grid of 4 rows and 5 columns, each grid cell will be exactly
25% of the total export height and 20% of the total export width. The sample spacing may be slightly
smaller than what is specified in order to achieve this. By default, the sample spacing is exactly
maintained and each grid cell may be slightly larger than specified to maintain an integer number of
exported cells. Use GRID_KEEP_CELL_SIZE=YES to enable.
• GRID_NAMING - specifies how to name tiles when gridding an export into multiple tiles. The value
should be SEQUENTIAL for sequential numeric naming starting at 1, SEPARATE for separate prefix
appending by row and column, or SEPARATE_COLS_FIRST for separate prefix appending by
columns and rows. For the SEPARATE options, use the GRID_NAMING_COLS and
GRID_NAMING_ROWS parameters to specify the details of how to name the rows and columns. If
no GRID_NAMING parameter is supplied, the last selected grid naming options selected in the user
interface will be used.
• GRID_NAMING_COLS - specifies how to name the column portion of grid cell names when using
the GRID_NAMING=SEPARATE or GRID_NAMING=SEPARATE_COLS_FIRST parameter. The
value of this field is a comma-delimited list with the following field values:
♦ Naming type. Can have the following values:
◊ NUM - name using numbers in ascending order
◊ NUM_REVERSE - name using numbers in descending order
◊ ALPHA - name using letters in ascending order
◊ ALPHA_REVERSE - name using letters in descending order
♦ Starting value for numbering or lettering (i.e. '1', or 'A').
♦ Prefix string to use before the numeric or alphabetic value.
♦ Step value for numeric naming (default is '1')
You can leave values blank if they don't apply or you want to use the default. As an example, to do
numeric naming starting at the number 100, increasing by 10 each time with a prefix of DEM, you
would use GRID_NAMING_COLS="NUM,100,DEM,10".
• GRID_NAMING_ROWS - specifies how to name the row portion of grid cell names when using the
GRID_NAMING=SEPARATE parameter. See the documentation for the GRID_NAMING_COLS
parameter above for details on the format.
• GRID_NAMING_PREPEND_ZEROES - specifies whether or not to prepend zeroes to the start of
grid column/row names. Use GRID_NAMING_PREPEND_ZEROES=NO to disable the prepending
of zeroes.
• GRID_NAMING_SEPARATOR - specifies the separator string to use between pieces of a grid name.
The default is an underscore.
• GRID_CREATE_FOLDERS - specifies that a separate folder should be generated for each row (or
column if GRID_NAMING=SEPARATE_COLS_FIRST is specified) of the export rather than
placing every output file in the same folder.

Map GPS Coordinates - GPS Map Coordinates - GPSCoordinates Map 200

 Global Mapper User's Manual
• QUAD_NAME (USGS_DEM only) - specifies the quad name to place in the header of the USGS
DEM file.
• FILL_GAPS - specifies that small gaps in between and within the data sets being exported will be
filled in by interpolating the surrounding data to come up with an elevation for the point in question.
This option is on by default, specify FILL_GAPS=NO to turn off.
• VERT_EXAG (VRML only) - specifies the vertical exaggeration to use when creating the VRML file.
Larger values result in a rougher terrain being generated while smaller values result in a smoother
terrain. A value of 1.0 results in no vertical exaggeration at all (i.e. a nearly true to life
representation). If you don't specify a value the currently selected vertical exaggeration value on the
Vertical Options tab of the Configuation dialog will be used.
• COORD_DELIM (XYZ_GRID only) - specifies the delimeter between coordinates
♦ COMMA - coordinates are separated by commas
♦ FIXED_WIDTH - coordinates are stored in fixed width columns
♦ SEMICOLON - coordinates are separated by semicolons
♦ SPACE - coordinates are separated by space characters
♦ TAB - coordinates are separated by tab characters
• BYTES_PER_SAMPLE (BIL, ERDAS, and GEOTIFF only) - specifies how many bytes to use per
elevation sample in the BIL, IMG, or vertical GeoTIFF file. Valid values are 2 bytes (16-bits) and 4
bytes (32-bits). If this value isn't specified, 2 bytes are used.
• USE_BIG_ENDIAN (BIL only) - specifies that elevation values written to BIL files should use big
endian (Motorola byte order) rather than the default little endian (Intel byte order).
• POLYGON_CROP_FILE - specifies the full path and filename of a vector file containing a polygon
feature to which the export should be cropped. If multiple polygons are found in the specified file the
polygon which has the largest intersection with the data to be exported will be used as the crop
polygon (see POLYGON_CROP_USE_ALL for exception).
• POLYGON_CROP_NAME - specifies the name of a polygon shape previously defined using the
DEFINE_SHAPE command to which the export should be cropped. The coordinates in the shape
need to have been provided in whatever projection the export is being done in.
• POLYGON_CROP_USE_ALL - specifies that if a POLYGON_CROP_FILE is specified that
contains multiple polygons, the export will be cropped to all polygons in that file rather than just the
best-fit polygon.
• POLYGON_CROP_USE_EACH - specifies that if a POLYGON_CROP_FILE is specified that
contains multiple polygons, the operation will generate a separate export for each polygons in that file
rather than just the best-fit polygon. See the POLYGON_CROP_BBOX_ONLY and
POLYGON_CROP_NAME_ATTR options for naming and other options when using this parameter.
Use POLYGON_CROP_USE_EACH=YES to enable.
• POLYGON_CROP_BBOX_ONLY - specifies that if the POLYGON_CROP_USE_EACH parameter
is specified that each export should just be cropped to the bounding box of each polygon rather than
the actual boundary of the polygon. Use POLYGON_CROP_BBOX_ONLY=YES to enable only
cropping to the bounding box.
• POLYGON_CROP_NAME_ATTR - used to control the filenames generated when cropping to
multiple polygons using the POLYGON_CROP_USE_EACH parameter. This should be the actual
name of the attribute from the polygon features to use for naming, or the special values <Area Display
Label> or <Area Source Filename>. If no value is provided, the exported files will be sequentially
numbered.
• ALLOW_LOSSY (GLOBAL_MAPPER_GRID only) - specifies whether or not a slight loss in
precision is allowable in order to achieve better compression ratios. The default is YES, so turn only
use lossless compression you need to specify a value of ALLOW_LOSSY=NO.
• EXPORT_COLORS (XYZ_GRID only) - specifies that RGB color values should be exported for each
coordinate that is saved.

Map GPS Coordinates - GPS Map Coordinates - GPSCoordinates Map 201

 Global Mapper User's Manual

• OVERWRITE_EXISTING - specifies that existing files should be overwritten. The default is

OVERWRITE_EXISTING=YES, so use OVERWRITE_EXISTING=NO to skip exporting files that
already exist.
• ADD_OVERVIEW_LAYERS (ERDAS only) - specifies that overview (pyramid) layers should be
generated for the export. Use ADD_OVERVIEW_LAYERS=YES to enable.
• BLOCK_SIZE (ERDAS only) - specifies the block size to use for the export. The default is
BLOCK_SIZE=64.
• COMPRESS_OUTPUT (ERDAS only) - specifies whether or not the exported file should be
compress. The default is COMPRESS_OUTPUT=YES.
• TILE_SIZE (GEOTIFF only) - specifies that the GeoTIFF file should be exported with a tiled
organization and use the specified tile size. This tile size should be between 8 and 2048. Typical
values are 64, 128, and 256.
• DISABLE_BIGTIFF (GEOTIFF only) - use to disable the automatic creation of BigTIFF-format files
for very large exports. Use DISABLE_BIGTIFF=YES to disable the automatic BigTIFF support.

EXPORT_METADATA

The EXPORT_METADATA command exports the metadata for a specified load layer. The following
parameters are supported by the command.

• FILENAME - full path of file (must already be loaded) that you want to save the metadata for.
• METADATA_FILENAME - full path of new text file to create on disk containing the metadata for
the specified layer.

EXPORT_PACKAGE

The EXPORT_PACKAGE command exports all currently loaded raster, vector, and elevation data to a Global
Mapper Package (GMP) file. The following parameters are supported by the command.

• FILENAME - full path to file to save the data to

• SIMPLIFICATION - specifies the simplification threshold to use when exporting the vector features.
This specifies how far off a straight line (in the units of the current projection) that a point has to be
before it is kept. Generally you should not specify a simplification value as the default just exports all
vertices as they are. This is an option for advanced users only.
• SINGLE_PRECISION - specifies that vector coordinates should be written out as 4-byte single
precision floating point numbers rather than the default 8-byte double precision floating point
numbers. Use SINGLE_PRECISION=YES to enable single precision export, which will result in
smaller files.
• DISCARD_ATTRIBUTES - specifies that the list of attribute-value pairs for each vector feature
should not be written out. Use DISCARD_ATTRIBUTES=YES to enable this behavior.
• KEEP_ALL_STYLES - specifies that the full style of each feature should be written to the package
file, even if it uses the current default for the type. Use KEEP_ALL_STYLES=YES to enable this.
This is useful if you want features to look exactly the same on all systems and not be affected by
changes to the default styling for types.
• KEEP_NATIVE_PROJECTION - specifies that each layer should be exported in the native projection
of the layer rather than reprojected to the current projection. Use
KEEP_NATIVE_PROJECTION=YES to enable this behavior.

Map GPS Coordinates - GPS Map Coordinates - GPSCoordinates Map 202

 Global Mapper User's Manual
• COMBINE_VECTOR_LAYERS - specifies that all vector data should be combined into a single
layer within the package file. Use COMBINE_VECTOR_LAYERS=YES to enable this behavior.
• GLOBAL_BOUNDS - specifies the export bounds in units of the current global projection. There
should be 4 values in a comma-delimited list following the parameter name. The values should be in
order of minimum x, minimum y, maximum x, maximum y.
• GLOBAL_BOUNDS_SIZE - specifies the export bounds in units of the current global projection.
There should be 4 values in a comma-delimited list following the parameter name. The values should
be in order of minimum x, minimum y, width in x, width in y.
• LAT_LON_BOUNDS - specifies the export bounds in latitude/longitude degrees. There should be 4
values in a comma-delimited list following the parameter name. The values should be in order of
westmost longitude, southernmost latitude, easternmost longitude, northernmost latitude.
• LAYER_BOUNDS - specifies that the export should use the bounds of the loaded layer(s) with the
given filename. For example, to export to the bounds of the file "c:\test.tif", you would use
LAYER_BOUNDS="c:\test.tif". Keep in mind that the file must be currently loaded.
• LAYER_BOUNDS_EXPAND - specifies that the operation should expand the used
LAYER_BOUNDS bounding box by some amount. The amount to expand the bounding rectangle by
should be specified in the current global projection. For example, if you have a UTM/meters
projection active and want to expand the bounds retrieved from the LAYER_BOUNDS parameter by
100 meters on the left and right, and 50 meters on the top and bottom, you could use
LAYER_BOUNDS_EXPAND="100.0,50.0". You can also specify a single value to apply to all 4
sides, or supply 4 separate values in the order left,top,right,bottom.
• GRID_TYPE_CELL_SIZE - specifies that the export should be gridded into multiple tiles with each
tile having the given size in the export projection. The value should be specified as cell width,cell
height. For example, if you are exporting in a metric projection and want to tile the export into cells
that are 10,000 meters wide by 5,000 meters tall, you would use
GRID_TYPE_CELL_SIZE="10000.0,5000.0".
• GRID_TYPE_ROWS_COLS - specifies that the export should be gridded into multiple tiles with a
given number of rows and columns of tiles. The value should be specified as number of rows,number
of columns. For example, if you want to tile the export into a grid of 8 rows each 4 tiles across, you
would use GRID_TYPE_ROWS_COLS="8,4".
• GRID_OVERLAP - specifies how much to overlap tiles when gridding an export into multiple tiles.
This is a percentage value from 0 to 100 and only applies when on of the GRID_TYPE_* parameters
is used. For example, to make your grid tiles overlap by 5% of the grid tile size, use
GRID_OVERLAP="5.0". The default value is 0.0, meaning that the tiles do not overlap.
• GRID_KEEP_CELL_SIZE - specifies that the size of the grid cells should be maintained over sample
spacing. This means that if you specify a grid of 4 rows and 5 columns, each grid cell will be exactly
25% of the total export height and 20% of the total export width. The sample spacing may be slightly
smaller than what is specified in order to achieve this. By default, the sample spacing is exactly
maintained and each grid cell may be slightly larger than specified to maintain an integer number of
exported cells. Use GRID_KEEP_CELL_SIZE=YES to enable.
• GRID_NAMING - specifies how to name tiles when gridding an export into multiple tiles. The value
should be SEQUENTIAL for sequential numeric naming starting at 1, SEPARATE for separate prefix
appending by row and column, or SEPARATE_COLS_FIRST for separate prefix appending by
columns and rows. For the SEPARATE options, use the GRID_NAMING_COLS and
GRID_NAMING_ROWS parameters to specify the details of how to name the rows and columns. If
no GRID_NAMING parameter is supplied, the last selected grid naming options selected in the user
interface will be used.
• GRID_NAMING_COLS - specifies how to name the column portion of grid cell names when using
the GRID_NAMING=SEPARATE or GRID_NAMING=SEPARATE_COLS_FIRST parameter. The
value of this field is a comma-delimited list with the following field values:
♦ Naming type. Can have the following values:

Map GPS Coordinates - GPS Map Coordinates - GPSCoordinates Map 203

 Global Mapper User's Manual
◊ NUM - name using numbers in ascending order
◊ NUM_REVERSE - name using numbers in descending order
◊ ALPHA - name using letters in ascending order
◊ ALPHA_REVERSE - name using letters in descending order
♦ Starting value for numbering or lettering (i.e. '1', or 'A').
♦ Prefix string to use before the numeric or alphabetic value.
♦ Step value for numeric naming (default is '1')
You can leave values blank if they don't apply or you want to use the default. As an example, to do
numeric naming starting at the number 100, increasing by 10 each time with a prefix of DEM, you
would use GRID_NAMING_COLS="NUM,100,DEM,10".
• GRID_NAMING_ROWS - specifies how to name the row portion of grid cell names when using the
GRID_NAMING=SEPARATE parameter. See the documentation for the GRID_NAMING_COLS
parameter above for details on the format.
• GRID_NAMING_PREPEND_ZEROES - specifies whether or not to prepend zeroes to the start of
grid column/row names. Use GRID_NAMING_PREPEND_ZEROES=NO to disable the prepending
of zeroes.
• GRID_NAMING_SEPARATOR - specifies the separator string to use between pieces of a grid name.
The default is an underscore.
• GRID_CREATE_FOLDERS - specifies that a separate folder should be generated for each row (or
column if GRID_NAMING=SEPARATE_COLS_FIRST is specified) of the export rather than
placing every output file in the same folder.
• POLYGON_CROP_FILE - specifies the full path and filename of a vector file containing a polygon
feature to which the export should be cropped. If multiple polygons are found in the specified file the
polygon which has the largest intersection with the data to be exported will be used as the crop
polygon (see POLYGON_CROP_USE_ALL or POLYGON_CROP_USE_EACH for exceptions).
• POLYGON_CROP_NAME - specifies the name of a polygon shape previously defined using the
DEFINE_SHAPE command to which the export should be cropped. The coordinates in the shape
need to have been provided in whatever projection the export is being done in.
• POLYGON_CROP_USE_ALL - specifies that if a POLYGON_CROP_FILE is specified that
contains multiple polygons, the export will be cropped to all polygons in that file rather than just the
best-fit polygon.
• POLYGON_CROP_USE_EACH - specifies that if a POLYGON_CROP_FILE is specified that
contains multiple polygons, the operation will generate a separate export for each polygons in that file
rather than just the best-fit polygon. See the POLYGON_CROP_BBOX_ONLY and
POLYGON_CROP_NAME_ATTR options for naming and other options when using this parameter.
Use POLYGON_CROP_USE_EACH=YES to enable.
• POLYGON_CROP_BBOX_ONLY - specifies that if the POLYGON_CROP_USE_EACH parameter
is specified that each export should just be cropped to the bounding box of each polygon rather than
the actual boundary of the polygon. Use POLYGON_CROP_BBOX_ONLY=YES to enable only
cropping to the bounding box.
• POLYGON_CROP_NAME_ATTR - used to control the filenames generated when cropping to
multiple polygons using the POLYGON_CROP_USE_EACH parameter. This should be the actual
name of the attribute from the polygon features to use for naming, or the special values <Area Display
Label> or <Area Source Filename>. If no value is provided, the exported files will be sequentially
numbered.
• OVERWRITE_EXISTING - specifies that existing files should be overwritten. The default is
OVERWRITE_EXISTING=YES, so use OVERWRITE_EXISTING=NO to skip exporting files that
already exist.

Map GPS Coordinates - GPS Map Coordinates - GPSCoordinates Map 204

 Global Mapper User's Manual
EXPORT_RASTER

The EXPORT_RASTER command exports all currently loaded raster, vector, and elevation data to a file. The
following parameters are supported by the command.

• FILENAME - full path to file to save the data to

• TYPE - type of raster file we're exporting to
♦ BIL - export to a band interleave (BIL) format file.
♦ BIP - export to a band interleaved pixel (BIP) format file.
♦ BSQ - export to a band sequential (BSQ) format file.
♦ ECW - export to an ECW format file.
♦ ERDAS - export to an Erdas Imagine IMG format file.
♦ GEOTIFF - export to a GeoTIFF format file.
♦ IDRISI_RASTER - export to an Idrisi raster format file.
♦ JPEG - export to a JPG format file.
♦ JPEG2000 - export to a JPEG2000 format file.
♦ KML - export to a raster KML/KMZ format file for display in Google Earth.
♦ PNG - export to a PNG format file.
• SPATIAL_RES - specifies spatial resolution. Defaults to the minimum spatial resolution of all loaded
data if not specified. Should be formatted as x_resolution,y_resolution. The units are the units of the
current global projection. For example, if UTM was the current global projection and you wanted to
export at 30 meter spacing, the parameter/value pair would look like SPATIAL_RES=30.0,30.0.
• PIXEL_SIZE - specifies the desired size in pixels of your export. Use this instead of SPATIAL_RES
if you know exactly how many pixels in size your export should be. The format is
PIXEL_SIZE="widthxheight". For example, to make your export have dimensions of 1024 pixels
wide by 768 pixels tall, use PIXEL_SIZE="1024x768".
• FORCE_SQUARE_PIXELS - if this value is set to YES, the spatial resolution of the resultant raster
file will be set so that the x and y pixel size are the same, with the minimum default size being used
for both.
• GLOBAL_BOUNDS - specifies the export bounds in units of the current global projection. There
should be 4 values in a comma-delimited list following the parameter name. The values should be in
order of minimum x, minimum y, maximum x, maximum y.
• GLOBAL_BOUNDS_SIZE - specifies the export bounds in units of the current global projection.
There should be 4 values in a comma-delimited list following the parameter name. The values should
be in order of minimum x, minimum y, width in x, width in y.
• LAT_LON_BOUNDS - specifies the export bounds in latitude/longitude degrees. There should be 4
values in a comma-delimited list following the parameter name. The values should be in order of
westmost longitude, southernmost latitude, easternmost longitude, northernmost latitude.
• LAYER_BOUNDS - specifies that the export should use the bounds of the loaded layer(s) with the
given filename. For example, to export to the bounds of the file "c:\test.tif", you would use
LAYER_BOUNDS="c:\test.tif". Keep in mind that the file must be currently loaded.
• LAYER_BOUNDS_EXPAND - specifies that the operation should expand the used
LAYER_BOUNDS bounding box by some amount. The amount to expand the bounding rectangle by
should be specified in the current global projection. For example, if you have a UTM/meters
projection active and want to expand the bounds retrieved from the LAYER_BOUNDS parameter by
100 meters on the left and right, and 50 meters on the top and bottom, you could use
LAYER_BOUNDS_EXPAND="100.0,50.0". You can also specify a single value to apply to all 4
sides, or supply 4 separate values in the order left,top,right,bottom.
• GEN_WORLD_FILE - specifies that a world file should be generated in addition to the image file.
Use GEN_WORLD_FILE=YES to turn on.

Map GPS Coordinates - GPS Map Coordinates - GPSCoordinates Map 205

 Global Mapper User's Manual
• GEN_TAB_FILE (GEOTIFF and PNGonly) - specifies that a MapInfo TAB file should be generated
in addition to the image file. Use GEN_TAB_FILE=YES to turn on.
• GEN_PRJ_FILE - specifies that a projection (PRJ) file should be generated in addition to the data
file. Use GEN_PRJ_FILE=YES to turn on.
• PALETTE - specifies the palette/image type to use. If not specified, a 24-bit RGB image will be
generated.
♦ KEEP_SOURCE

- The exported file will use the some color configuration (if possible) as the file being
exported. Note that this option is only available if you have only a single layer loaded for
export.
♦ OPTIMIZED (ERDAS, GEOTIFF, and PNG only) - The palette generated will be an optimal
mix of up to 256 colors that will closely represent the full blend of colors in the source
images. This option will generate the best results, but can more than double the export time
required if any high color images are present in the export set.
♦ HALFTONE (ERDAS, GEOTIFF, and PNG only) - use a 256-color halftone palette spread
over the color spectrum
♦ DOQ_DRG (ERDAS, GEOTIFF, and PNG only) - use a 256-color palette optimized for
combined grayscale DOQs and USGS DRGs
♦ DRG (ERDAS, GEOTIFF, and PNG only) - use a 256-color palette optimized for the colors
found in USGS DRGs
♦ GRAYSCALE - use a 256-color grayscale palette
♦ BW (GEOTIFF only) - creates a black and white, 1-bit per pixel image
♦ BLACKISMIN (GEOTIFF only) - creates an 8-bit per pixel grayscale image with no color
map stored in the image. Black will be stored as zero with varying shades of gray up to white
with a value of 255.
♦ WHITEISMIN (GEOTIFF only) - creates an 8-bit per pixel grayscale image with no color
map stored in the image. White will be stored as zero with varying shades of gray up to black
with a value of 255.
♦ JPG (GEOTIFF only) - creates a 24-bit RGB JPG-in-TIFF image. Note that while this creates
a highly compressed GeoTIFF file, many software packages do not recognize JPG-in-TIFF
format files.
♦ MULTIBAND (GEOTIFF only) - creates a multi-band GeoTIFF file with any number of
bands of data. This is useful for multi-spectral imagery. Either 8- or 16-bits per band will be
used depending on what is available in the input data. Use the NUM_BANDS parameter to
specify how many bands to use. You can override the default band setting using the
BAND_EXPORT_SETUP parameter (described below).
♦ Custom palette filename - you can also pass in the full path to a .pal file containing a custom
palette to use for the export.
• NUM_BANDS - specifies how many bands of data to export for a PALETTE=MULTIBAND export.
If you don't specify a value for this the band count will be the maximum available for any of the
loaded layers.
• BAND_BIT_DEPTH - specifies how many bits to use for each band of data for a
PALETTE=MULTIBAND export. If you don't specify a value for this the highest bit depth of any of
the input data layers will be used. The valid values are BAND_BIT_DEPTH=8,
BAND_BIT_DEPTH=16, or BAND_BIT_DEPTH=32.
• BAND_EXPORT_SETUP - allows you to override the default band assignment for a MULTIBAND
export. Use the following format to specify what band from what layer to use for a given export band:
<output_band>?<input_band>?<layer_filename> . So for example to assign the 4th (infrared) band in
an export from the 1st (red) band in a previously loaded file name C:\data\input_file.tif, use the
following parameter: BAND_EXPORT_SETUP="4?1?c:\data\input_file.tif". Note that you would

Map GPS Coordinates - GPS Map Coordinates - GPSCoordinates Map 206

 Global Mapper User's Manual
include a separate BAND_EXPORT_SETUP parameter for each output band that you want to setup.
If you leave off the filename then you all loaded data will be considered as input, with just the
input-to-output band assignment being updated.
• GRID_TYPE_CELL_SIZE - specifies that the export should be gridded into multiple tiles with each
tile having the given size in the export projection. The value should be specified as cell width,cell
height. For example, if you are exporting in a metric projection and want to tile the export into cells
that are 10,000 meters wide by 5,000 meters tall, you would use
GRID_TYPE_CELL_SIZE="10000.0,5000.0".
• GRID_TYPE_PIXEL_SIZE - specifies that the export should be gridded into multiple tiles with each
tile having the given size in pixels/samples. The value should be specified as cell pixel width,cell pixel
height. For example, if you want to tile the export into cells that are 800 pixels wide by 600 meters
tall, you would use GRID_TYPE_PIXEL_SIZE="800,600".
• GRID_TYPE_ROWS_COLS - specifies that the export should be gridded into multiple tiles with a
given number of rows and columns of tiles. The value should be specified as number of rows,number
of columns. For example, if you want to tile the export into a grid of 8 rows each 4 tiles across, you
would use GRID_TYPE_ROWS_COLS="8,4".
• GRID_OVERLAP - specifies how much to overlap tiles when gridding an export into multiple tiles.
This is a percentage value from 0 to 100 and only applies when on of the GRID_TYPE_* parameters
is used. For example, to make your grid tiles overlap by 5% of the grid tile size, use
GRID_OVERLAP="5.0". The default value is 0.0, meaning that the tiles do not overlap.
• GRID_KEEP_CELL_SIZE - specifies that the size of the grid cells should be maintained over sample
spacing. This means that if you specify a grid of 4 rows and 5 columns, each grid cell will be exactly
25% of the total export height and 20% of the total export width. The sample spacing may be slightly
smaller than what is specified in order to achieve this. By default, the sample spacing is exactly
maintained and each grid cell may be slightly larger than specified to maintain an integer number of
exported cells. Use GRID_KEEP_CELL_SIZE=YES to enable.
• GRID_NAMING - specifies how to name tiles when gridding an export into multiple tiles. The value
should be SEQUENTIAL for sequential numeric naming starting at 1, SEPARATE for separate prefix
appending by row and column, or SEPARATE_COLS_FIRST for separate prefix appending by
columns and rows. For the SEPARATE options, use the GRID_NAMING_COLS and
GRID_NAMING_ROWS parameters to specify the details of how to name the rows and columns. If
no GRID_NAMING parameter is supplied, the last selected grid naming options selected in the user
interface will be used.
• GRID_NAMING_COLS - specifies how to name the column portion of grid cell names when using
the GRID_NAMING=SEPARATE or GRID_NAMING=SEPARATE_COLS_FIRST parameter. The
value of this field is a comma-delimited list with the following field values:
♦ Naming type. Can have the following values:
◊ NUM - name using numbers in ascending order
◊ NUM_REVERSE - name using numbers in descending order
◊ ALPHA - name using letters in ascending order
◊ ALPHA_REVERSE - name using letters in descending order
♦ Starting value for numbering or lettering (i.e. '1', or 'A').
♦ Prefix string to use before the numeric or alphabetic value.
♦ Step value for numeric naming (default is '1')
You can leave values blank if they don't apply or you want to use the default. As an example, to do
numeric naming starting at the number 100, increasing by 10 each time with a prefix of DEM, you
would use GRID_NAMING_COLS="NUM,100,DEM,10".
• GRID_NAMING_ROWS - specifies how to name the row portion of grid cell names when using the
GRID_NAMING=SEPARATE parameter. See the documentation for the GRID_NAMING_COLS
parameter above for details on the format.

Map GPS Coordinates - GPS Map Coordinates - GPSCoordinates Map 207

 Global Mapper User's Manual
• GRID_NAMING_PREPEND_ZEROES - specifies whether or not to prepend zeroes to the start of
grid column/row names. Use GRID_NAMING_PREPEND_ZEROES=NO to disable the prepending
of zeroes.
• GRID_NAMING_SEPARATOR - specifies the separator string to use between pieces of a grid name.
The default is an underscore.
• GRID_CREATE_FOLDERS - specifies that a separate folder should be generated for each row (or
column if GRID_NAMING=SEPARATE_COLS_FIRST is specified) of the export rather than
placing every output file in the same folder.
• QUALITY (JPEG only) - specifies the quality setting to use when generating the image. Valid values
range from 1 to 100, with 1 generating the lowest quality image and 100 generating the highest
quality image. If no QUALITY setting is present, a default value of 75 is used which generates a very
high quality image that is still highly compressed.
• TARGET_COMPRESSION (ECW and JPEG2000 only) - specifies the target compression ratio to
use when creating the ECW image. The default value is 10 which strikes a good balance between
image quality and compression. The higher the value, the smaller the resulting image will be at the
expense of image quality.
• INC_VECTOR_DATA - specifies whether or not loaded vector data should be rendered and exported
to the generated image. Use a value of YES to indicate that vector data should be used. Any other
value will result in vector data NOT being saved to the file.
• FILL_GAPS - specifies that small gaps in between and within the data sets being exported will be
filled in by interpolating the surrounding data to come up with a color for the point in question. This
option is off by default, specify FILL_GAPS=YES to turn it on.
• POLYGON_CROP_FILE - specifies the full path and filename of a vector file containing a polygon
feature to which the export should be cropped. If multiple polygons are found in the specified file the
polygon which has the largest intersection with the data to be exported will be used as the crop
polygon (see POLYGON_CROP_USE_ALL or POLYGON_CROP_USE_EACH for exceptions).
• POLYGON_CROP_NAME - specifies the name of a polygon shape previously defined using the
DEFINE_SHAPE command to which the export should be cropped. The coordinates in the shape
need to have been provided in whatever projection the export is being done in.
• POLYGON_CROP_USE_ALL - specifies that if a POLYGON_CROP_FILE is specified that
contains multiple polygons, the export will be cropped to all polygons in that file rather than just the
best-fit polygon.
• POLYGON_CROP_USE_EACH - specifies that if a POLYGON_CROP_FILE is specified that
contains multiple polygons, the operation will generate a separate export for each polygons in that file
rather than just the best-fit polygon. See the POLYGON_CROP_BBOX_ONLY and
POLYGON_CROP_NAME_ATTR options for naming and other options when using this parameter.
Use POLYGON_CROP_USE_EACH=YES to enable.
• POLYGON_CROP_BBOX_ONLY - specifies that if the POLYGON_CROP_USE_EACH parameter
is specified that each export should just be cropped to the bounding box of each polygon rather than
the actual boundary of the polygon. Use POLYGON_CROP_BBOX_ONLY=YES to enable only
cropping to the bounding box.
• POLYGON_CROP_NAME_ATTR - used to control the filenames generated when cropping to
multiple polygons using the POLYGON_CROP_USE_EACH parameter. This should be the actual
name of the attribute from the polygon features to use for naming, or the special values <Area Display
Label> or <Area Source Filename>. If no value is provided, the exported files will be sequentially
numbered.
• ONLY_GENERATE_METADATA (GEOTIFF, JPEG, and PNG only) - specifies that only metadata
files like world files, TAB files, and PRJ files should be created for this file. This is useful for things
like generating world and TAB files from GeoTIFF files without doing a whole new export. Just
make the output filename the same as the loaded file to create the metadata for.

Map GPS Coordinates - GPS Map Coordinates - GPSCoordinates Map 208

 Global Mapper User's Manual
• USE_LZW (GEOTIFF only) - specifies that LZW compression should be used for this RGB or
palette-based GeoTIFF file. LZW compression typically results in much smaller files than the default
compression, but there may be some software packages that do not yet support LZW-encoded
GeoTIFF files. Specify USE_LZW=YES to enable LZW compression.
• TILE_SIZE (GEOTIFF only) - specifies that the GeoTIFF file should be exported with a tiled
organization and use the specified tile size. This tile size should be between 8 and 2048. Typical
values are 64, 128, and 256.
• SAVE_SCALE_AND_LEGEND - specifies that the distance scale and elevation legend, if applicable
and enabled for display on the Configuration dialog, should be exported to the generated raster file.
Specify SAVE_SCALE_AND_LEGEND=YES to enable this option.
• BG_TRANSPARENT (RGB GEOTIFF and PNG only) - specifies that any areas of no
data/background should be marked as transparent. Use BG_TRANSPARENT=YES to enable.
• OVERWRITE_EXISTING - specifies that existing files should be overwritten. The default is
OVERWRITE_EXISTING=YES, so use OVERWRITE_EXISTING=NO to skip exporting files that
already exist.
• DPI (GEOTIFF and JPG only) - specifies the DPI (dots per inch) value to save in the generated
file(s). For example, use DPI=300 to specify that the DPI for this file is 300. By default no DPI value
will be written out.
• KML_MIN_LOD_PIXELS (KML only) - specifies how large layer has to be in pixels before it will
show up in Google Earth.
• KML_RASTER_FORMAT (KML only) - specified which raster image format to use when creating
tiles for KML/KMZ files. The valid options are JPG, PNG, and TIFF. For example, add
KML_RASTER_FORMAT=JPG to use JPG format files.
• KML_SUPER_OVERLAY (KML only) - specifies that the data should be automatically gridded into
"super overlays" to allow displaying large quantities of data in Google Earth. Use
KML_SUPER_OVERLAY=YES to enable this behavior.
• KML_TILE_SIZE (KML only) - if data is being automatically gridded into "super overlays", this
specifies the size of tiles to use for gridding. The default tile size is 1024. To change this for example
to 512x512, use KML_TILE_SIZE=512.
• KML_ZOOM_SCALE_FACTOR (KML only) - if data is being automatically gridded into "super
overlays", this specifies the multiplier to use when creating zoomed out pyramid layers. The default
value of 2 makes each successive zoom level 1/2 the resolution of the previous one until everything
fits in a single tile. To change this to making each layer 1/3rd the resolution of the previous one, use
KML_ZOOM_SCALE_FACTOR=3.
• ADD_OVERVIEW_LAYERS (ERDAS only) - specifies that overview (pyramid) layers should be
generated for the export. Use ADD_OVERVIEW_LAYERS=YES to enable.
• BLOCK_SIZE (ERDAS only) - specifies the block size to use for the export. The default is
BLOCK_SIZE=64.
• COMPRESS_OUTPUT (ERDAS only) - specifies whether or not the exported file should be
compress. The default is COMPRESS_OUTPUT=YES.
• DISABLE_BIGTIFF (GEOTIFF only) - use to disable the automatic creation of BigTIFF-format files
for very large exports. Use DISABLE_BIGTIFF=YES to disable the automatic BigTIFF support.

EXPORT_VECTOR

The EXPORT_VECTOR command exports all currently loaded vector data to a file. The following
parameters are supported by the command.

• FILENAME - full path to file to save the data to

Map GPS Coordinates - GPS Map Coordinates - GPSCoordinates Map 209

 Global Mapper User's Manual

• TYPE - type of vector file we're exporting to

♦ ARC_UNGENERATE - export line and area features to an Arc Ungenerate format file.
♦ ARC_UNGENERATE_POINTS - export point features to an Arc Ungenerate format file.
♦ CDF - export to a Geographix CDF format file.
♦ CSV - export point features to a CSV format file.
♦ DELORME_DRAWING - export features to a DeLorme drawing text file
♦ DELORME_TRACK - export line features to a DeLorme track text file
♦ DELORME_WAYPOINT - export point features to a DeLorme waypoint text file
♦ DGN - export to a DGN v8 file.
♦ DLGO - export to a native format USGS DLG-O file.
♦ DWG - export to an AutoCAD DWG format file.
♦ DXF - export to an AutoCAD DXF format file.
♦ GARMIN_TRK - exports lines to a Garmin TRK (PCX5) format file.
♦ GARMIN_WPT - exports names points to a Garmin WPT (PCX5) format file.
♦ GPX - exports line and point features to a GPX (GPS eXchange Format) file.
♦ KML - export to a KML or KMZ format file.
♦ LANDMARK_GRAPHICS - export to a Landmark Graphics format file.
♦ LIDAR_LAS - export to a Lidar LAS file.
♦ LOWRANCE_USR - export to a Lowrance USR format file.
♦ MAPGEN - export to a MapGen format file.
♦ MAPINFO - export to a MapInfo MIF/MID or TAB/MAP format file.
♦ MATLAB - export to a MatLab format file.
♦ MOSS - export line and area features to a MOSS format file.
♦ NIMA_ASC - export to a NIMA ASC format file.
♦ PLATTE_RIVER - export to a Platte River ASCII Digitizer format file.
♦ POLISH_MP - export to a Polish MP format file.
♦ SEGP1 - export to a SEGP1 format file.
♦ SHAPEFILE - export to an ESRI Shapefile format file.
♦ SIMPLE_ASCII - export to a simple ASCII text file.
♦ SURFER_BLN - export to a Surfer BLN format file.
♦ SVG - export to a Scalable Vector Graphic (SVG) format file.
♦ TSUNAMI_OVR - export to a Tsunami OVR format file.
♦ WASP_MAP - export to a WAsP .map format file (line features only).
♦ ZMAP_XYSEGID - export to a ZMap+ XYSegId format file (area and line features only).
• GLOBAL_BOUNDS - specifies the export bounds in units of the current global projection. There
should be 4 values in a comma-delimited list following the parameter name. The values should be in
order of minimum x, minimum y, maximum x, maximum y.
• GLOBAL_BOUNDS_SIZE - specifies the export bounds in units of the current global projection.
There should be 4 values in a comma-delimited list following the parameter name. The values should
be in order of minimum x, minimum y, width in x, width in y.
• LAT_LON_BOUNDS - specifies the export bounds in latitude/longitude degrees. There should be 4
values in a comma-delimited list following the parameter name. The values should be in order of
westmost longitude, southernmost latitude, easternmost longitude, northernmost latitude.
• LAYER_BOUNDS - specifies that the export should use the bounds of the loaded layer(s) with the
given filename. For example, to export to the bounds of the file "c:\test.tif", you would use
LAYER_BOUNDS="c:\test.tif". Keep in mind that the file must be currently loaded.
• LAYER_BOUNDS_EXPAND - specifies that the operation should expand the used
LAYER_BOUNDS bounding box by some amount. The amount to expand the bounding rectangle by
should be specified in the current global projection. For example, if you have a UTM/meters
projection active and want to expand the bounds retrieved from the LAYER_BOUNDS parameter by
100 meters on the left and right, and 50 meters on the top and bottom, you could use

Map GPS Coordinates - GPS Map Coordinates - GPSCoordinates Map 210

 Global Mapper User's Manual
LAYER_BOUNDS_EXPAND="100.0,50.0". You can also specify a single value to apply to all 4
sides, or supply 4 separate values in the order left,top,right,bottom.
• QUAD_NAME (DLGO only) - specifies the quadrangle name to store in the header of the DLG-O
file. If not quadrangle name is specified, Global Mapper will attempt to automatically determine one
based on the loaded data.
• EXPORT_DWG_LABELS (DWG only) - specifies that object labels will be exported as attributes in
the DWG file. Typically you want to set this to YES, unless you are working with a software package
that cannot handle DWG files with attributes. Leaving out this parameter or setting it to anything but
YES will cause feature labels to be discarded on export.
• EXPORT_DXF_LABELS (DXF only) - specifies that object labels will be exported as attributes in
the DXF file. Typically you want to set this to YES, unless you are working with a software package
that cannot handle DXF files with attributes. Leaving out this parameter or setting it to anything but
YES will cause feature labels to be discarded on export.
• DWG_TEXT_SIZE (DWG only) - specifies the multiplier value to apply to text sizes when exporting
DWG file. Use this to control how large text is in the exported file.
• DXF_TEXT_SIZE (DXF only) - specifies the multiplier value to apply to text sizes when exporting
DXF file. Use this to control how large text is in the exported file.
• SHAPE_TYPE (SHAPEFILE only) - specifies the vector object type (area, line, or point) to export to
the shapefile. The following values are valid:
♦ AREAS - export area features to the Shapefile
♦ LINES - export line features to the Shapefile
♦ POINTS - export point features to the Shapefile
• GEN_PRJ_FILE - specifies that a projection (PRJ) file should be generated in addition to the output
file. Set this to YES to cause the projection file to be generated. Leaving out this parameter or setting
it to anything but YES will cause no PRJ file to be generated.
• GRID_TYPE_CELL_SIZE - specifies that the export should be gridded into multiple tiles with each
tile having the given size in the export projection. The value should be specified as cell width,cell
height. For example, if you are exporting in a metric projection and want to tile the export into cells
that are 10,000 meters wide by 5,000 meters tall, you would use
GRID_TYPE_CELL_SIZE="10000.0,5000.0".
• GRID_TYPE_ROWS_COLS - specifies that the export should be gridded into multiple tiles with a
given number of rows and columns of tiles. The value should be specified as number of rows,number
of columns. For example, if you want to tile the export into a grid of 8 rows each 4 tiles across, you
would use GRID_TYPE_ROWS_COLS="8,4".
• GRID_OVERLAP - specifies how much to overlap tiles when gridding an export into multiple tiles.
This is a percentage value from 0 to 100 and only applies when on of the GRID_TYPE_* parameters
is used. For example, to make your grid tiles overlap by 5% of the grid tile size, use
GRID_OVERLAP="5.0". The default value is 0.0, meaning that the tiles do not overlap.
• GRID_NAMING - specifies how to name tiles when gridding an export into multiple tiles. The value
should be SEQUENTIAL for sequential numeric naming starting at 1, SEPARATE for separate prefix
appending by row and column, or SEPARATE_COLS_FIRST for separate prefix appending by
columns and rows. For the SEPARATE options, use the GRID_NAMING_COLS and
GRID_NAMING_ROWS parameters to specify the details of how to name the rows and columns. If
no GRID_NAMING parameter is supplied, the last selected grid naming options selected in the user
interface will be used.
• GRID_NAMING_COLS - specifies how to name the column portion of grid cell names when using
the GRID_NAMING=SEPARATE or GRID_NAMING=SEPARATE_COLS_FIRST parameter. The
value of this field is a comma-delimited list with the following field values:
♦ Naming type. Can have the following values:
◊ NUM - name using numbers in ascending order
◊ NUM_REVERSE - name using numbers in descending order

Map GPS Coordinates - GPS Map Coordinates - GPSCoordinates Map 211

 Global Mapper User's Manual
◊ ALPHA - name using letters in ascending order
◊ ALPHA_REVERSE - name using letters in descending order
♦ Starting value for numbering or lettering (i.e. '1', or 'A').
♦ Prefix string to use before the numeric or alphabetic value.
♦ Step value for numeric naming (default is '1')
You can leave values blank if they don't apply or you want to use the default. As an example, to do
numeric naming starting at the number 100, increasing by 10 each time with a prefix of DEM, you
would use GRID_NAMING_COLS="NUM,100,DEM,10".
• GRID_NAMING_ROWS - specifies how to name the row portion of grid cell names when using the
GRID_NAMING=SEPARATE parameter. See the documentation for the GRID_NAMING_COLS
parameter above for details on the format.
• GRID_NAMING_PREPEND_ZEROES - specifies whether or not to prepend zeroes to the start of
grid column/row names. Use GRID_NAMING_PREPEND_ZEROES=NO to disable the prepending
of zeroes.
• GRID_NAMING_SEPARATOR - specifies the separator string to use between pieces of a grid name.
The default is an underscore.
• GRID_CREATE_FOLDERS - specifies that a separate folder should be generated for each row (or
column if GRID_NAMING=SEPARATE_COLS_FIRST is specified) of the export rather than
placing every output file in the same folder.
• GEN_3D_FEATURES (DGN and SHAPEFILE only) - specifies that 3D line and point objects should
be created in the exported file. Set this to YES to cause the the 3D features to be generated. Leaving
out this parameter or setting it to anything but YES results in the normal 2D objects. The elevation
stored for each vertex/point will be the first of the following that is available:
♦ The elevation associated with the vertex/point in question.
♦ The elevation associated with the entire area/line/point being exported. For example, the
elevation of a contour line or spot elevation.
♦ The first elevation obtained by searching the loaded elevation layers at the position of the
vertex/point.
A value of 0.0 will be used if no elevation could be obtained via any of the prior methods.
• COORD_DELIM (SIMPLE_ASCII only) - specifies the delimeter between coordinates in coordinate
lines
♦ COMMA - coordinates are separated by commas
♦ SEMICOLON - coordinates are separated by semicolons
♦ SPACE - coordinates are separated by space characters
♦ TAB - coordinates are separated by tab characters
• FEATURE_SEP (SIMPLE_ASCII only) - specifies whether or not to separate vector features with a
blank line
♦ NONE - do not separate vector features
♦ BLANK_LINE - separate vector features with a blank line
♦ Any other text. Use the escape sequence \n to specify that you want to insert a line break. For
example, to separate features with a blank line, then a line with the text "NEW FEATURE",
then another blank line, use FEATURE_SEP="\nNEW FEATURE\n".
• EXPORT_ELEV (SIMPLE_ASCII, CSV, and DXF only) - specifies whether or not a elevation value
should be generated for each vertex. A value of EXPORT_ELEV=YES will cause elevations to be
generated. If the option is not specified, elevation values will be generated.
• EXPORT_ATTRS (DGN and SIMPLE_ASCII only) - specifies whether or not feature attributes
should be written to the text file just before the coordinates. Use EXPORT_ATTRS=YES to enable
export of the feature attributes. If the option is not specified, attributes will be exported. If you don't
want to export style attribute with the feature, use EXPORT_ATTRS=NO_STYLE to get just the
associated attributes and name of the feature in the attribute list.

Map GPS Coordinates - GPS Map Coordinates - GPSCoordinates Map 212

 Global Mapper User's Manual

• COORD_OFFSET (SIMPLE_ASCII only) - specifies the offset to apply to any coordinates written to
the file. This offset will be added to each coordinate written to the file. The offset should be specified
as a comma-delimited list of the X, Y, and Z offsets, such as
COORD_OFFSET=100000.0,200000.0,0.0
• COORD_SCALE (SIMPLE_ASCII only) - specifies the scale factors to apply to any coordinates
written to the file. Each coordinate will be multiplied by these scale factor before being written to the
file. The scale factors should be specified as a comma-delimited list of the X, Y, and Z scale factors,
such as COORD_SCALE=0.1,0.1,1.0
• CDF_MAJOR_CODE (CDF only) - specifies the default major attribute code to use for features when
exporting to a CDF format file (default is 32).
• CDF_MINOR_CODE (CDF only) - specifies the default minor attribute code to use for features when
exporting to a CDF format file (default is 45).
• CDF_USE_DEFAULT_CODE (CDF only) - specifies that the default attribute code pair should be
used for all features written to the CDF file and not just those for which no attribute code pair could
be automatically determined based on the feature classification.
• INC_ELEV_ATTR (MAPINFO only) - specifies whether or not the elevation of a feature should be
added as an attribute to the MapInfo files exported. Use INC_ELEV_ATTR=YES to enable or
INC_ELEV_ATTR=NO to disable. This is enabled by default.
• INC_LAYER_ATTR (SHAPEFILE, MAPINFO, or KML only) - specifies whether or not the layer
(description) of a feature should be added as an attribute to the DBF files exported with the Shapefile
or for KML files whether or not displays labels should be exported for line and area features. Use
INC_LAYER_ATTR=YES to enable or INC_LAYER_ATTR=NO to disable. This is enabled by
default for Shapefile and MapInfo exports and disabled by KML.
• POLYGON_CROP_FILE - specifies the full path and filename of a vector file containing a polygon
feature to which the export should be cropped. If multiple polygons are found in the specified file the
polygon which has the largest intersection with the data to be exported will be used as the crop
polygon (see POLYGON_CROP_USE_ALL and POLYGON_CROP_USE_EACH for exceptions).
Note that line and area features will only be cropped to the bounds of the specified polygon. Point
features from some formats will actually be cropped to the specified polygon boundary.
• POLYGON_CROP_NAME - specifies the name of a polygon shape previously defined using the
DEFINE_SHAPE command to which the export should be cropped. The coordinates in the shape
need to have been provided in whatever projection the export is being done in.
• POLYGON_CROP_USE_ALL - specifies that if a POLYGON_CROP_FILE is specified that
contains multiple polygons, the export will be cropped to all polygons in that file rather than just the
best-fit polygon.
• MAP_NAME (POLISH_MP only) - specifies the map name for the MP file.
• POLYGON_CROP_USE_EACH - specifies that if a POLYGON_CROP_FILE is specified that
contains multiple polygons, the operation will generate a separate export for each polygons in that file
rather than just the best-fit polygon. See the POLYGON_CROP_BBOX_ONLY and
POLYGON_CROP_NAME_ATTR options for naming and other options when using this parameter.
Use POLYGON_CROP_USE_EACH=YES to enable.
• POLYGON_CROP_BBOX_ONLY - specifies that if the POLYGON_CROP_USE_EACH parameter
is specified that each export should just be cropped to the bounding box of each polygon rather than
the actual boundary of the polygon. Use POLYGON_CROP_BBOX_ONLY=YES to enable only
cropping to the bounding box.
• POLYGON_CROP_NAME_ATTR - used to control the filenames generated when cropping to
multiple polygons using the POLYGON_CROP_USE_EACH parameter. This should be the actual
name of the attribute from the polygon features to use for naming, or the special values <Area Display
Label> or <Area Source Filename>. If no value is provided, the exported files will be sequentially
numbered.

Map GPS Coordinates - GPS Map Coordinates - GPSCoordinates Map 213

 Global Mapper User's Manual
• TEMPLATE_FILENAME (POLISH_MP only) - specifies the full path and filename for another MP
file to use for the settings for the new MP file being exported.
• MP_EXPORT_TEMPLATE_FILES (POLISH_MP only) - if a TEMPLATE_FILENAME value is
provided, this controls whether or not the [FILES] section(s) from the template file will be copied to
the new file.
• MP_COPY_ENTIRE_TEMPLATE (POLISH_MP only) - specifies that the entire contents of a
specified template file should be copied to the new file rather than just the header portion of the
template file.
• MP_IMAGE_ID (POLISH_MP only) - specifies the image ID value that should be stored in the
resultant .mp file. If you don't specify this value or you specify a value of 0 a new value that has not
been used before will automatically be generated.
• DGN_UNIT_RESOLUTION (DGN only) - specifies the unit resolution to use in an exported DGN
file. The default is 10000.0.
• DGN_GLOBAL_ORIGIN_LL (DGN only) - specifies whether the global origin of the exported DGN
file should be set to the lower left of the design plane rather than at the center of the design plane. Use
DGN_GLOBAL_ORIGIN_LL=YES to move the global origin to the lower left.
• DGN_REPLACE_DARK_COLORS (DGN only) - specifies whether the color of dark lines should
automatically be replaced with white on export to make them more visible on a dark background. Use
DGN_REPLACE_DARK_COLORS=YES to enable this option.
• OVERWRITE_EXISTING - specifies that existing files should be overwritten. The default is
OVERWRITE_EXISTING=YES, so use OVERWRITE_EXISTING=NO to skip exporting files that
already exist.
• SPLIT_BY_LAYER (SHAPEFILE only) - specifies that the export should generate a separate
Shapefile for each layer/type in the input data
• SPLIT_BY_ATTR - specifies that the export should generate a separate file for each set of attributes
values in the input data. Use the FILENAME_ATTR_LIST and
FILENAME_INCLUDE_ATTR_NAME parameters to control which attributes are compared to and
in what order and how the filename is generated from those attributes and their values. Use
SPLIT_BY_ATTR=YES to split your export so that all features with the same values for each of the
specified attributes is in the same file.
• FILENAME_ATTR_LIST - contains a comma-delimited list of attributes to use when naming files
exported when using the SPLIT_BY_ATTR=YES parameter.
• FILENAME_INCLUDE_ATTR_NAME - specifies that the attribute name specified in the
FILENAME_ATTR_LIST parameter should be included as part of the filename when using
SPLIT_BY_ATTR=YES to split your export into a separate file for each set of attributes.
• KML_AREA_DISPLAY_ABOVE_TERRAIN (KML only) - specifies that area features with
associated elevation value should be displayed at height above the terrain surface in Google Earth.
Use KML_AREA_DISPLAY_ABOVE_TERRAIN=YES to enable.
• KML_AREA_ELEVS_RELATIVE (KML only) - specifies that the elevation values associated with
3D area features are relative to the terrain surface rather than relative to sea level. Use
KML_AREA_ELEVS_RELATIVE=YES to enable.
• KML_AREA_EXTRUDE (KML only) - specifies that 3D area features displayed in Google Earth
should be extruded from the surface to create volumetric objects like buildings. Use
KML_AREA_EXTRUDE=YES to enable.
• KML_AREA_FAKE_HEIGHTS (KML only) - specifies that fake elevation values should be assigned
to area features exported to ensure that the draw order remains correct in Google Earth. This may be
necessary to keep overlapping area features drawing correctly. Use
KML_AREA_FAKE_HEIGHTS=YES to enable.
• KML_AREA_TRANSLUCENCY (KML only) - specifies how see-through filled area features will be
in the generated KML file. The values should range from 1 to 100 and represent a opacity percentage,
with 100 being completely opaque and 1 being almost completely transparent. The default value is

Map GPS Coordinates - GPS Map Coordinates - GPSCoordinates Map 214

 Global Mapper User's Manual
KML_AREA_TRANSLUCENCY=75.
• KML_LINE_DISPLAY_ABOVE_TERRAIN (KML only) - specifies that LINE features with
associated elevation value should be displayed at height above the terrain surface in Google Earth.
Use KML_LINE_DISPLAY_ABOVE_TERRAIN=YES to enable.
• KML_LINE_ELEVS_RELATIVE (KML only) - specifies that the elevation values associated with
3D line features are relative to the terrain surface rather than relative to sea level. Use
KML_LINE_ELEVS_RELATIVE=YES to enable.
• KML_POINT_DISPLAY_ABOVE_TERRAIN (KML only) - specifies that point features with
associated elevation value should be displayed at height above the terrain surface in Google Earth.
Use KML_POINT_DISPLAY_ABOVE_TERRAIN=YES to enable.
• KML_POINT_ELEVS_RELATIVE (KML only) - specifies that the elevation values associated with
3D Point features are relative to the terrain surface rather than relative to sea level. Use
KML_POINT_ELEVS_RELATIVE=YES to enable.
• KML_POINT_EXTRUDE (KML only) - specifies that 3D point features displayed in Google Earth
should be extruded from the surface by drawing a thin line from the surface to the point. Use
KML_POINT_EXTRUDE=YES to enable.
• GEN_MULTI_PATCH (SHAPEFILE only) - specifies that area features exported to a Shapefile
should be stored as multi-patch features rather than areas. Use GEN_MULTI_PATCH=YES to
enable.

GENERATE_CONTOURS

The GENERATE_CONTOURS command allows for the generation of contour lines (isolines of equal
elevation) from any or all currently loaded elevation data. The following parameters are supported by the
command.

• ELEV_UNITS - specify elevation units to use in export

♦ FEET - export in US feet
♦ METERS - export in meters
• INTERVAL - specifies the contour interval to use. This must be a whole number greater than 0. The
units are specified with the ELEV_UNITS parameter described above. If you wanted to generate a
contour file with an interval of 20 feet, you would use INTERVAL=20 ELEV_UNITS=FEET in the
parameter list. If no interval is provided, a default one is guessed based on the elevation range of the
loaded elevation data.
• SPATIAL_RES - specifies spacing of grid points used to determine contour position. A smaller grid
spacing results in higher fidelity, but larger, contours. Typically you'll want to use the default value
which is the minimum spatial resolution of all loaded data. Should be formatted as
x_resolution,y_resolution. The units are the units of the current global projection. For example, if
UTM was the current global projection and you wanted to use a grid with a 30 meter spacing, the
parameter/value pair would look like SPATIAL_RES=30.0,30.0.
• GLOBAL_BOUNDS - specifies the contour bounds in units of the current global projection. There
should be 4 values in a comma-delimited list following the parameter name. The values should be in
order of minimum x, minimum y, maximum x, maximum y.
• GLOBAL_BOUNDS_SIZE - specifies the contour bounds in units of the current global projection.
There should be 4 values in a comma-delimited list following the parameter name. The values should
be in order of minimum x, minimum y, width in x, width in y.
• LAT_LON_BOUNDS - specifies the contour bounds in latitude/longitude degrees. There should be 4
values in a comma-delimited list following the parameter name. The values should be in order of
westmost longitude, southernmost latitude, easternmost longitude, northernmost latitude.

Map GPS Coordinates - GPS Map Coordinates - GPSCoordinates Map 215

 Global Mapper User's Manual
• LAYER_BOUNDS - specifies that the contour generation should use the bounds of the loaded
layer(s) with the given filename. For example, to generate contours to the bounds of the file
"c:\test.tif", you would use LAYER_BOUNDS="c:\test.tif". Keep in mind that the file must be
currently loaded.
• LAYER_BOUNDS_EXPAND - specifies that the operation should expand the used
LAYER_BOUNDS bounding box by some amount. The amount to expand the bounding rectangle by
should be specified in the current global projection. For example, if you have a UTM/meters
projection active and want to expand the bounds retrieved from the LAYER_BOUNDS parameter by
100 meters on the left and right, and 50 meters on the top and bottom, you could use
LAYER_BOUNDS_EXPAND="100.0,50.0". You can also specify a single value to apply to all 4
sides, or supply 4 separate values in the order left,top,right,bottom.
• SIMPLIFICATION - specifies the simplification threshold to use when generating the contours. This
specifies how far off a straight line (in the units of the current projection) that a point has to be before
it is kept. Generally you should not specify a simplification value as the default value of one tenth of
the sample spacing works quite well. This is an option for advanced users only.
• GEN_HEIGHT_AREAS - generate area features colored based on the current elevation shader in
addition to generating contour lines. Use a value of YES to enable the generate of the height areas.
• GEN_SPOT_ELEVATIONS - generate spot elevations at min/max elevations. Use a value of YES to
enable the generate of min/max spot elevation points.
• SINGLE_LEVEL_ONLY - specifies that the INTERVAL value is actually a value indicating the only
height that a contour should be generated at. Use a value of YES to turn this functionality on.
• FILL_GAPS - specifies that small gaps in between and within the data sets being used to generate the
contours will be filled in by interpolating the surrounding data to come up with an elevation for the
point in question. This option is on by default, specify FILL_GAPS=NO to turn off.
• LAYER_DESC - specifies the name to assign to this layer. If no layer description is provided, the
default name of "GENERATED CONTOURS" will be used.
• INC_UNIT_SUFFIX - specifies whether or not a unit suffix (either "m" or "ft") should be appended
to the numeric label of generated features. By default this is enabled, so specify
INC_UNIT_SUFFIX=NO to turn unit suffixes off. This is useful if the data the contours are being
generated over doesn't actually represent elevation.
• SMOOTH_CONTOURS - specifies whether or not generated contour line and area features should
have smoothing applied to improve appearance. This option is enabled by dfault. Use
SMOOTH_CONTOURS=NO to disable smoothing.

GENERATE_ELEV_GRID

The GENERATE_ELEV_GRID command allows for the generation of a gridded elevation layer using loaded
3D vector data. The following parameters are supported by the command.

• ELEV_UNITS - specify elevation units to use for new grid

♦ FEET - US feet
♦ DECIFEET - 10ths of US feet
♦ METERS - meters
♦ DECIMETERS - 10ths of meters
♦ CENTIMETERS - centimeters
• SPATIAL_RES - specifies spacing of grid points to use in generated grid. A smaller grid spacing
results in higher fidelity, but larger, elevation grids. Should be formatted as x_resolution,y_resolution.
The units are the units of the current global projection. For example, if UTM was the current global
projection and you wanted to use a grid with a 30 meter spacing, the parameter/value pair would look

Map GPS Coordinates - GPS Map Coordinates - GPSCoordinates Map 216

 Global Mapper User's Manual
like SPATIAL_RES=30.0,30.0. If you do not provide a SPATIAL_RES value, a good default for the
input data will be chosen, so in most cases it is best just to leave this off.
• GLOBAL_BOUNDS - specifies the grid bounds in units of the current global projection. There
should be 4 values in a comma-delimited list following the parameter name. The values should be in
order of minimum x, minimum y, maximum x, maximum y.
• GLOBAL_BOUNDS_SIZE - specifies the grid bounds in units of the current global projection. There
should be 4 values in a comma-delimited list following the parameter name. The values should be in
order of minimum x, minimum y, width in x, width in y.
• LAT_LON_BOUNDS - specifies the grid bounds in latitude/longitude degrees. There should be 4
values in a comma-delimited list following the parameter name. The values should be in order of
westmost longitude, southernmost latitude, easternmost longitude, northernmost latitude.
• LAYER_BOUNDS - specifies that the grid generation should use the bounds of the loaded layer(s)
with the given filename. For example, to generate contours to the bounds of the file "c:\test.tif", you
would use LAYER_BOUNDS="c:\test.tif". Keep in mind that the file must be currently loaded.
• LAYER_BOUNDS_EXPAND - specifies that the operation should expand the used
LAYER_BOUNDS bounding box by some amount. The amount to expand the bounding rectangle by
should be specified in the current global projection. For example, if you have a UTM/meters
projection active and want to expand the bounds retrieved from the LAYER_BOUNDS parameter by
100 meters on the left and right, and 50 meters on the top and bottom, you could use
LAYER_BOUNDS_EXPAND="100.0,50.0". You can also specify a single value to apply to all 4
sides, or supply 4 separate values in the order left,top,right,bottom.
• LAYER_DESC - specifies the name to assign to this layer. If no layer description is provided, a
default name will be assigned.
• NO_DATA_DIST_MULT - specifies how far from an actual data point a grid cell has to be before it
is treated as a no data value. This number is given as a multiple of the diagonal size of a single grid
cell as nominally determined by the gridding algorithm or specified with the SPATIAL_RES
parameter. A value of 0 (the default) means that all points should be considered as valid.
• GRID_FILL_TO_BOUNDS - specifies that the grid values should be filled out to the entire bounds of
the gridded data rather than just to the convex hull of the data being gridded. Use
GRID_FILL_TO_BOUNDS=YES to enable this.
• GRID_FLATTEN_AREAS - specifies that area features with elevation values should be flattened to
the elevation of the area features. Use GRID_FLATTEN_AREAS=NO to disable this.
• GRID_HEIGHTS_RELATIVE - specifies that the elevation values for the input vector features
should be treated as relative to any loaded terrain data rather than as absolute elevation values. This
useful for things like trees or buildings where you have a height above the ground rather than an
absolute height. Use GRID_HEIGHTS_RELATIVE=YES to enable this.
• GRID_SAVE_TIN - specifies that the triangulated irregular network (TIN) for the grid operation
should be saved as a new separate vector layer consisting of triangular 3D area features. Use
GRID_SAVE_TIN=YES to enable this.
• GRID_USE_CONSTRAINTS - specifies that 3D line and area features should be treated as
constraints (breaklines) during the gridding process. Use GRID_USE_CONSTRAINTS to enable this.
• GRID_IGNORE_ZERO - specifies that features with an elevation of 0.0 will not be used during the
gridding process.

GENERATE_LAYER_BOUNDS

The GENERATE_LAYER_BOUNDS command create a new layer with a single bounding box area created
from the bounding box of each loaded layer.

Map GPS Coordinates - GPS Map Coordinates - GPSCoordinates Map 217

 Global Mapper User's Manual
• LAYER_DESC - specifies the description to use the for created layer

GENERATE_PATH_PROFILE

The GENERATE_PATH_PROFILE command allows for the saving of a 3D path profile to an ASCII XYZ
file. This command uses loaded elevation data to generate a list of the 3D coordinates between two given
points in the given elevation units. The following parameters are supported by the command.

• FILENAME - full path to XYZ ASCII file to save the data to

• ELEV_UNITS - specify elevation units to use in export
♦ FEET - export in US feet
♦ METERS - export in meters
• POINT_COUNT - specifies the number of points to generate in the path. This must be at least two.
For example, to create 1000 points, use POINT_COUNT=1000. You can use the POINT_SPACING
parameter rather than this to specify how far apart sample points should be.
• POINT_SPACING - specifies the point spacing in meters to use between sample points along the
path. For example, to create points spaced 10 meters apart, use POINT_SPACING=10.0.
• START_POS - specifies the start position for the path profile. The coordinates must be given in the
current global coordinate system. For example, if UTM if the current projection, you might specify
and easting/northing as follows: START_POS=480000,4310000.
• END_POS - specifies the end position for the path profile. The coordinates must be given in the
current global coordinate system. For example, if UTM if the current projection, you might specify
and easting/northing as follows: START_POS=480000,4310000.
• ADD_LAND_USE_CODES - specifies whether to query loaded LULC data sets for the land use code
at each point and to include that land use code after the elevation. Use
ADD_LAND_USE_CODES=YES to turn on adding land use codes for each point.
• APPEND_TO_FILE - specifies that the elevations between the start and end locations should be
appended to the file specified if it already exists rather than a new file being created
• SAVE_DIST_Z_FILE - specifies that the output file should contain distance and elevation values
rather than XYZ coordinate values. Use SAVE_DIST_Z_FILE=YES to enable this option.

GLOBAL_MAPPER_SCRIPT

The GLOBAL_MAPPER_SCRIPT must be the first command in the file. The only parameter supported is the
VERSION parameter. Typically, the entire command line will look like:

GLOBAL_MAPPER_SCRIPT VERSION=1.00

You can use the following parameters with this command:

• VERSION - specifies the version of the scripting language used. This parameter is required. You
should always use VERSION=1.00.
• ENABLE_PROGRESS - specifies whether or not any progress dialogs should be displayed while this
script is processing. This is enabled by default. Use ENABLE_PROGRESS=NO to disable the
display of any progress dialogs during the processing of this script.
• REQUIRE_WORKSPACE - name of workspace file that is required to be loaded for this script to
run. If a name is provided for this parameter and that workspace is not currently loaded into Global
Mapper, the script will immediately abort. This can be used if you have different scripts that you only

Map GPS Coordinates - GPS Map Coordinates - GPSCoordinates Map 218

 Global Mapper User's Manual

want to use if other workspaces are active and want to prevent accidentally selecting the wrong script.

GENERATE_REPORT

The GENERATE_REPORT command allows you to generate a CSV text report file on the data in one or
more loaded layers broken down by a particular attribute value, feature name, or type, or just a single line
report about all features. The report will include the count of area, line, and point features matching the
specified criteria as well as the total combined length of the line features and combined covered area of the
area features.

The following parameters are supported by the command:

• OUTPUT_FILENAME - specifies the name of the text .csv file to write the report results to.
• FILENAME - filename of the layer to generate the report for. If an empty value is passed in, all layers
that were created by the script, such as those from a GENERATE_CONTOURS command, will be
used to generate the report. You can also pass in the value 'USER CREATED FEATURES' when
running a script in the context of the main map view or loading a workspace to have the 'User Created
Features' layer be used. If no FILENAME parameter is provided, the report will cover all available
vector layers.
• REPORT_ATTR - specifies what to use to divide up the report into categories. This can be an
attribute name, or if you would like to compare against a feature label rather than an attribute, use
<Feature Name>. To compare against a feature type name rather than an attribute, use <Feature
Type> for your attribute name. To compare against the feature description, use <Feature Desc> for
your attribute name. If no REPORT_ATTR parameter is provided or the value is empty, only a single
line concerning all matching features will be generated in the report.
• COMPARE_STR - specifies a comparison operation to perform to see if a feature is one that needs to
be included in the report. The format is attr_name=attr_value. For example if you have an attribute
named CFCC and you want to match when the value of that attribute starts with an 'A', you can use
COMPARE_STR="CFCC=A*" as your parameter. You can add multiple COMPARE_STR
parameters to a single command to combine multiple criteria for your search. If you would like to
compare against a feature label rather than an attribute, use <Feature Name> for your attribute name.
To compare against a feature type name rather than an attribute, use <Feature Type> for your attribute
name. To compare against the feature description, use <Feature Desc> for your attribute name.
• CASE_SENSITIVE - specifies whether or not text comparisons are case sensitive or not. Use
CASE_SENSITIVE=YES to enable, by default comparisons are not case sensitive.

IMPORT

The IMPORT command imports a data file for later use. The following parameters are supported by the
command.

• FILENAME - full path to file to load the data from. This can also be the URL for a file on a web site
that you want Global Mapper to download and load.
• TYPE - type of data file we're loading
♦ AUTO - automatically determine the type (default).
♦ ACE - Altimetry Corrected Elevation (ACE) format file.
♦ ARCASCIIGRID - Arc ASCII Grid format file.
♦ ARCBINARYGRID - Arc Binary Grid format file.

Map GPS Coordinates - GPS Map Coordinates - GPSCoordinates Map 219

 Global Mapper User's Manual
♦ AVC - Arc Vector Coverage format file.
♦ BIL - BIL format file.
♦ BSB - BSB format file (usually has .KAP extension).
♦ BT - a BT (Binary Terrain) format grid file.
♦ CANADA3D - Canada 3D format file.
♦ COMPEGPS - a CompeGPS RTE, TRK, or WPT file.
♦ CTM_DEM - a CTM DEM format file.
♦ DBF - DBase file with point features.
♦ DHM25 - a Swiss DHM terrain format file.
♦ DLGO - USGS DLG-O
♦ DGN - MicroStation DGN files earlier than v8.
♦ DIVAGIS_GRID - a DIVA GIS grid format file.
♦ DMDF - a Digital Map Data Format (DMDF) format file.
♦ DOQQ - USGS DOQ in JPEG format.
♦ DTED - Digital Terrain Elevation Data (DTED) format.
♦ DXF - DXF format.
♦ ECW - ER Mapper Compressed Wavelet (ECW) format file.
♦ EMF - a Windows Enhanced Metafile (EMF) format file.
♦ ENVI DEM - ENVI DEM format file.
♦ ERDAS - Erdas Imagine format file.
♦ ERDAS_GIS - Erdas GIS format file.
♦ ERM_GRID - ERM grid format file.
♦ ESRI_PGEO - ESRI personal geodatabase format file.
♦ ETOPO2 - ETOPO2 format file.
♦ FAST_L7A - a Landsat FAST L7A format file.
♦ FLOATGRID - FLOAT/GRID format file.
♦ GEOSOFT_GRID - a Geosoft Binary Grid format file.
♦ GEOTIFF - GeoTIFF format file.
♦ GIF - a GIF format file with associated world file.
♦ GLOBAL_MAPPER_CATALOG - a Global Mapper Map Catalog file.
♦ GLOBAL_MAPPER_GRID - a Global Mapper Grid format file.
♦ GML - a GML format file.
♦ GNIS - Geographics Names Information Service (GNIS) file
♦ GPS_TRACKMAKER - a GPS TrackMaker format file.
♦ GXF - Geosoft Grid ASCII (GXF) file
♦ GPX - GPS eXchange Format file
♦ HDF - an HDF format raster or grid file, like ASTER DEM or ASTER VNIR imagery.
♦ HELAVA_DEM - a Helava DEM file
♦ HYPACK_MATRIX - a Hypack Matrix format file.
♦ IBCAO - Arctic bathymetry in NetCDF format.
♦ IDRISI_RASTER - Idrisi raster/elevation format file.
♦ INTERGRAPH_COT - Intergraph COT format file.
♦ JDEM - a Japanese DEM .mem file.
♦ JPEG - a JPEG file with an associated world file.
♦ JPEG2000 - a JPEG 2000 file
♦ LIDAR_LAS - a LAS file with LIDAR data.
♦ LOWRANCE_USR - a Lowrance USR format file.
♦ LULC - USGS Land Use and Land Cover vector data file.
♦ MAPINFO - a MapInfo MIF/MID of TAB/MAP vector data collection.
♦ MAPMAKERTERRAIN - a MapMaker terrain file
♦ MARPLOT_MIE - a MarPlot MIE format file.

Map GPS Coordinates - GPS Map Coordinates - GPSCoordinates Map 220

 Global Mapper User's Manual
♦ MAPTECH - a MapTech BSB, Topo, or Aerial format file.
♦ MICRODEM_DEM - a MicroDEM-created DEM file
♦ MICROPATH_DEM - a Micropath DEM file
♦ MRSID - a LizardTech MrSID image file.
♦ NetCDF - a NetCDF format file.
♦ NIMA_GNS - a NIMA GNS format file.
♦ NITF - NITF format imagery
♦ NOS_GEO - a NOS/GEO format chart file.
♦ NTF_GRID - a NTF grid format file.
♦ OPTIMI_GRID - an Optimi terrain or clutter grid format file.
♦ OZI - an OziExplorer format waypoint (WPT) or track (PLT) file.
♦ PCX - a PC Paintbrush PCX format file.
♦ PCX5 - a Garmin PCX5 format waypoint (WPT) or track (TRK) file.
♦ ROCKWORKS_GRID - a RockWorks Grid format file.
♦ RPF - Raster Product Format database, like CADRG.
♦ RPF_FRAME - single frame from a Raster Product Format database, like CADRG.
♦ S57 - a S-57 chart file
♦ SDTS - a SDTS transfer
♦ SEGP1 - a SEGP1 seismic shotpoint file.
♦ SHAPEFILE - an ESRI Shapefile.
♦ SURFERGRID - a Surfer grid format file.
♦ SWEDISHDEMGRID - a Swedish DEM grid format file.
♦ TERRASCAN - a TerraScan LIDAR format file.
♦ TIGER_LINE - a Tiger/Line format file.
♦ USGS_DEM - a native format USGS DEM file.
♦ VPF - a Vector Product Format file such as VMAP or DNC data
♦ VULCAN_3D - a Vulcan3D triangulation file
♦ ZMAP_PLUS - a Geographix Zmap Plus+ format file.
• PROMPT_IF_TYPE_UNKNOWN - set to NO if you don't want the user to be prompted to select a
file type if the type cannot automatically be determined (useful when looping).
• HIDDEN - set to YES to cause this overlay to be hidden from view after it is loaded. The default is to
show the overlay.
• SAMPLING_METHOD (elevation and raster only) - specifies the sampling method to use when
resampling this layer. The following values are supported:
♦ NEAREST_NEIGHBOR - use the nearest neighbor sampling method
♦ BILINEAR - use bilinear interpolation
♦ BICUBIC - use bicubic interpolation
♦ BOX_3X3 - use a 3x3 box average
♦ BOX_4X4 - use a 4x4 box average
♦ BOX_5X5 - use a 5x5 box average
• ANTI_ALIAS [DEPRECATED - use SAMPLING_METHOD instead] (elevation and raster only) -
specifies whether to remove jagged edges by making a subtle transition between pixels. Turning off
this option helps maintain the hard edges of the pixels as they are rasterized. Use ANTI_ALIAS=YES
to turn on. Anything else turns it off.
• CONTRAST_MODE (raster only) - specifies the type of contrast adjustment to apply to the data.
♦ NONE - no contrast adjustment applied (this is the default)
♦ PERCENTAGE - apply a percentage contrast adjustment. The
CONTRAST_STRETCH_SIZE parameter can be used to override the number of standard
deviations from the mean to stretch to.
♦ MIN_MAX - apply a min/max contrast stretch, stretching the available range of values in
each color band to the full range of 0-255. For imagery which contains both black and white,

Map GPS Coordinates - GPS Map Coordinates - GPSCoordinates Map 221

 Global Mapper User's Manual
this will have no affect.
• CONTRAST_SHARED (raster only) - specified whether or not the contrast adjustment for this layer
will share the adjustment with other contrast-adjusted layers in order to ensure a consistent
modification across layers. Use CONTRAST_SHARED=YES to enable contrast sharing.
• CONTRAST_STRETCH_SIZE (raster only) - specifies the number of standard deviations from the
mean to use in a PERCENTAGE contrast adjustment. The default is 2.0.
• AUTO_CONTRAST (raster only) - DEPRECATED, use CONTRAST_MODE instead - specifies
whether to automatically calculate and apply a 2 standard deviation contrast adjustment to the image.
Use AUTO_CONTRAST=YES to turn on. Anything else turns it off.
• CLIP_COLLAR (raster only) - specifies whether to clip the collar off of the image. The following
values are supported for cropping:
♦ NONE - no collar cropping is performed.
♦ AUTO - automatically remove a USGS DRG-style collar or a 3.75 DOQQ collar
♦ LAT_LON - crop the collar to a a specified set of bounds specified in arc degrees in the
native datum of the layer. The bounds should be specified using the
CLIP_COLLAR_BOUNDS parameter.
♦ NATIVE - crop the collar to a specified set of bounds specified in the native projection
system and datum of the layer. The bounds should be specified using the
CLIP_COLLAR_BOUNDS parameter.
♦ PIXELS - crop a given number of pixels off of each side of the layer. The number of pixels to
remove from each side should be specified using the CLIP_COLLAR_BOUNDS parameter.
♦ SNAP_DEGREES - crop the collar by snapping each edge to a specified degree boundary
specified in arc degrees in the native datum of the layer. The bounds should be specified
using the CLIP_COLLAR_BOUNDS parameter. For example to crop the west and east edges
to a half degree boundary and the north and south edges to a one degree boundary, use the
following: CLIP_COLLAR_BOUNDS=0.5,0.25,0.5,0.25.
♦ POLY - crop to a polygon provided with the CLIP_COLLAR_POLY parameter.
• CLIP_COLLAR_BOUNDS (raster only) - specifies the bounds of the collar to be clipped off when
the CLIP_COLLAR parameter is enabled. The coordinates should be specified in arc degrees, native
layer coordinates, or pixel counts as a comma-delimited list going west,south,east,north. For example,
CLIP_COLLAR_BOUNDS=34.25,-109.0,34.375,-108.875.
• CLIP_COLLAR_POLY (raster only) - specifies the name of the previously defined shape (with the
DEFINE_SHAPE command) to crop the layer to when the CLIP_COLLAR=POLY parameter is
used. The coordinates in the shape must have been defined in the native projection system of the layer
being loaded.
• ZOOM_DISPLAY - specifies when the map should be displayed and when it should be hidden based
on the display zoom scale. This command will be formatted as a name from the list, below followed
by 2 numeric paramters. For example, use ZOOM_DISPLAY="SCALE,25000,0" to have a map
display only when zoomed in below 1:25000 scale.
♦ ALWAYS - always display the map. The numeric parameters are ignored.
♦ PERCENT - display the map when the map bounding box is a certain percentage of the
screen size. For example, use ZOOM_DISPLAY="PERCENT,10,0" to display the map when
its bounding box is at least 10% of the screen size.
♦ SCALE - display the map when the current display is at or below a certain scale. For
example, use ZOOM_DISPLAY="SCALE,25000,0" to display the map when the current
draw scale is at or below 1:25000.
♦ SCALE_RANGE - display the map when the current display is below a range of scale value.
For example, use ZOOM_DISPLAY="SCALE_RANGE,25000,100000" to display the map
when the current draw scale is between 1:25000 and 1:100000.
• COLOR_INTENSITY (elevation and raster only) - specifies the color intensity to use when adjusting
the brightness of pixels in the overlay. Valid values range from 0 to 20, with 0 being completely

Map GPS Coordinates - GPS Map Coordinates - GPSCoordinates Map 222

 Global Mapper User's Manual
black, 10 being no alteration, and 20 being completely white. For example, to make an image slightly
darker, you could use COLOR_INTENSITY=7. (NOTE: This parameter has been deprecated in favor
of the COLOR_INTENSITY_FULL parameter).
• COLOR_INTENSITY_FULL (elevation and raster only) - specifies the color intensity to use when
adjusting the brightness of pixels in the overlay. Valid values range from 0 to 512, with 0 being
completely white, 256 being no alteration, and 512 being completely black. For example, to make an
image slightly darker, you could use COLOR_INTENSITY=300. (NOTE: This parameter replaces
the COLOR_INTENSITY parameter).
• TEXTURE_MAP (raster only) - specifies that this image should be draped over any elevation data
loaded before it. Use TEXTURE_MAP=YES to turn on. Anything else turns it off.
• TRANSPARENT_COLOR (elevation and raster only) - specifies the color to make transparent when
rendering this overlay. The color should be specified as RGB(<red>,<green>,<blue>). For example,
to make white the transparent color, use TRANSPARENT_COLOR=RGB(255,255,255). If you do
not wish any color to be transparent, do not use this parameter. Optionally, if the image that you are
making transparent uses a palette for the colors, you can specify a palette index in the following
format: INDEX(<0-based palette index>). For example, to make the second color in the palette
transparent, use TRANSPARENT_COLOR=INDEX(1).
• COLOR_GRADE (raster only) - specifies the color grading values to use for this layer (as configured
on the Color Grade options dialog tab). This should be a comma-delimited list with the saturation
value (from 0-1) first, then the input and output range for the red, green, and blue color channels, as
follows:
COLOR_GRADE=saturation,red_in_start,red_in_end,red_out_start,red_out_end,...,blue_out_end
• PROJ_NAME - specifies the name of the projection to use for this file (this will override any
projection information stored in the file). This name must have been defined with a prior
DEFINE_PROJ command.
• PROJ_FILENAME - specifies the name of the projection (.prj) file to use for this file (this will
override any projection information stored in the file).
• PROJ_EPSG_CODE - specifies the numeric EPSG projection code that defines the projection for this
file (this will override any projection information stored in the file). For example, use
PROJ_EPSG_CODE=26715 to define a UTM zone 15 projection with NAD27 as the datum and
meters as the units.
• PROMPT_IF_PROJ_UNKNOWN - set to NO if you don't want the user to be prompted to select a
projection if the projection of the file cannot be automatically determined.
• ELEV_UNITS (elevation only) - specify elevation units to use for this file if it contains gridded
elevation data
♦ FEET - export in US feet
♦ DECIFEET - export in 10ths of US feet
♦ METERS - export in meters
♦ DECIMETERS - export in 10ths of meters
♦ CENTIMETERS - export in centimeters
• ELEV_OFFSET (elevation only) - specifies the offset in meters to apply to each elevation value in the
layer. This allows you to vertically shift a layer to match other layers.
• ELEV_SCALE (elevation only) - specifies the scale value to apply to each elevation value in the
layer. This allows you to vertically scale a layer to match other layers. Default to 1.0 (no scaling).
• MIN_ELEV (elevation only) - specifies the minimum elevation (meters) to treat as valid when
rendering this layer. Any elevations below this value will be treated as invalid and not be drawn or
exported.
• MAX_ELEV (elevation only) - specifies the maximum elevation (meters) to treat as valid when
rendering this layer. Any elevations above this value will be treated as invalid and not be drawn or
exported.

Map GPS Coordinates - GPS Map Coordinates - GPSCoordinates Map 223

 Global Mapper User's Manual

• CLAMP_ELEVS (elevation only) - if a MIN_ELEV and/or MAX_ELEV value is specified, setting

this to YES will make any valid elevation values outside of the specified range be clamped to the new
range value rather than treated as invalid.
• VOID_ELEV (elevation only) - specifies the elevation (meters) to replace any void areas in the layer
with. If not specified, the void areas will be transparent.
• SHADER_NAME (elevation only) - this sets the name of the shader to use when rendering the
gridded elevation data for this layer. Use this to override use of the shared default shader just for this
layer. This must be one of the names displayed in the shader drop down in Global Mapper, such as
"Atlas Shader" or "Global Shader" or the name of a custom shader.
• TRANSLUCENCY (elevation and raster only) - specifies the level of translucency (i.e. how
"see-through" the layer is). Value values range from 0 to 512, with 0 meaning the layer is completely
transparent (i.e. invisible) and 512 meaning the layer is completely opaque (this is the default).
• IGNORE_ALPHA (raster only) - specifies that an embedded alpha channel in an image should be
ignored. This is useful for images that have incorrect alpha channels. Use IGNORE_ALPHA=YES to
enable.
• BLEND_MODE (elevation and raster only)- specify blend mode to use for combining this overlay
and any previously loaded overlays
♦ NO_BLEND - no blending is done, this is the default
♦ MULTIPLE
♦ SCREEN
♦ OVERLAY
♦ HARD_LIGHT
♦ COLOR_BURN
♦ COLOR_DODGE
♦ DARKEN
♦ LIGHTEN
♦ DIFFERENCE
♦ EXCLUSION
♦ APPLY_COLOR
♦ APPLY_COLOR_REVERSE
♦ KEEP_RED
♦ KEEP_GREEN
♦ KEEP_BLUE
• FEATHER_BLEND_EDGES (raster only) - specifies that the layer should be feature-blended around
one or more ledges. This is a numeric bitfield value. Add the following values to enable blending on
that edge:
♦ 1 - blend top edge
♦ 2 - blend bottom edge
♦ 4 - blend left edge
♦ 8 - blend right edge
For example, to blend all edges, use FEATHER_BLEND_EDGES=15. The
FEATHER_BLEND_SIZE parameter is used to specify how many pixels to blend on each blended
edge.
• FEATHER_BLEND_SIZE (raster only) - specifies the size in pixels to use for a blend boundary.
• FEATHER_BLEND_POLY_FILE (raster only) - specifies that the polygon boundary to feather blend
this layer against should come from the specified file.
• BAND_SETUP (raster only) - specifies what bands of data from the raster file being loaded should be
used to populate the red, green, and blue color channels when displaying the image. This is useful for
multi-spectral imagery which may have more than 3 color bands. The default band setup will be to
use the first three bands as follows: BAND_SETUP="0,1,2". Note that not all raster formats support
specifying a non-default band setup.

Map GPS Coordinates - GPS Map Coordinates - GPSCoordinates Map 224

 Global Mapper User's Manual

• LABEL_FIELD - specifies the name of the attribute field to use as the label attribute for the features
in the file.
• LABEL_PREFIX - specifies the prefix to prepend to attribute-based labels
• LABEL_SUFFIX - specifies the suffix to append to attribute-based labels
• ELEV_FIELD - specifies the name of the attribute field to use as the elevation value for the features
in the file.
• AREA_TYPE - specifies the name of the Global Mapper type to use for area features imported from
the file.
• LINE_TYPE - specifies the name of the Global Mapper type to use for line features imported from
the file.
• POINT_TYPE - specifies the name of the Global Mapper type to use for point features imported from
the file.
• LAYER_DESC - specifies a description to use for the layer when displaying it in the Overlay Control
Center. This overrides the default description based on the filename or other information within the
file.
• GCP - specifies a single ground control point for use in rectifying a file. The GCP record consists of 5
comma-delimited fields, the control point name, the pixel X and Y coordinates, and the corresponding
ground X and Y coordinates. A separate GCP parameter and value should be used for each control
point used in the rectification. As an alternative, the GCP_FILENAME parameter (see below) can be
used instead.
• GCP_FILENAME - specifies the name of a control point file used to rectify the file being imported.
• GCP_PROJ_NAME - specifies the name of the projection that the ground control points are provided
in. This name must have been defined with a prior DEFINE_PROJ command. Use this if you want to
specify control points in a projection other than what you want to define as the native projection for
the file. Note that you must also explicitly specify the name projection of the file using either the
PROJ_NAME, PROJ_EPSG_CODE or PROJ_FILENAME parameters.
• GCP_PROJ_FILENAME - specifies the name of the projection (.prj) file that contains the projection
definition for the projection that the ground control points are provided in. Use this if you want to
specify control points in a projection other than what you want to define as the native projection for
the file. Note that you must also explicitly specify the name projection of the file using either the
PROJ_NAME, PROJ_EPSG_CODE or PROJ_FILENAME parameters.
• GCP_PROJ_EPSG_CODE - specifies the EPSG code of the projection that the ground control points
are provided in. Use this if you want to specify control points in a projection other than what you want
to define as the native projection for the file. Note that you must also explicitly specify the name
projection of the file using either the PROJ_NAME, PROJ_EPSG_CODE or PROJ_FILENAME
parameters.
• RECTIFY - specifies the rectification method to use for rectifying this file. Valid value are LINEAR,
HELMERT, AFFINE, POLYNOMIAL, and TRIANGULATION. If you do not specify a rectification
type but do provide at least two ground control points, best rectification method will automatically be
chosen based on the number of control points specified.

• ALLOW_SELECTION - set to NO to disable selection of features from this layer using either the Feature
Info or Digitizer Tools.

IMPORT_ARCHIVE

The IMPORT_ARCHIVE command imports a data file from a .tar.gz archive for later use. The only time
you should ever need to use the IMPORT_ARCHIVE command is when you only want to load some of the
data inside a .tar.gz archive. For the typical case of just loading everything in an archive, use the IMPORT

Map GPS Coordinates - GPS Map Coordinates - GPSCoordinates Map 225

 Global Mapper User's Manual

command with AUTO as the value for the TYPE parameter. The following parameters are supported by the
command.

• ARCHIVE_FILENAME - full path to the archive file to load the data from
• FILENAME - filename to load from the archive
• NOTE: All other parameters that are supported by the IMPORT command are also supported by
this command.

IMPORT_ASCII

The IMPORT_ASCII command imports data from a generic ASCII text file for later use. The following
parameters are supported by the command.

• FILENAME - full path to file to load the data from

• TYPE - type of import that we're doing
♦ POINT_ONLY - all lines with coordinate data will result in a new point object begin
created
♦ POINT_AND_LINE - both point and line features will be created from coordinate data in
the file. Line features will be created when coordinate data lines are back to back in the
file. All individual coordinate lines will result in a point object being created
♦ ELEVATION - all lines in the file with 3 coordinate values (x,y, and elevation) will be
used to create an elevation grid. The data will be triangulated and gridded automatically,
resulting in a fully usable elevation grid that can be exported to any of the supported
elevation data formats.
• COORD_DELIM - specifies the delimeter between coordinates in coordinate lines
♦ AUTO - automatically detect the delimeter type (default)
♦ WHITESPACE - coordinates are separated with one or more space and/or tab characters
♦ COMMA - coordinates are separated by commas
♦ SEMICOLON - coordinates are separated by semicolons
♦ TAB - coordinates are separated by tabs
• COORD_ORDER specifies the order of the coordinates in coordinate lines
♦ X_FIRST - x coordinates (i.e. easting or longitude) come first, followed by y coordinates
(i.e. northing or latitude) (default)
♦ Y_FIRST - y coordinates (i.e. northing or latitude) come first, followed by x coordinates
(i.e. easting or longitude)
• COORD_PREFIX - if present, this line is used to specify what special character sequence
coordinate lines start with. For example, if the coordinate lines in the file started with the character
sequence "XY,", you should use COORD_PREF="XY,". By default no coordinate prefix is
assumed.
• INC_COORD_LINE_ATTRS - set the value of this parameter to YES if you wish to use any
leftover text at the end of coordinate lines as attributes for the feature the coordinates are in. This
could be useful if elevation data is present at the end of the lines. By default, the value of this
attribute is NO.
• INC_ELEV_COORDS - this parameter controls whether or not the value right after the 2nd
coordinate column (if there is one) will be treated as an elevation value. Use
INC_ELEV_COORDS=YES or INC_ELEV_COORDS=NO to enable (the default) or disable this
behavior.
• COL_HEADERS - controls whether or not the first line of the file should be used as column
headers for coordinate line attributes later in the file. Setting this to yes is useful for things like

Map GPS Coordinates - GPS Map Coordinates - GPSCoordinates Map 226

 Global Mapper User's Manual

CSV files with column headers in the first row, otherwise set it to NO (the default).
• PROJ_NAME - specifies the name of the projection to use for this file (this will override any
projection information stored in the file). This name must have been defined with a prior
DEFINE_PROJ command.
• PROJ_FILENAME - specifies the name of the projection (.prj) file to use for this file (this will
override any projection information stored in the file).
• PROJ_EPSG_CODE - specifies the numeric EPSG projection code that defines the projection for
this file (this will override any projection information stored in the file). For example, use
PROJ_EPSG_CODE=26715 to define a UTM zone 15 projection with NAD27 as the datum and
meters as the units.
• PROMPT_IF_PROJ_UNKNOWN - set to NO if you don't want the user to be prompted to select a
projection if the projection of the file cannot be automatically determined.
• ELEV_UNITS - specify elevation units to use for this file if it contains gridded elevation data
♦ FEET - export in US feet
♦ DECIFEET - export in 10ths of US feet
♦ METERS - export in meters
♦ DECIMETERS - export in 10ths of meters
♦ CENTIMETERS - export in centimeters
• SKIP_COLUMNS - specifies the number of columns (fields) to skip at the start of a coordinate line
before trying to read the coordinates. For example, if the X and Y coordinates of a line were in the
3rd and 4th columns of the coordinate line, you'd use a value of SKIP_COLUMNS=2. The default
value is 0, meaning that coordinates must be in the first two columns.
• SKIP_ROWS - specifies the number of rows to skip at the start of a file before trying to read any
data. For example, if your file has a fixed header of 20 lines, you would use SKIP_ROWS=20 to
skip those header rows.
• COORD_OFFSET - specifies the offset to apply to any coordinates read in from the file. This
offset will be added to each coordinate read in from the file. The offset should be specified as a
comma-delimited list of the X, Y, and Z offsets, such as
COORD_OFFSET=100000.0,200000.0,0.0
• COORD_SCALE - specifies the scale factor to apply to any coordinates read in from the file. Each
coordinate will be multiplied by these scale factor after being read in from the file. The scale
factors should be specified as a comma-delimited list of the X, Y, and Z scale factors, such as
COORD_SCALE=0.1,0.1,1.0
• NO_DATA_DIST_MULT - specifies how far from an actual data point a grid cell has to be before
it is treated as a no data value. This number is given as a multiple of the diagonal size of a single
grid cell as nominally determined by the gridding algorithm or specified with the SPATIAL_RES
parameter. A value of 0 means that all points should be considered as valid.
• SPATIAL_RES - specifies spatial resolution to use when generating an elevation grid from the
data. Defaults to a good value for maintaining the full spatial resolution of the provided point data
if not specified. Should be formatted as x_resolution,y_resolution. The units are the units of the
projection specified for the file. For example, if UTM with meter units was the file projection and
you wanted to export at 30 meter spacing, the parameter/value pair would look like
SPATIAL_RES=30.0,30.0.
• LABEL_FIELD - specifies the name of the attribute field to use as the label attribute for the
features in the file.
• AREA_TYPE - specifies the name of the Global Mapper type to use for area features imported
from the file.
• LINE_TYPE - specifies the name of the Global Mapper type to use for line features imported from
the file.
• POINT_TYPE - specifies the name of the Global Mapper type to use for point features imported
from the file.

Map GPS Coordinates - GPS Map Coordinates - GPSCoordinates Map 227

 Global Mapper User's Manual

• HIDDEN - set to YES to cause this overlay to be hidden from view after it is loaded. The default is
to show the overlay.

SAMPLE:

IMPORT_ASCII FILENAME="C:\data\ASCII Files\usvi_landmark.asc" TYPE=POINT_AND_LINE COORD_DELIM

IMPORT_DIR_TREE

The IMPORT_DIR_TREE command imports all of the data files in a given directory tree that match a list
of filename masks. The following parameters are supported by the command. In addition, all of the display
option parameters for the IMPORT command are also supported for this command.

• DIRECTORY - full path to root of directory tree to import files from.

• FILENAME_MASKS - space-separated list of filename masks to import. If no value is provided
then all files which are of recognized types will be imported.

SAMPLE:

IMPORT_DIR_TREE DIRECTORY="C:\TEMP\EXPORT TEST" FILENAME_MASKS="*.OPT *.GMP"

IMPORT_TERRASERVER

The IMPORT_TERRASERVER command imports a chunk of TerraServer data, such as satellite imagery
or topographic maps. The following parameters are supported by the command:

• THEME_NAME - name of the TerraServer theme to import, such as DOQ or DRG

• LAT_LON_BOUNDS - specifies the bounds to import in latitude/longitude degrees. There should
be 4 values in a comma-delimited list following the parameter name. The values should be in order
of westmost longitude, southernmost latitude, easternmost longitude, northernmost latitude.
• LAYER_BOUNDS - specifies that the import should use the bounds of the loaded layer(s) with the
given filename. For example, to import to the bounds of the file "c:\test.tif", you would use
LAYER_BOUNDS="c:\test.tif". Keep in mind that the file must be currently loaded.
• LAYER_BOUNDS_EXPAND - specifies that the operation should expand the used
LAYER_BOUNDS bounding box by some amount. The amount to expand the bounding rectangle
by should be specified in the current global projection. For example, if you have a UTM/meters
projection active and want to expand the bounds retrieved from the LAYER_BOUNDS parameter
by 100 meters on the left and right, and 50 meters on the top and bottom, you could use
LAYER_BOUNDS_EXPAND="100.0,50.0". You can also specify a single value to apply to all 4
sides, or supply 4 separate values in the order left,top,right,bottom.
• ANTI_ALIAS - specifies whether to remove jagged edges by making a subtle transition between
pixels. Turning off this option helps maintain the hard edges of the pixels as they are rasterized.
Use ANTI_ALIAS=YES to turn on. Anything else turns it off.
• CONTRAST_MODE (raster only) - specifies the type of contrast adjustment to apply to the data.
♦ NONE - no contrast adjustment applied (this is the default)
♦ PERCENTAGE - apply a percentage contrast adjustment. The
CONTRAST_STRETCH_SIZE parameter can be used to override the number of standard
deviations from the mean to stretch to.

Map GPS Coordinates - GPS Map Coordinates - GPSCoordinates Map 228

 Global Mapper User's Manual
♦ MIN_MAX - apply a min/max contrast stretch, stretching the available range of values in
each color band to the full range of 0-255. For imagery which contains both black and
white, this will have no affect.
• CONTRAST_SHARED (raster only) - specified whether or not the contrast adjustment for this
layer will share the adjustment with other contrast-adjusted layers in order to ensure a consistent
modification across layers. Use CONTRAST_SHARED=YES to enable contrast sharing.
• CONTRAST_STRETCH_SIZE (raster only) - specifies the number of standard deviations from the
mean to use in a PERCENTAGE contrast adjustment. The default is 2.0.
• AUTO_CONTRAST (raster only) - DEPRECATED, use CONTRAST_MODE instead - specifies
whether to automatically calculate and apply a 2 standard deviation contrast adjustment to the
image. Use AUTO_CONTRAST=YES to turn on. Anything else turns it off.
• COLOR_INTENSITY (elevation and raster only) - specifies the color intensity to use when
adjusting the brightness of pixels in the overlay. Valid values range from 0 to 20, with 0 being
completely black, 10 being no alteration, and 20 being completely white. For example, to make an
image slightly darker, you could use COLOR_INTENSITY=7. (NOTE: This parameter has been
deprecated in favor of the COLOR_INTENSITY_FULL parameter).
• COLOR_INTENSITY_FULL (elevation and raster only) - specifies the color intensity to use when
adjusting the brightness of pixels in the overlay. Valid values range from 0 to 512, with 0 being
completely white, 256 being no alteration, and 512 being completely black. For example, to make
an image slightly darker, you could use COLOR_INTENSITY=300. (NOTE: This parameter
replaces the COLOR_INTENSITY parameter).
• TEXTURE_MAP - specifies that this image should be draped over any elevation data loaded
before it. Use TEXTURE_MAP=YES to turn on. Anything else turns it off.
• TRANSPARENT_COLOR - specifies the color to make transparent when rendering this overlay.
The color should be specified as RGB(<red>,<green>,<blue>). For example, to make white the
transparent color, use TRANSPARENT_COLOR=RGB(255,255,255). If you do not wish any
color to be transparent, do not use this parameter.
• TRANSLUCENCY - specifies the level of translucency (i.e. how "see-through" the layer is). Value
values range from 0 to 512, with 0 meaning the layer is completely transparent (i.e. invisible) and
512 meaning the layer is completely opaque (this is the default).
• BLEND_MODE - specifies the blend mode to use for combining this overlay and any previously
loaded overlays
♦ NO_BLEND - no blending is done, this is the default
♦ MULTIPLE
♦ SCREEN
♦ OVERLAY
♦ HARD_LIGHT
♦ COLOR_BURN
♦ COLOR_DODGE
♦ DARKEN
♦ LIGHTEN
♦ DIFFERENCE
♦ EXCLUSION
♦ APPLY_COLOR
♦ APPLY_COLOR_REVERSE
♦ KEEP_RED
♦ KEEP_GREEN
♦ KEEP_BLUE

Map GPS Coordinates - GPS Map Coordinates - GPSCoordinates Map 229

 Global Mapper User's Manual
LOAD_PROJECTION

The LOAD_PROJECTION command imports a projection from a PRJ file and makes it the current global
projection. This projection will be used for all exports after this command until another
LOAD_PROJECTION command is encountered to change the global projection. The following parameters
are supported by the command:

• FILENAME - full path to PRJ file to load the projection from

• PROJ_NAME - specifies the name of the projection to use. This name must have been defined with
a prior DEFINE_PROJ command.
• PROJ_EPSG_CODE - specifies the numeric EPSG projection code that defines the projection. For
example, use PROJ_EPSG_CODE=26715 to define a UTM zone 15 projection with NAD27 as the
datum and meters as the units.

LOAD_STYLE_FILE

The LOAD_STYLE_FILE command load a Global Mapper Style (.gm_style) file containing style
definitions for a list of types. You can optionally choose to have any types specified in the style file that
aren't present in the running instance of Global Mapper to be added, providing a script way to add new
custom types. The following parameters are supported by the command:

• FILENAME - full path to style (.gm_style) file to load

• ADD_UNKNOWN_TYPES - specifies that any types found in the style file that aren't present will
be added as custom types. Use ADD_UNKNOWN_TYPES=NO to disable adding missing types,
or ADD_UNKNOWN_TYPES=YES to enable it (this is the default).

LOAD_TYPE_FILTER

The LOAD_TYPE_FILTER command load a type filter from a Global Mapper Filter (GMF) file. You can
create new GMF files from the type filter dialogs accessible from the Vector Display tab of the
Configuration dialog. The following parameters are supported by the command:

• FILENAME - full path to GMF file to load

• FILTER_TYPE - specifies the type of features the filter file is for. The supported values area
FILTER_TYPE=AREA, FILTER_TYPE=LINE, or FILTER_TYPE=POINT.

PLAY_SOUND

The PLAY_SOUND command plays either the information sound for the system or a specified sound file.
This can be useful if you want audible confirmation when a script completes. The following parameters are
supported by the command.

• FILENAME - full path to sound file (like .wav) to play. If not specified the information beep will
play.

Map GPS Coordinates - GPS Map Coordinates - GPSCoordinates Map 230

 Global Mapper User's Manual
RESTORE_LAST_SAVED_VIEW

The RESTORE_LAST_SAVED_VIEW command restores the last view saved with the
SAVE_CURRENT_VIEW command (or the last view saved with the View->Save Current View menu
command in the Global Mapper user interface). This command does not take any parameters.

SAVE_CURRENT_VIEW

The SAVE_CURRENT_VIEW command saves the current view window for later restoration using the
RESTORE_LAST_SAVED_VIEW command. This command does not take any parameters.

SAVE_PROJECTION

The SAVE_PROJECTION command saves the current global projection to a PRJ file. The following
parameters are supported by the command.

• FILENAME - full path to PRJ file to save the projection to

SET_BG_COLOR

The SET_BG_COLOR command sets the color to use for any background pixels when rendering layers.
The following parameters are supported by the command.

• COLOR - specifies the background color to use. The color should be specified as
RGB(<red>,<green>,<blue>). For example, to make white the background color, use
COLOR=RGB(255,255,255).

SET_LOG_FILE

The SET_LOG_FILE command sets the name of the file to log status, warning, and error messages to. If
the log file specified already exists, the messages will be appended to the end of it. The following
parameters are supported by the command.

• FILENAME - full path to log file to write messages to

SET_VERT_DISP_OPTS

The SET_VERT_DISP_OPTS command allows you to modify the options used when rendering elevation
layers, such as the shader to use, if any, as well as the lighting and water setup. The following parameters
are supported by this command:

• ENABLE_HILL_SHADING - this setting controls whether or not hill shading (i.e. lighting,
shadowing) will be done. Use YES to enable hill shading, and NO to disable hill shading.

Map GPS Coordinates - GPS Map Coordinates - GPSCoordinates Map 231

 Global Mapper User's Manual
• SHADER_NAME - this sets the name of the shader to use when rendering elevation data. This
must be one of the names displayed in the shader drop down in Global Mapper, such as "Atlas
Shader" or "Global Shader" or the name of a custom shader.
• AMBIENT_LIGHT_LEVEL - this sets the ambient lighting level. The valid range of values is [0.0,
1.0], with smaller numbers meaning completely black (i.e. no light) and 1.0 being full lighting.
• VERT_EXAG - this sets the vertical exaggeration to use when rendering elevation overlays. This
effects the hill shading. The valid range of values is (0.0, 100.0].
• LIGHT_ALTITUDE - this sets the altitude angle of the light source that creates shadows on
elevation data. The valid range of values is [0.0, 90.0], with 0.0 meaning a light source at the
horizon and 90.0 meaning a light source directly overhead.
• LIGHT_AZIMUTH - this sets the direction angle of the light source that creates shadows on
elevation data. The valid range of values is [0.0, 360.0), with 0.0 meaning a light source from the
top of the screen (i.e. north), 90.0 meaning from the right (i.e. east), etc.
• SHADE_DARKNESS - this sets the minimum black level that a shadow can create. The valid
range of values is [0,255], with 0 allowing complete blackness from a shadow, and 255 allowing no
shadow at all.
• SHADE_HIGHLIGHT - this sets the level of white highlight applied to terrain areas directly facing
the sun/light angle. The valid range of values is [0,255], with 0 applying no highlight and 255
making the direct areas always brightened completely to white.
• ENABLE_WATER - this setting controls whether or not water will be displayed on top of
elevation values at or below the currently configured water level. Use YES to enable water display,
and NO to disable water display.
• WATER_COLOR - this setting controls the color that water drawn on top of elevation data is
rendered in. The format of this value is RGB(<red>,<green>,<blue>). For example, to use a water
color of blue, use WATER_COLOR=RGB(0,0,255).
• WATER_LEVEL - this setting specifies the height (in meters) below which water should be
displayed if enabled.
• WATER_ALPHA - this setting controls how "see through" the water is when displayed. The valid
range of values is [0,255], with 0 meaning the water is completely "see through", i.e. invisible, and
255 meaning that the water color is completely opaque such that you can't see any of the shaded
relief below it.

SHOW_3D_VIEW

The SHOW_3D_VIEW command displays the 3D view window with the loaded data.

The following parameters are supported by the command:

• MAXIMIZE - specifies whether or not the 3D view window should be maximized or not. Use
MAXIMIZE=YES to force the window to be maximized when displayed.

UNLOAD_ALL

The UNLOAD_ALL command unloads all currently loaded data. This command takes no parameters.

The following parameters are supported by the command:

Map GPS Coordinates - GPS Map Coordinates - GPSCoordinates Map 232

 Global Mapper User's Manual
• VECTOR_ONLY - specifies that only layers containing vector data shall be unloaded. All raster
and gridded elevation layers will remain loaded. Use VECTOR_ONLY=YES to enable unloading
just the vector layers.

UNLOAD_LAYER

The UNLOAD_LAYER command allows you to unload all previous loaded layers with a given filename.
This is useful if you don't want to unload all previously loaded layers just to get rid of a few of them.

The following parameters are supported by the command:

• FILENAME - filename of the layer to unload. If an empty value is passed in, all layers that were
created by the script, such as those from a GENERATE_CONTOURS command, will be unloaded.
You can also pass in the value 'USER CREATED FEATURES' when running a script in the
context of the main map view or loading a workspace to have the 'User Created Features' layer
unloaded. You can also pass in the full description of the loaded layer to use in case you want to
unload a layer not loaded from a file.

Crop, Merge, and Reproject 4 USGS DRGs into new GeoTIFF and JPEG files

GLOBAL_MAPPER_SCRIPT VERSION=1.00
UNLOAD_ALL

// Import the four 24K DRGs that we want to merge. We use the CLIP_COLLAR option
// to indicate that we want the collar to be automatically removed from the
// DRGs when they are imported.
IMPORT FILENAME="C:\DATA\DRG\KANSAS CITY\O39094B2.TIF" \
TYPE=AUTO ANTI_ALIAS=NO AUTO_CONTRAST=NO CLIP_COLLAR=AUTO TEXTURE_MAP=NO
IMPORT FILENAME="C:\DATA\DRG\KANSAS CITY\O39094A1.TIF" \
TYPE=AUTO ANTI_ALIAS=NO AUTO_CONTRAST=NO CLIP_COLLAR=AUTO TEXTURE_MAP=NO
IMPORT FILENAME="C:\DATA\DRG\KANSAS CITY\O39094A2.TIF" \
TYPE=AUTO ANTI_ALIAS=NO AUTO_CONTRAST=NO CLIP_COLLAR=AUTO TEXTURE_MAP=NO
IMPORT FILENAME="C:\DATA\DRG\KANSAS CITY\O39094B1.TIF" \
TYPE=AUTO ANTI_ALIAS=NO AUTO_CONTRAST=NO CLIP_COLLAR=AUTO TEXTURE_MAP=NO

// Load a projection file to set the global projection to geographic (lat/lon)

// arc degrees with a datum of NAD83.
LOAD_PROJECTION FILENAME="C:\DATA\PRJ Files\geo_degrees_nad83.prj"

// Use the EXPORT_RASTER command to generate a new 8-bit per pixel GeoTIFF file
EXPORT_RASTER FILENAME="C:\DATA\EXPORTED DATA\merged_drg_8bpp.tif" \
TYPE=GEOTIFF PALETTE=OPTIMIZED

// Now, use the EXPORT_RASTER command to generate a grayscale GeoTIFF file. Lets
// also create a world file for this one
EXPORT_RASTER FILENAME="C:\DATA\EXPORTED DATA\merged_drg_gray.tif" \
TYPE=GEOTIFF PALETTE=GRAYSCALE GEN_WORLD_FILE=YES

// Create a JPEG file using the EXPORT_RASTER command. Also create a world file
// and a projection file to make it easier to load in other places.
EXPORT_RASTER FILENAME="C:\DATA\EXPORTED DATA\merged_drg.jpg" \
TYPE=JPEG GEN_WORLD_FILE=YES GEN_PRJ_FILE=YES

Map GPS Coordinates - GPS Map Coordinates - GPSCoordinates Map 233

 Global Mapper User's Manual

Generate Contours from all USGS DEMs in a Folder and Export them to DXF and Shape files

GLOBAL_MAPPER_SCRIPT VERSION=1.00
UNLOAD_ALL

// Loop over all DEM files in a folder and convert them

DIR_LOOP_START DIRECTORY="C:\DATA\SDTS_DEM\24K\" FILENAME_MASKS="*.DEM.STDS.TAR.GZ" RECURSE_D

// Import an archived SDTS DEM file. Global Mapper will automatically

// determine that this is an archived SDTS DEM file and load it
// correctly.
IMPORT FILENAME="%FNAME_W_DIR%" ANTI_ALIAS=YES

// Generate 50 ft contours from the loaded DEM data.

GENERATE_CONTOURS INTERVAL=50 ELEV_UNITS=FEET

// Export the contours to a new DXF file. The created file will have
// 3D polyline features for the contours.
EXPORT_VECTOR FILENAME="%DIR%%FNAME_WO_EXT%_CONTOURS.DXF" TYPE=DXF GEN_PRJ_FILE=YES

// Export the contours to a 3D shape file.

EXPORT_VECTOR FILENAME="%DIR%%FNAME_WO_EXT%_CONTOURS.SHP" TYPE=SHAPEFILE \
SHAPE_TYPE=LINES GEN_3D_LINES=YES GEN_PRJ_FILE=YES

// Unload the loaded data

UNLOAD_ALL

// End the loop

DIR_LOOP_END

Reclassify Features Based on an Attribute and Display Label

GLOBAL_MAPPER_SCRIPT VERSION=1.00

// Import the file to modify

IMPORT FILENAME="C:\Temp\export test\tiger_wyandotte_sample.gmp"

// Assign the type "railroad" to all features with a CFCC attribute with a value of A41
// and a display label with '74' in it somewhere.
ASSIGN_TYPE LINE_TYPE="RAILROAD" COMPARE_STR="CFCC=A41" COMPARE_STR="<Feature Name>=*74*"

© 2009 Global Mappper LLC, All Rights Reserved [email protected]

Global Mapper Scripting Reference - Aerial View Of

Address - Aerial House View

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 234
 Global Mapper User's Manual
BUILT-IN AREA TYPES, FILL PATTERNS AND BORDER STYLES

This section reviews the area, line and point styles built into Global Mapper.

• Area Styles
♦ Area Types
♦ Area Fill Patterns
♦ Area Border Styles

Area Styles

Using the Area Styles panel users can configure how areas of a given type will be displayed in Global
Mapper. Area fill, border style and color can be modified on a type-by-type basis. The Show Labels for Areas
of This Type option allows users to turn area labels off on a type-by-type basis.

Area Types are shown in the Global Mapper Area Types table. Tables showing the Global Mapper Fill
Patterns and Border Styles follow the Area Types table.

Global Mapper recognizes five field attributes as containing information for the display appearence of an Area
Type. They are:

GM_TYPE=
BORDER_COLOR=
BORDER_WIDTH=
BORDER_STYLE=
FILL_COLOR=
FILL_STYLE=

The "FILL_ALPHA=" field attribute is recognized by Global Mapper to set an Area Type's transparency.
Values for "FILL_ALPHA=" range from 0 (Transparent) to 255 (Opaque). To determine the transparency
value setting simply multiply the percentage by 255 and round off to the nearest integer (e.g. 75%
transparency 0.75 x 255 = 191.25, use 191).

As an example, the default field attributes for the Anchorage Area Type are:

GM_TYPE=Anchorage Area
BORDER_COLOR=RGB(255,0,255)
BORDER_WIDTH=1
BORDER_STYLE=Comb (Right Only)
FILL_COLOR=RGB(255,0,255)
FILL_STYLE=No Fill

To change the type's transparency to 35% the FILL_ALPHA field attribute value should be set equal to 89
(0.35 x 255 = 89.25).

GM_TYPE=Anchorage Area
BORDER_COLOR=RGB(255,0,255)
BORDER_WIDTH=1
BORDER_STYLE=Comb (Right Only)
FILL_COLOR=RGB(255,0,255)
FILL_STYLE=No Fill
FILL_ALPHA=89

Area Types

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 235
 Global Mapper User's Manual
Global Mapper's View --> Background Color... color designation influences which areas can be seen. Any
area whose color is the same as the Global Mapper Backgrond Color will not be seen. Example, for a white
Background Color (RGB 255,255,255), the Snow or Glacier Area will not be visible.

Global Mapper Built-In Area Types

Border Border Border
Area Type Example Fill Pattern Fill Color
Width Style Color

Comb
Anchorage
No Fill 0,0,0 1 (Right 0,0,0
Area
Only)

City Park Solid Fill 0,235,0 1 Null 0,0,0

Country No Fill 0,0,0 1 Solid 0,0,0

County No Fill 0,0,0 2 Solid 0,0,0

County
No Fill 0,0,0 2 Solid 128,128,128
Subdivision

Coverage/Quad No Fill 0,0,0 1 Solid 0,0,0

Cropland Solid Fill 183,183,0 1 Null 0,0,0

Intermittent
Dry Lakebed Water 132,130,255 1 Null 0,0,0
Pattern

Intermittent
Intermittent
Water 132,130,255 1 Null 0,0,0
Lake
Pattern

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 236
 Global Mapper User's Manual

Intermittent
Intermittent
Water 132,130,255 1 Null 0,0,0
Stream/River
Pattern

Intertidal Area Solid Fill 192,240,188 1 Null 0,0,0

Island No Fill 0,0,0 1 Solid 0,0,0

Isobath Area Solid Fill 132,130,255 1 Null 0,0,0

Iso-height Area No Fill 0,0,0 1 Solid 128,64,0

Lake, < 0.5 sq.

Solid Fill 0,0,211 1 Null 0,0,0
mi.

Lake, > 500 sq.

Solid Fill 0,0,211 1 Null 0,0,0
mi.

Lake, 0.5 - 1
Solid Fill 0,0,211 1 Null 0,0,0
sq. mi.

Lake, 1 - 5 sq.
Solid Fill 0,0,211 1 Null 0,0,0
mi.

Lake, 10 - 30
Solid Fill 0,0,211 1 Null 0,0,0
sq. mi.

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 237
 Global Mapper User's Manual

Lake, 100 - 250

Solid Fill 0,0,211 1 Null 0,0,0
sq. mi.

Lake, 250 - 500

Solid Fill 0,0,211 1 Null 0,0,0
sq. mi.

Lake, 30 - 100
Solid Fill 0,0,211 1 Null 0,0,0
sq. mi.

Lake, 5 - 10 sq.
Solid Fill 0,0,211 1 Null 0,0,0
mi.

Lake,
Solid Fill 0,0,211 1 Null 0,0,0
Unknown Area

Land Area Solid Fill 220,212,148 1 Null 0,0,0

Land Grant No Fill 0,0,0 2 Null 0,0,0

Large Metro
Solid Fill 255,247,181 1 Null 0,0,0
Area

Major National
Solid Fill 0,235,0 1 Null 0,0,0
Park

Major River Solid Fill 0,0,211 1 Null 0,0,0

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 238
 Global Mapper User's Manual

Major State
Solid Fill 0,235,0 1 Null 0,0,0
Park

Map Catalog Diagonal

255,64,64 1 Solid 0,0,255
Layer Bounds Cros-Hatch

Comb
Marine Info
No Fill 255,0,255 1 (Right 255,0,0
Area
Only)

Backwards
Marine Traffic
Diagonal 255,0,255 1 Solid 0,0,0
Area
Cross-Hatch

Horizontal
Measurement 255,0,0 5 Striped 255,255,0
Hatch

Metro Area Solid Fill 255,247,181 1 Null 0,0,0

Minor River Solid Fill 0,0,211 1 Null 0,0,0

Misc.
Manmade Solid Fill 255,64,64 1 Null 0,0,0
Structure

National Park Solid Fill 0,235,0 1 Null 0,0,0

Ocean Solid Fill 0,0,211 1 Null 0,0,0

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 239
 Global Mapper User's Manual

Orchard or
Solid Fill 255,128,0 1 Null 0,0,0
Plantation

Range Ring No Fill 0,0,0 3 Solid 0,0,0

Reef Coral Pattern 255,0,0 1 Null 0,0,0

Regional River Solid Fill 0,0,211 1 Null 0,0,0

Reservation Solid Fill 255,0,0 1 Null 0,0,0

Rock Solid Fill 104,133,138 1 Null 0,0,0

Salt Salt Pattern 192,102,192 1 Null 0,0,0

Sand Sand Pattern 255,255,0 1 Null 0,0,0

Scattered Trees Solid Fill 0,255,0 1 Null 0,0,0

Diagonal
Scrub Area 0,128,128 1 Null 0,0,0
Cross-Hatch

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 240
 Global Mapper User's Manual

Small Metro
Solid Fill 255,247,181 1 Null 0,0,0
Area

Snow or
Solid Fill 255,255,255 1 Null 0,0,0
Glacier

State No Fill 0,0,0 3 Solid 0,0,0

State Park Solid Fill 0,235,0 1 Null 0,0,0

Survey Section No Fill 0,0,0 2 Solid 0,0,0

TIN Face Area No Fill 0,0,0 1 Solid 0,0,0

Tundra Solid Fill 145,177,196 1 Null 0,0,0

Unclassified
No Fill 0,0,0 1 Solid 0,0,0
Area Feature

Unknown Area
No Fill 0,0,0 1 Solid 0,0,0
Type

View Shed
No Fill 0,0,0 1 Solid 0,0,0
Coverage Area

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 241
 Global Mapper User's Manual

Wetland Solid Fill 125,191,167 1 Null 0,0,0

Backwards
Wooded Area Diagonal 165,145,97 1 Null 0,0,0
Cross-Hatch

Area Fill Patterns

Global Mapper Fill Patterns

Fill Pattern Example

No Fill

Solid Fill

Backwards Diagonal Cross-Hatch

Cross-Hatch

Diagonal Cross-Hatch

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 242
 Global Mapper User's Manual

Forward Diagonal Cross-Hatch

Horizontal Hatch

Vertical Hatch

Sand_Pattern

Intermittent_Water_Pattern

Salt_Pattern

Coral_Pattern

Black_Cross_Pattern

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 243
 Global Mapper User's Manual

Black_Dot_Pattern

Area Border Styles

Global Mapper Border Styles

Border Style Example

Solid

Dash

Dot

Dash - Dot

Dash - Dot - Dot

Null

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 244
 Global Mapper User's Manual

Railroad

Striped

Comb (Left Only)

Comb (Right Only)

Comb (Long Teeth, Left Only)

Comb (Long_Teeth, Right Only)

Comb (Widely Spaced, Left Only)

Comb (Widely Spaced, Right Only)

Comb (Long & Short Teeth, Left Only)

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 245
 Global Mapper User's Manual

Comb (Long & Short Teeth, Right Only)

Comb (Double Teeth, Left Only)

Comb (Double Teeth, Right Only)

Comb (Triplet, Left Only)

Comb (Triplet, Right Only)

Rake (Narrow Spaced, Left Only)

Rake (Narrow Spaced, Right Only)

Rake (Widely Spaced, Left Only)

Rake (Widely Spaced, Right Only)

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 246
 Global Mapper User's Manual

Solid with Minus Signs on Left

Solid with Minus Signs on Right

Solid with Plus Signs on Left

Solid with Plus Signs on Right

Solid with Dots on Left

Solid with Dots on Right

Solid with Ts on Left

Solid with Ts on Right

Solid with Rectangles on Left

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 247
 Global Mapper User's Manual

Solid with Rectangles on Right

Solid with Squares on Left

Solid with Squares on Right

Half Circles (Tightly Spaced, Left Only)

Half Circles (Tightly Spaced, Right Only)

Half Circles (Widely Spaced, Left Only)

Half Circles (Widely Spaced, Right Only)

Solid with Diamonds on Left

Solid with Diamonds on Right

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 248
 Global Mapper User's Manual

V Track (Opens Towards End of Null Line)

V Track (Opens Towards Start of Null Line)

C Track (Opens Towards End of Line)

C Track (Opens Towards Start of Line)

Arrow Track (Points Towards Start of Line)

Arrow Track (Points Towards End of Line)

V Track (Opens Towards End of Solid Line)

V Track (Opens Towards Start of Solid Line)

Solid with Xs Through Line

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 249
 Global Mapper User's Manual

Solid with Diamonds along Line

Solid with Empty Diamonds along Line

Solid with Circles along Line

Solid with Empty Circles along Line

Solid with Arrow Pointing to Start

Solid with Arrow Pointing to End

Solid with Empty Circle at Start

Solid with Empty Circle at End

Solid with Black Edges

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 250
 Global Mapper User's Manual

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 251
 Global Mapper User's Manual

BUILT-IN LINE TYPES AND DRAWING STYLES

This section reviews the area, line and point styles built into Global Mapper.

• Line Styles
♦ Line Type Features
♦ Drawing Styles

Line Styles

Upper line shows line types normal appearance. Lower line shows how line type appears when "Display
Roads As Fat Lines When Zoomed In" option is checked and display is zoomed in.

Global Mapper's View --> Background Color... color designation influences which lines can be seen. Any line
whose color is the same as the Global Mapper Backgrond Color will not be seen. Example, for a white
Background Color (RGB 255,255,255), the Processing/Closure Line will not be visible.

Global Mapper Built-In Line Types

Drawing Line
Line Type Example Line Color
Style Width

Airport Runway Solid 1 0,0,0

Alley or Driveway Solid 1 128,128,128

Arterial Road Solid 2 0,128,0

Bathymetric Contour,
Solid 2 132,130,255
Intermediate

Bathymetric Contour, Major Solid 3 132,130,255

Bathymetric Contour, Minor Solid 1 132,130,255

Bathymetric Contour,
Solid 1 132,130,255
Supplementary

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 252
 Global Mapper User's Manual

City Boundary Solid 1 0,0,0

Collector Road Solid 1 255,128,0

Contour Line, Intermediate Solid 2 128,64,0

Contour Line, Major Solid 3 128,64,0

Contour Line, Minor Solid 1 128,64,0

Contour Line,
Solid 1 128,64,0
Supplementary

County Route Solid 2 255,0,255

Deleted Line Dash 1 192,192,192

Digitizer Tool Line Striped 5 255,255,0

Dry Stream or River Dot 1 0,0,211

Ferry Route Solid 1 255,128,0

Grid Line Solid 1 128,128,128

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 253
 Global Mapper User's Manual

Grid Line - Major Solid 2 128,128,128

Grid Line - Minor Solid 1 128,128,128

Intermittent Stream or River Dash 1 0,0,211

International Political
Solid 6 0,0,0
Boundary

Interstate Solid 3 132,130,255

Invisible Boundary Dot 1 192,192,192

Major Political Boundary

Solid 5 128,128,128
(State)

Major/US Highway Solid 2 255,64,64

Marine Route Solid 1 0,0,0

Measurement Striped 5 255,255,0

Minor Political Boundary

Solid 4 0,0,0
(County)

Park Boundary Solid 1 0,255,0

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 254
 Global Mapper User's Manual

Pipeline Dash 1 128,128,128

Powerline Dash - Dot 1 128,128,128

Processing/Closure Line Solid 2 255,255,255

Railroad Railroad 1 0,0,0

Railroad, Class 1A Railroad 1 0,0,0

Railroad, Class 1B Railroad 1 0,0,0

Ramp Solid 1 0,255,255

Residential Road Solid 1 128,128,128

River, < 20 km Solid 1 0,0,211

River, > 250 km Solid 3 0,0,211

River, 100 - 250 km Solid 3 0,0,211

River, 20 - 50 km Solid 2 0,0,211

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 255
 Global Mapper User's Manual

River, 50 - 100 km Solid 2 0,0,211

River, Unknown Length Solid 1 0,0,211

Selected Line Dash 1 2550,0,0

Shoreline Solid 1 0,0,0

State Highway Solid 2 255,0,255

Stream Solid 1 0,0,211

Tracklog Dash 1 0,0,0

Trail Solid 1 128,128,128

Unclassified Line Feature Solid 1 128,128,128

Unknown Line Type Solid 1 0,0,0

Unpaved Road Solid 1 128,128,128

Drawing Styles

Global Mapper Drawing Styles

Drawing Style Example

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 256
 Global Mapper User's Manual

Solid

Dash

Dot

Dash - Dot

Dash - Dot - Dot

Null

Railroad

Striped

Comb (Left Only)

Comb (Right Only)

Comb (Long Teeth, Left Only)

Comb (Long Teeth, Right Only)

Comb (Widely Spaced, Left Only)

Comb (Widely Spaced, Right Only)

Comb (Long & Short Teeth, Left Only)

Comb (Long & Short Teeth, Right Only)

Comb (Double Teeth, Left Only)

Comb (Double Teeth, Right Only)

Comb (Triplet, Left Only)

Comb (Triplet, Right Only)

Rake (Narrow Spaced, Left Only)

Rake (Narrow Spaced, Right Only)

Rake (Widely Spaced, Left Only)

Rake (Widely Spaced, Right Only)

Solid with Minus Signs on Left

Solid with Minus Signs on Right

Solid with Plus Signs on Left

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 257
 Global Mapper User's Manual

Solid with Plus Signs on Right

Solid with Dots on Left

Solid with Dots on Right

Solid with Ts on Left

Solid with Ts on Right

Solid with Rectangles on Left

Solid with Rectangles on Right

Solid with Squares on Left

Solid with Squares on Right

Half Circles (Tightly Spaced, Left Only)

Half Circles (Tightly Spaced, Right Only)

Half Circles (Widely Spaced, Left Only)

Half Circles (Widely Spaced, Right Only)

Solid with Diamonds on Left

Solid with Diamonds on Right

V Track (Opens Towards End of Null Line)

V Track (Opens Towards Start of Null Line)

C Track (Opens Towards End of Line)

C Track (Opens Towards Start of Line)

Arrow Track (Points Towards Start of Line)

Arrow Track (Points Towards End of Line)

V Track (Opens Towards End of Solid Line)

V Track (Opens Towards Start of Solid Line)

Solid with Xs through Line

Solid with Diamonds along Line

Solid with Empty Diamonds along Line

Solid with Circles along Line

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 258
 Global Mapper User's Manual

Solid with Empty Circles along Line

Solid with Arrow Pointing to Start

Solid with Arrow Pointing to End

Solid with Empty Circle at Start

Solid with Empty Circle at End

Solid with Black Edges

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 259
 Global Mapper User's Manual
BUILT-IN POINT TYPES AND SYMBOLS

This section reviews the area, line and point styles built into Global Mapper.

• Point Styles
♦ Point Type Features
♦ Symbols - Basic
♦ Symbols - Geology

Point Styles

Using the Point Styles panel users can configure what symbol will be used to display points of a given type. In
addition, the Show Labels for Points of This Type option allows a user to turn point labels off on a
type-by-type basis. The Custom Symbols section allows users to create new symbols from their own bitmap
and icon files which they can then use as the symbol to display for a given type.

Global Mapper's Point Type Features are listed in the Global Mapper Point Type Features table. Symbols are
listed in the Global Mapper Symbols table.

Global Mapper recognizes two field attributes as containing information for the display appearence of a Point
Type. They are:

GM_TYPE=Address Label
POINT_SYMBOL=Dot - Red

Point Type Features

Global Mapper Built-In Point Type Features

Point Type Example Symbol

Address Label Dot - Red

Airport Airport

Amusement Center Amusement Center

Anchorage Marina

Arch Arch

Bank Bank

Beacon Dot

Boat Ramp Boat Ramp

Bottom Conditions Dot

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 260
 Global Mapper User's Manual

Bridge Bridge

Building School

Buoy Dot

Campground Campground

Cemetery Cemetery

Church Church

City, < 10K Dot

City, > 10M Dot

City, 100K - 500K Dot

City, 10K - 50K Dot

City, 1M - 10M Dot

City, 500K - 1M Dot

City, 50K - 100K Dot

City, Population Unknown Dot

Cliff Cliff

Country Dot

County Dot

Dam Dam

Danger Dot

First Aid Hospital

Geyser Geyser

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 261
 Global Mapper User's Manual

Golf Course Golf

Hospital Hospital

Island Dot

Land Grant Dot

Landmark Dot

Library Library

LIDAR, Building Elevation Shaded

LIDAR, Ground Shot Elevation Shaded

LIDAR, Power Lines Elevation Shaded

LIDAR, Towers or Poles Elevation Shaded

LIDAR, Unuclassified Elevation Shaded

LIDAR, Vegetation (High) Elevation Shaded

LIDAR, Vegetation (Low) Elevation Shaded

LIDAR, Vegetation (Medium) Elevation Shaded

LIDAR, Water Elevation Shaded

Lighthouse Lighthouse

Lodging Lodging

Marina Marina

Military Installation Dot

Mine Mine

Park Park

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 262
 Global Mapper User's Manual

Picnic Area Picnic Area

Picture Scenic View

Post Office Post Office

Resturant Resturant

Restrooms Restrooms

Rock Rock

School School

Shopping Shopping

Spot Elevation Spot Elevation

Spot Sounding No Symbol

Stadium Stadium

State Dot

Stream Origin Stream Origin

Summit Summit

Swimming Area Swimming Area

Tower Tower

Unclassified Point Feature Dot

Unknown Point Feature Dot

Waterfall Waterfall

Waypoint Dot

Weigh Station Weigh Station

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 263
 Global Mapper User's Manual

Well Well

Wreck Wreck

Symbols

Global Mapper Built-In Symbols

Name Symbol 2x Sym Details

Airport

Amusement Center

Arch

Auto Rental

Bank

Beacon

Big Red X

Big Yellow X

Boat Ramp

Bridge

Bullseye

Campground

Cemetry

Church

Cliff

Dam

Danger Area

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 264
 Global Mapper User's Manual

Deer

Diag Crosshair - Red

Diag Crosshair - Yellow

Dot

Dot - Blue

Dot - Green

Dot - Red

Dot - White

Dot - Yellow

Elevation Shaded

Fish

Fuel

Geyser

Golf

Hospital

Library

Lighthouse

Little Blue X

Lodging

Marina

Mine

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 265
 Global Mapper User's Manual

No Symbol

Park

Phone

Picnic Area

Post Office

Resturant

Restroom

Rock

Scenic View

School

Shopping

Skiing

Spot Elevation

Stadium

Stream Origin

Summit

Swimming Area

Tower

Waterfall

Weigh Station

Well

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 266
 Global Mapper User's Manual

Well - Active

Well - Active at TD

Well - Dryhole

Well - Gas

Well - Injection

Well - Location

Well - Oil

Well - Oil and Gas

Well - Suspended

Wreck

Symbols - Geology

Global Mapper Built-In Symbols

Name Symbol 2X Sym Details

Geology - Arrow (Medium, Aqua)

Geology - Arrow (Medium, Black)

Geology - Arrow (Medium, Green)

Geology - Arrow (Medium, Red)

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 267
 Global Mapper User's Manual

Geology - Arrow (Small, Aqua)

Geology - Arrow (Small, Black)

Geology - Arrow (Small, Green)

Geology - Arrow (Small, Red)

Geology - Cleavage (Medium, Aqua)

Geology - Cleavage (Medium, Black)

Geology - Cleavage (Medium, Green)

Geology - Cleavage (Medium, Red)

Geology - Cleavage (Small, Aqua)

Geology - Cleavage (Small, Black)

Geology - Cleavage (Small, Green)

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 268
 Global Mapper User's Manual

Geology - Cleavage (Small, Red)

Geology - Dip, Bedding (Medium, Aqua)

Geology - Dip, Bedding (Medium, Black)

Geology - Dip, Bedding (Medium, Green)

Geology - Dip, Bedding (Medium, Red)

Geology - Dip, Bedding (Small, Aqua)

Geology - Dip, Bedding (Small, Black)

Geology - Dip, Bedding (Small, Green)

Geology - Dip, Bedding (Small, Red)

Geology - Dip, Overturned (Medium, Aqua)

Geology - Dip, Overturned (Medium, Black)

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 269
 Global Mapper User's Manual

Geology - Dip, Overturned (Medium, Green)

Geology - Dip, Overturned (Medium, Red)

Geology - Dip, Overturned (Small, Aqua)

Geology - Dip, Overturned (Small, Black)

Geology - Dip, Overturned (Small, Green)

Geology - Dip, Overturned (Small, Red)

Geology - Foliation, Closed (Medium, Aqua)

Geology - Foliation, Closed (Medium, Black)

Geology - Foliation, Closed (Medium, Green)

Geology - Foliation, Closed (Medium, Red)

Geology - Foliation, Closed (Small, Aqua)

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 270
 Global Mapper User's Manual

Geology - Foliation, Closed (Small, Black)

Geology - Foliation, Closed (Small, Green)

Geology - Foliation, Closed (Small, Red)

Geology - Foliation, Open (Medium, Aqua)

Geology - Foliation, Open (Medium, Black)

Geology - Foliation, Open (Medium, Green)

Geology - Foliation, Open (Medium, Red)

Geology - Foliation, Open (Small, Aqua)

Geology - Foliation, Open (Small, Black)

Geology - Foliation, Open (Small, Green)

Geology - Foliation, Open (Small, Red)

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 271
 Global Mapper User's Manual

Geology - Horizontal Bedding (Medium, Aqua)

Geology - Horizontal Bedding (Medium, Black)

Geology - Horizontal Bedding (Medium, Green)

Geology - Horizontal Bedding (Medium, Red)

Geology - Horizontal Bedding (Small, Aqua)

Geology - Horizontal Bedding (Small, Black)

Geology - Horizontal Bedding (Small, Green)

Geology - Horizontal Bedding (Small, Red)

Geology - Joint, Closed (Medium, Aqua)

Geology - Joint, Closed (Medium, Black)

Geology - Joint, Closed (Medium, Green)

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 272
 Global Mapper User's Manual

Geology - Joint, Closed (Medium, Red)

Geology - Joint, Closed (Small, Aqua)

Geology - Joint, Closed (Small, Black)

Geology - Joint, Closed (Small, Green)

Geology - Joint, Closed (Small, Red)

Geology - Joint, Open (Medium, Aqua)

Geology - Joint, Open (Medium, Black)

Geology - Joint, Open (Medium, Green)

Geology - Joint, Open (Medium, Red)

Geology - Joint, Open (Small, Aqua)

Geology - Joint, Open (Small, Black)

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 273
 Global Mapper User's Manual

Geology - Joint, Open (Small, Green)

Geology - Joint, Open (Small, Red)

Geology - Vertical Bedding (Medium, Aqua)

Geology - Vertical Bedding (Medium, Black)

Geology - Vertical Bedding (Medium, Green)

Geology - Vertical Bedding (Medium, Red)

Geology - Vertical Bedding (Small, Aqua)

Geology - Vertical Bedding (Small, Black)

Geology - Vertical Bedding (Small, Green)

Geology - Vertical Bedding (Small, Red)

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 274
 Global Mapper User's Manual
BUILT-IN AREA, LINE AND POINT TYPES

This section reviews the area, line and point styles built into Global Mapper.

• Area Styles
♦ Area Types
♦ Area Fill Patterns
♦ Area Border Styles
• Line Styles
♦ Line Type Features
♦ Drawing Styles
• Point Styles
♦ Point Type Features
♦ Symbols - Basic
♦ Symbols - Geology

Area Styles

Using the Area Styles panel users can configure how areas of a given type will be displayed in Global
Mapper. Area fill, border style and color can be modified on a type-by-type basis. The Show Labels for Areas
of This Type option allows users to turn area labels off on a type-by-type basis.

Area Types are shown in the Global Mapper Area Types table. Tables showing the Global Mapper Fill
Patterns and Border Styles follow the Area Types table.

Global Mapper recognizes five field attributes as containing information for the display appearence of an Area
Type. They are:

GM_TYPE=
BORDER_COLOR=
BORDER_WIDTH=
BORDER_STYLE=
FILL_COLOR=
FILL_STYLE=

The "FILL_ALPHA=" field attribute is recognized by Global Mapper to set an Area Type's transparency.
Values for "FILL_ALPHA=" range from 0 (Transparent) to 255 (Opaque). To determine the transparency
value setting simply multiply the percentage by 255 and round off to the nearest integer (e.g. 75%
transparency 0.75 x 255 = 191.25, use 191).

As an example, the default field attributes for the Anchorage Area Type are:

GM_TYPE=Anchorage Area
BORDER_COLOR=RGB(255,0,255)
BORDER_WIDTH=1
BORDER_STYLE=Comb (Right Only)
FILL_COLOR=RGB(255,0,255)
FILL_STYLE=No Fill

To change the type's transparency to 35% the FILL_ALPHA field attribute value should be set equal to 89
(0.35 x 255 = 89.25).

GM_TYPE=Anchorage Area

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 275
 Global Mapper User's Manual
BORDER_COLOR=RGB(255,0,255)
BORDER_WIDTH=1
BORDER_STYLE=Comb (Right Only)
FILL_COLOR=RGB(255,0,255)
FILL_STYLE=No Fill
FILL_ALPHA=89

Area Types

Global Mapper's View --> Background Color... color designation influences which areas can be seen. Any
area whose color is the same as the Global Mapper Backgrond Color will not be seen. Example, for a white
Background Color (RGB 255,255,255), the Snow or Glacier Area will not be visible.

Global Mapper Built-In Area Types

Border Border Border
Area Type Example Fill Pattern Fill Color
Width Style Color

Comb
Anchorage
No Fill 0,0,0 1 (Right 0,0,0
Area
Only)

City Park Solid Fill 0,235,0 1 Null 0,0,0

Country No Fill 0,0,0 1 Solid 0,0,0

County No Fill 0,0,0 2 Solid 0,0,0

County
No Fill 0,0,0 2 Solid 128,128,128
Subdivision

Coverage/Quad No Fill 0,0,0 1 Solid 0,0,0

Cropland Solid Fill 183,183,0 1 Null 0,0,0

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 276
 Global Mapper User's Manual

Intermittent
Dry Lakebed Water 132,130,255 1 Null 0,0,0
Pattern

Intermittent
Intermittent
Water 132,130,255 1 Null 0,0,0
Lake
Pattern

Intermittent
Intermittent
Water 132,130,255 1 Null 0,0,0
Stream/River
Pattern

Intertidal Area Solid Fill 192,240,188 1 Null 0,0,0

Island No Fill 0,0,0 1 Solid 0,0,0

Isobath Area Solid Fill 132,130,255 1 Null 0,0,0

Iso-height Area No Fill 0,0,0 1 Solid 128,64,0

Lake, < 0.5 sq.

Solid Fill 0,0,211 1 Null 0,0,0
mi.

Lake, > 500 sq.

Solid Fill 0,0,211 1 Null 0,0,0
mi.

Lake, 0.5 - 1
Solid Fill 0,0,211 1 Null 0,0,0
sq. mi.

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 277
 Global Mapper User's Manual

Lake, 1 - 5 sq.
Solid Fill 0,0,211 1 Null 0,0,0
mi.

Lake, 10 - 30
Solid Fill 0,0,211 1 Null 0,0,0
sq. mi.

Lake, 100 - 250

Solid Fill 0,0,211 1 Null 0,0,0
sq. mi.

Lake, 250 - 500

Solid Fill 0,0,211 1 Null 0,0,0
sq. mi.

Lake, 30 - 100
Solid Fill 0,0,211 1 Null 0,0,0
sq. mi.

Lake, 5 - 10 sq.
Solid Fill 0,0,211 1 Null 0,0,0
mi.

Lake,
Solid Fill 0,0,211 1 Null 0,0,0
Unknown Area

Land Area Solid Fill 220,212,148 1 Null 0,0,0

Land Grant No Fill 0,0,0 2 Null 0,0,0

Large Metro
Solid Fill 255,247,181 1 Null 0,0,0
Area

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 278
 Global Mapper User's Manual

Major National
Solid Fill 0,235,0 1 Null 0,0,0
Park

Major River Solid Fill 0,0,211 1 Null 0,0,0

Major State
Solid Fill 0,235,0 1 Null 0,0,0
Park

Map Catalog Diagonal

255,64,64 1 Solid 0,0,255
Layer Bounds Cros-Hatch

Comb
Marine Info
No Fill 255,0,255 1 (Right 255,0,0
Area
Only)

Backwards
Marine Traffic
Diagonal 255,0,255 1 Solid 0,0,0
Area
Cross-Hatch

Horizontal
Measurement 255,0,0 5 Striped 255,255,0
Hatch

Metro Area Solid Fill 255,247,181 1 Null 0,0,0

Minor River Solid Fill 0,0,211 1 Null 0,0,0

Misc.
Manmade Solid Fill 255,64,64 1 Null 0,0,0
Structure

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 279
 Global Mapper User's Manual

National Park Solid Fill 0,235,0 1 Null 0,0,0

Ocean Solid Fill 0,0,211 1 Null 0,0,0

Orchard or
Solid Fill 255,128,0 1 Null 0,0,0
Plantation

Range Ring No Fill 0,0,0 3 Solid 0,0,0

Reef Coral Pattern 255,0,0 1 Null 0,0,0

Regional River Solid Fill 0,0,211 1 Null 0,0,0

Reservation Solid Fill 255,0,0 1 Null 0,0,0

Rock Solid Fill 104,133,138 1 Null 0,0,0

Salt Salt Pattern 192,102,192 1 Null 0,0,0

Sand Sand Pattern 255,255,0 1 Null 0,0,0

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 280
 Global Mapper User's Manual

Scattered Trees Solid Fill 0,255,0 1 Null 0,0,0

Diagonal
Scrub Area 0,128,128 1 Null 0,0,0
Cross-Hatch

Small Metro
Solid Fill 255,247,181 1 Null 0,0,0
Area

Snow or
Solid Fill 255,255,255 1 Null 0,0,0
Glacier

State No Fill 0,0,0 3 Solid 0,0,0

State Park Solid Fill 0,235,0 1 Null 0,0,0

Survey Section No Fill 0,0,0 2 Solid 0,0,0

TIN Face Area No Fill 0,0,0 1 Solid 0,0,0

Tundra Solid Fill 145,177,196 1 Null 0,0,0

Unclassified
No Fill 0,0,0 1 Solid 0,0,0
Area Feature

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 281
 Global Mapper User's Manual

Unknown Area
No Fill 0,0,0 1 Solid 0,0,0
Type

View Shed
No Fill 0,0,0 1 Solid 0,0,0
Coverage Area

Wetland Solid Fill 125,191,167 1 Null 0,0,0

Backwards
Wooded Area Diagonal 165,145,97 1 Null 0,0,0
Cross-Hatch

Area Fill Patterns

Global Mapper Fill Patterns

Fill Pattern Example

No Fill

Solid Fill

Backwards Diagonal Cross-Hatch

Cross-Hatch

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 282
 Global Mapper User's Manual

Diagonal Cross-Hatch

Forward Diagonal Cross-Hatch

Horizontal Hatch

Vertical Hatch

Sand_Pattern

Intermittent_Water_Pattern

Salt_Pattern

Coral_Pattern

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 283
 Global Mapper User's Manual

Black_Cross_Pattern

Black_Dot_Pattern

Area Border Styles

Global Mapper Border Styles

Border Style Example

Solid

Dash

Dot

Dash - Dot

Dash - Dot - Dot

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 284
 Global Mapper User's Manual

Null

Railroad

Striped

Comb (Left Only)

Comb (Right Only)

Comb (Long Teeth, Left Only)

Comb (Long_Teeth, Right Only)

Comb (Widely Spaced, Left Only)

Comb (Widely Spaced, Right Only)

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 285
 Global Mapper User's Manual

Comb (Long & Short Teeth, Left Only)

Comb (Long & Short Teeth, Right Only)

Comb (Double Teeth, Left Only)

Comb (Double Teeth, Right Only)

Comb (Triplet, Left Only)

Comb (Triplet, Right Only)

Rake (Narrow Spaced, Left Only)

Rake (Narrow Spaced, Right Only)

Rake (Widely Spaced, Left Only)

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 286
 Global Mapper User's Manual

Rake (Widely Spaced, Right Only)

Solid with Minus Signs on Left

Solid with Minus Signs on Right

Solid with Plus Signs on Left

Solid with Plus Signs on Right

Solid with Dots on Left

Solid with Dots on Right

Solid with Ts on Left

Solid with Ts on Right

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 287
 Global Mapper User's Manual

Solid with Rectangles on Left

Solid with Rectangles on Right

Solid with Squares on Left

Solid with Squares on Right

Half Circles (Tightly Spaced, Left Only)

Half Circles (Tightly Spaced, Right Only)

Half Circles (Widely Spaced, Left Only)

Half Circles (Widely Spaced, Right Only)

Solid with Diamonds on Left

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 288
 Global Mapper User's Manual

Solid with Diamonds on Right

V Track (Opens Towards End of Null Line)

V Track (Opens Towards Start of Null Line)

C Track (Opens Towards End of Line)

C Track (Opens Towards Start of Line)

Arrow Track (Points Towards Start of Line)

Arrow Track (Points Towards End of Line)

V Track (Opens Towards End of Solid Line)

V Track (Opens Towards Start of Solid Line)

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 289
 Global Mapper User's Manual

Solid with Xs Through Line

Solid with Diamonds along Line

Solid with Empty Diamonds along Line

Solid with Circles along Line

Solid with Empty Circles along Line

Solid with Arrow Pointing to Start

Solid with Arrow Pointing to End

Solid with Empty Circle at Start

Solid with Empty Circle at End

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 290
 Global Mapper User's Manual

Solid with Black Edges

Line Styles

Using the Line Styles panel users can configure how lines of a given type will be displayed in Global Mapper.
The line style, width, color, and label font can be modified on a type-by-type basis. In addition, the Show
Labels for Lines of This Type option allows users to turn line labels off on a type-by-type basis.

The Display Roads As Fat Lines When Zoomed In option allows users to turn on/off the "fattening" of road
lines when zoom in tight on them.

Global Mapper's Line Types are listed in the Global Mapper Line Types table. Drawing Styles are listed in the
Global Mapper Drawing Styles table.

Global Mapper recognizes four field attributes as containing information for the display appearence of a Line
Type. They are:

GM_TYPE=Airport Runway
LINE_WIDTH=1
LINE_COLOR=RGB(0,0,0)
LINE_STYLE=Solid

The "LINE_STYLE=" field attribute can be set to any one of the 60 Drawing Styles shown in the Global
Mapper Drawing Styles table.

Line Types

Upper line shows line types normal appearance. Lower line shows how line type appears when "Display
Roads As Fat Lines When Zoomed In" option is checked and display is zoomed in.

Global Mapper's View --> Background Color... color designation influences which lines can be seen. Any line
whose color is the same as the Global Mapper Backgrond Color will not be seen. Example, for a white
Background Color (RGB 255,255,255), the Processing/Closure Line will not be visible.

Global Mapper Built-In Line Types

Drawing Line
Line Type Example Line Color
Style Width

Airport Runway Solid 1 0,0,0

Alley or Driveway Solid 1 128,128,128

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 291
 Global Mapper User's Manual

Arterial Road Solid 2 0,128,0

Bathymetric Contour,
Solid 2 132,130,255
Intermediate

Bathymetric Contour, Major Solid 3 132,130,255

Bathymetric Contour, Minor Solid 1 132,130,255

Bathymetric Contour,
Solid 1 132,130,255
Supplementary

City Boundary Solid 1 0,0,0

Collector Road Solid 1 255,128,0

Contour Line, Intermediate Solid 2 128,64,0

Contour Line, Major Solid 3 128,64,0

Contour Line, Minor Solid 1 128,64,0

Contour Line,
Solid 1 128,64,0
Supplementary

County Route Solid 2 255,0,255

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 292
 Global Mapper User's Manual

Deleted Line Dash 1 192,192,192

Digitizer Tool Line Striped 5 255,255,0

Dry Stream or River Dot 1 0,0,211

Ferry Route Solid 1 255,128,0

Grid Line Solid 1 128,128,128

Grid Line - Major Solid 2 128,128,128

Grid Line - Minor Solid 1 128,128,128

Intermittent Stream or River Dash 1 0,0,211

International Political
Solid 6 0,0,0
Boundary

Interstate Solid 3 132,130,255

Invisible Boundary Dot 1 192,192,192

Major Political Boundary

Solid 5 128,128,128
(State)

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 293
 Global Mapper User's Manual

Major/US Highway Solid 2 255,64,64

Marine Route Solid 1 0,0,0

Measurement Striped 5 255,255,0

Minor Political Boundary

Solid 4 0,0,0
(County)

Park Boundary Solid 1 0,255,0

Pipeline Dash 1 128,128,128

Powerline Dash - Dot 1 128,128,128

Processing/Closure Line Solid 2 255,255,255

Railroad Railroad 1 0,0,0

Railroad, Class 1A Railroad 1 0,0,0

Railroad, Class 1B Railroad 1 0,0,0

Ramp Solid 1 0,255,255

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 294
 Global Mapper User's Manual

Residential Road Solid 1 128,128,128

River, < 20 km Solid 1 0,0,211

River, > 250 km Solid 3 0,0,211

River, 100 - 250 km Solid 3 0,0,211

River, 20 - 50 km Solid 2 0,0,211

River, 50 - 100 km Solid 2 0,0,211

River, Unknown Length Solid 1 0,0,211

Selected Line Dash 1 2550,0,0

Shoreline Solid 1 0,0,0

State Highway Solid 2 255,0,255

Stream Solid 1 0,0,211

Tracklog Dash 1 0,0,0

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 295
 Global Mapper User's Manual

Trail Solid 1 128,128,128

Unclassified Line Feature Solid 1 128,128,128

Unknown Line Type Solid 1 0,0,0

Unpaved Road Solid 1 128,128,128

Drawing Styles

Global Mapper Drawing Styles

Drawing Style Example
Solid

Dash

Dot

Dash - Dot

Dash - Dot - Dot

Null

Railroad

Striped

Comb (Left Only)

Comb (Right Only)

Comb (Long Teeth, Left Only)

Comb (Long Teeth, Right Only)

Comb (Widely Spaced, Left Only)

Comb (Widely Spaced, Right Only)

Comb (Long & Short Teeth, Left Only)

Comb (Long & Short Teeth, Right Only)

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 296
 Global Mapper User's Manual

Comb (Double Teeth, Left Only)

Comb (Double Teeth, Right Only)

Comb (Triplet, Left Only)

Comb (Triplet, Right Only)

Rake (Narrow Spaced, Left Only)

Rake (Narrow Spaced, Right Only)

Rake (Widely Spaced, Left Only)

Rake (Widely Spaced, Right Only)

Solid with Minus Signs on Left

Solid with Minus Signs on Right

Solid with Plus Signs on Left

Solid with Plus Signs on Right

Solid with Dots on Left

Solid with Dots on Right

Solid with Ts on Left

Solid with Ts on Right

Solid with Rectangles on Left

Solid with Rectangles on Right

Solid with Squares on Left

Solid with Squares on Right

Half Circles (Tightly Spaced, Left Only)

Half Circles (Tightly Spaced, Right Only)

Half Circles (Widely Spaced, Left Only)

Half Circles (Widely Spaced, Right Only)

Solid with Diamonds on Left

Solid with Diamonds on Right

V Track (Opens Towards End of Null Line)

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 297
 Global Mapper User's Manual

V Track (Opens Towards Start of Null Line)

C Track (Opens Towards End of Line)

C Track (Opens Towards Start of Line)

Arrow Track (Points Towards Start of Line)

Arrow Track (Points Towards End of Line)

V Track (Opens Towards End of Solid Line)

V Track (Opens Towards Start of Solid Line)

Solid with Xs through Line

Solid with Diamonds along Line

Solid with Empty Diamonds along Line

Solid with Circles along Line

Solid with Empty Circles along Line

Solid with Arrow Pointing to Start

Solid with Arrow Pointing to End

Solid with Empty Circle at Start

Solid with Empty Circle at End

Solid with Black Edges

Point Styles

Using the Point Styles panel users can configure what symbol will be used to display points of a given type. In
addition, the Show Labels for Points of This Type option allows a user to turn point labels off on a
type-by-type basis. The Custom Symbols section allows users to create new symbols from their own bitmap
and icon files which they can then use as the symbol to display for a given type.

Global Mapper's Point Type Features are listed in the Global Mapper Point Type Features table. Symbols are
listed in the Global Mapper Symbols table.

Global Mapper recognizes two field attributes as containing information for the display appearence of a Point
Type. They are:

GM_TYPE=Address Label
POINT_SYMBOL=Dot - Red

Point Type Features

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 298
 Global Mapper User's Manual

Global Mapper Built-In Point Type Features

Point Type Example Symbol

Address Label Dot - Red

Airport Airport

Amusement Center Amusement Center

Anchorage Marina

Arch Arch

Bank Bank

Beacon Dot

Boat Ramp Boat Ramp

Bottom Conditions Dot

Bridge Bridge

Building School

Buoy Dot

Campground Campground

Cemetery Cemetery

Church Church

City, < 10K Dot

City, > 10M Dot

City, 100K - 500K Dot

City, 10K - 50K Dot

City, 1M - 10M Dot

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 299
 Global Mapper User's Manual

City, 500K - 1M Dot

City, 50K - 100K Dot

City, Population Unknown Dot

Cliff Cliff

Country Dot

County Dot

Dam Dam

Danger Dot

First Aid Hospital

Geyser Geyser

Golf Course Golf

Hospital Hospital

Island Dot

Land Grant Dot

Landmark Dot

Library Library

LIDAR, Building Elevation Shaded

LIDAR, Ground Shot Elevation Shaded

LIDAR, Power Lines Elevation Shaded

LIDAR, Towers or Poles Elevation Shaded

LIDAR, Unuclassified Elevation Shaded

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 300
 Global Mapper User's Manual

LIDAR, Vegetation (High) Elevation Shaded

LIDAR, Vegetation (Low) Elevation Shaded

LIDAR, Vegetation (Medium) Elevation Shaded

LIDAR, Water Elevation Shaded

Lighthouse Lighthouse

Lodging Lodging

Marina Marina

Military Installation Dot

Mine Mine

Park Park

Picnic Area Picnic Area

Picture Scenic View

Post Office Post Office

Resturant Resturant

Restrooms Restrooms

Rock Rock

School School

Shopping Shopping

Spot Elevation Spot Elevation

Spot Sounding No Symbol

Stadium Stadium

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 301
 Global Mapper User's Manual

State Dot

Stream Origin Stream Origin

Summit Summit

Swimming Area Swimming Area

Tower Tower

Unclassified Point Feature Dot

Unknown Point Feature Dot

Waterfall Waterfall

Waypoint Dot

Weigh Station Weigh Station

Well Well

Wreck Wreck

Symbols

Global Mapper Built-In Symbols

Name Symbol 2x Sym Details

Airport

Amusement Center

Arch

Auto Rental

Bank

Beacon

Big Red X

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 302
 Global Mapper User's Manual

Big Yellow X

Boat Ramp

Bridge

Bullseye

Campground

Cemetry

Church

Cliff

Dam

Danger Area

Deer

Diag Crosshair - Red

Diag Crosshair - Yellow

Dot

Dot - Blue

Dot - Green

Dot - Red

Dot - White

Dot - Yellow

Elevation Shaded

Fish

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 303
 Global Mapper User's Manual

Fuel

Geyser

Golf

Hospital

Library

Lighthouse

Little Blue X

Lodging

Marina

Mine

No Symbol

Park

Phone

Picnic Area

Post Office

Resturant

Restroom

Rock

Scenic View

School

Shopping

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 304
 Global Mapper User's Manual

Skiing

Spot Elevation

Stadium

Stream Origin

Summit

Swimming Area

Tower

Waterfall

Weigh Station

Well

Well - Active

Well - Active at TD

Well - Dryhole

Well - Gas

Well - Injection

Well - Location

Well - Oil

Well - Oil and Gas

Well - Suspended

Wreck

Symbols - Geology

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 305
 Global Mapper User's Manual

Global Mapper Built-In Symbols

Name Symbol 2X Sym Details

Geology - Arrow (Medium, Aqua)

Geology - Arrow (Medium, Black)

Geology - Arrow (Medium, Green)

Geology - Arrow (Medium, Red)

Geology - Arrow (Small, Aqua)

Geology - Arrow (Small, Black)

Geology - Arrow (Small, Green)

Geology - Arrow (Small, Red)

Geology - Cleavage (Medium, Aqua)

Geology - Cleavage (Medium, Black)

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 306
 Global Mapper User's Manual

Geology - Cleavage (Medium, Green)

Geology - Cleavage (Medium, Red)

Geology - Cleavage (Small, Aqua)

Geology - Cleavage (Small, Black)

Geology - Cleavage (Small, Green)

Geology - Cleavage (Small, Red)

Geology - Dip, Bedding (Medium, Aqua)

Geology - Dip, Bedding (Medium, Black)

Geology - Dip, Bedding (Medium, Green)

Geology - Dip, Bedding (Medium, Red)

Geology - Dip, Bedding (Small, Aqua)

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 307
 Global Mapper User's Manual

Geology - Dip, Bedding (Small, Black)

Geology - Dip, Bedding (Small, Green)

Geology - Dip, Bedding (Small, Red)

Geology - Dip, Overturned (Medium, Aqua)

Geology - Dip, Overturned (Medium, Black)

Geology - Dip, Overturned (Medium, Green)

Geology - Dip, Overturned (Medium, Red)

Geology - Dip, Overturned (Small, Aqua)

Geology - Dip, Overturned (Small, Black)

Geology - Dip, Overturned (Small, Green)

Geology - Dip, Overturned (Small, Red)

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 308
 Global Mapper User's Manual

Geology - Foliation, Closed (Medium, Aqua)

Geology - Foliation, Closed (Medium, Black)

Geology - Foliation, Closed (Medium, Green)

Geology - Foliation, Closed (Medium, Red)

Geology - Foliation, Closed (Small, Aqua)

Geology - Foliation, Closed (Small, Black)

Geology - Foliation, Closed (Small, Green)

Geology - Foliation, Closed (Small, Red)

Geology - Foliation, Open (Medium, Aqua)

Geology - Foliation, Open (Medium, Black)

Geology - Foliation, Open (Medium, Green)

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 309
 Global Mapper User's Manual

Geology - Foliation, Open (Medium, Red)

Geology - Foliation, Open (Small, Aqua)

Geology - Foliation, Open (Small, Black)

Geology - Foliation, Open (Small, Green)

Geology - Foliation, Open (Small, Red)

Geology - Horizontal Bedding (Medium, Aqua)

Geology - Horizontal Bedding (Medium, Black)

Geology - Horizontal Bedding (Medium, Green)

Geology - Horizontal Bedding (Medium, Red)

Geology - Horizontal Bedding (Small, Aqua)

Geology - Horizontal Bedding (Small, Black)

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 310
 Global Mapper User's Manual

Geology - Horizontal Bedding (Small, Green)

Geology - Horizontal Bedding (Small, Red)

Geology - Joint, Closed (Medium, Aqua)

Geology - Joint, Closed (Medium, Black)

Geology - Joint, Closed (Medium, Green)

Geology - Joint, Closed (Medium, Red)

Geology - Joint, Closed (Small, Aqua)

Geology - Joint, Closed (Small, Black)

Geology - Joint, Closed (Small, Green)

Geology - Joint, Closed (Small, Red)

Geology - Joint, Open (Medium, Aqua)

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 311
 Global Mapper User's Manual

Geology - Joint, Open (Medium, Black)

Geology - Joint, Open (Medium, Green)

Geology - Joint, Open (Medium, Red)

Geology - Joint, Open (Small, Aqua)

Geology - Joint, Open (Small, Black)

Geology - Joint, Open (Small, Green)

Geology - Joint, Open (Small, Red)

Geology - Vertical Bedding (Medium, Aqua)

Geology - Vertical Bedding (Medium, Black)

Geology - Vertical Bedding (Medium, Green)

Geology - Vertical Bedding (Medium, Red)

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 312
 Global Mapper User's Manual

Geology - Vertical Bedding (Small, Aqua)

Geology - Vertical Bedding (Small, Black)

Geology - Vertical Bedding (Small, Green)

Geology - Vertical Bedding (Small, Red)

Global Mapper Scripting Reference - Aerial View Of Address - Aerial House View 313
 Global Mapper User's Manual

Built-in Datums
The following is a list of the datums built in to Global Mapper and the transformation parameters used to
convert those datums. All parameters are given with respect to transforming from the given datum to
WGS-84.

Datum Name EPSG Code Ellipsoid Name dX

ADINDAN 6201 Clarke 1880 -16
AIN EL ABD (BAHRAIN) 6204 International 1909 (Hayford/Intl 1924) -15
AIN EL ABD (SAUDI ARABIA) 6204 International 1909 (Hayford/Intl 1924) -14
ARATU (BRAZIL) 6208 International 1909 (Hayford/Intl 1924) -15
ARC1950 6209 Clarke 1880 -14
ARC1960 6210 Clarke 1880 -16
ASTRO B4 (SOROL ATOLL) Unknown International 1909 (Hayford/Intl 1924) 11
ASTRO BEACON Unknown International 1909 (Hayford/Intl 1924) 14
ASTRO DOS 71/4 Unknown International 1909 (Hayford/Intl 1924) -32
ASTRONOMIC STATION 1952 Unknown International 1909 (Hayford/Intl 1924) 12
ATS77 (NOVA SCOTIA) 6122 ATS77
AUSTRALIAN GEODETIC 1966 6202 Australian National
AUSTRALIAN GEODETIC 1984 6203 Australian National
BD72 (BELGIUM 1972) 6313 International 1909 (Hayford/Intl 1924) -9
BEIJING 1954 6214 Krassovsky 2
BESSEL 1841 (ITALY) [Castanea d. F.] Unknown Bessel 1841
BESSEL 1841 (ITALY) [Genova] Unknown Bessel 1841
BESSEL 1841 (ITALY) [Monte Mario] Unknown Bessel 1841
BESSEL 1841 [GREENWICH] Unknown Bessel 1841
BOGOTA OBSERVATORY 6218 International 1909 (Hayford/Intl 1924) 30
BUKIT RIMPAH 6219 Bessel 1841 -38
CAMACUPA 6220 Clarke 1880 (RGS) -4
CAMP AREA ASTRO 6715 International 1909 (Hayford/Intl 1924) -10
CAMPO INCHAUSPE (ARGENTINA) 6221 International 1909 (Hayford/Intl 1924) -14
CAPE 6222 Clarke 1880 -13
CARTHAGE 6223 Clarke 1880 -26
CHAD (WG1998) Unknown WGS72
CLARKE 1866 AUTHALIC SPHERE Unknown Sphere Radius 6370997 m
CORREGO ALEGRE (BRAZIL) 6225 International 1909 (Hayford/Intl 1924) -20
D-48 SLOVENIA Unknown Bessel 1841 66
DEALUL PISCULUI 1970 6317 Krassovsky 2
DEIR EZ ZOR (SYRIA) 6227 Clarke 1880 (IGN) -8
DUTCH (RD) 6289 Bessel 1841 56
EASTER ISLAND 1967 6719 International 1909 (Hayford/Intl 1924) 21
ED50 6230 International 1909 (Hayford/Intl 1924) -8

Built-in Datums 314

 Global Mapper User's Manual

ED50 (ENGLAND) 6230 International 1909 (Hayford/Intl 1924) -8

ED50 (FINLAND/NORWAY) 6230 International 1909 (Hayford/Intl 1924) -8
ED50 (GREECE) 6230 International 1909 (Hayford/Intl 1924) -8
ED50 (ITALY) 6230 International 1909 (Hayford/Intl 1924) -8
ED50 (NORTH SEA) 6230 International 1909 (Hayford/Intl 1924) -8
ED50 (NORWAY OFFSHORE - N62) 6230 International 1909 (Hayford/Intl 1924) -11
ED50 (NORWAY OFFSHORE - S62) 6230 International 1909 (Hayford/Intl 1924) -9
ED50 (SICILY) 6230 International 1909 (Hayford/Intl 1924) -9
ED50 (SPAIN/PORTUGAL) 6230 International 1909 (Hayford/Intl 1924)
ED79 6668 International 1967 -8
ED87 6231 International 1909 (Hayford/Intl 1924) -8
EGYPT 1907 6229 Helmert 1906 -13
EGYPT GULF OF SUEZ S-650 TL 6706 Helmert 1906 -14
ESTIONIA 1997 6180 GRS 1980
ETRF2000 - RDN 6326 GRS 1980
ETRS89 6258 GRS 1980
FD 1958 (IRAQ) 6132 Clarke 1880 (RGS) -24
FINLAND/HAYFORD 6123 International 1909 (Hayford/Intl 1924) -7
GDA 94 (AUSTRALIAN GEODETIC 1994) 6283 GRS 1980
GGRS87 (GREECE) 6121 GRS 1980 -19
GOOGLE MAPS (SPHERE RADIUS 6378137) Unknown Sphere Radius 6378137 m
GRS80 ELLIPSOID 6326 GRS 1980
GUAM 1963 6675 Clarke 1866 -10
HARTEBEESTHOEK 1994 (S. AFRICA) 6148 GRS 1980
HERAT NORTH (AFGHANISTAN) 6255 International 1909 (Hayford/Intl 1924) -33
HERMANNSKOGEL Unknown Bessel 1841 65
HJORSEY 1955 6658 International 1909 (Hayford/Intl 1924) -7
HONG KONG 1963 6738 International 1909 (Hayford/Intl 1924) -15
HU TZU SHAN 6236 International 1909 (Hayford/Intl 1924) -63
HUNGARIAN DATUM 1972 6237 GRS 1967 (Indonesia 1974) 5
IGN72 GRANDE TERRE (NEW CALEDONIA) 6634 International 1909 (Hayford/Intl 1924) 9
INDIAN (BANGLADESH) Unknown Everest 1830 28
INDIAN (MEAN VALUE) Unknown Everest 1830 17
INDIAN (NEPAL) 6146 Everest 1956 29
INDIAN (THAILAND) Unknown Everest 1830 21
INDIAN 1954 6239 Everest 1830 21
INDIAN 1975 6240 Everest 1830 21
INDONESIA 1974 6238 GRS 1967 (Indonesia 1974) -2
IRELAND 1965 Unknown Modified Airy 50
IRELAND 1965 (1975 ADJUSTMENT) Unknown Modified Airy 48
IRENET95 6173 GRS 1980
ISN93 (ICELAND) 6659 GRS 1980

Built-in Datums 315

 Global Mapper User's Manual

ISTS 073 ASTRO Unknown International 1909 (Hayford/Intl 1924) 20

JAD2001 (JAMAICA 2001) 6758 WGS84
JAD69 (JAMAICA 1969) 6242 Clarke 1866 6
JGD2000 (JAPAN) 6612 GRS 1980
JORDAN Unknown International 1909 (Hayford/Intl 1924) -8
KERTAU 1948 6245 Everest 1830 -1
KERTAU 1948 (MALAYSIA) 6245 Everest 1830 -37
KKJ (FINNISH GRID) 6123 International 1909 (Hayford/Intl 1924) -9
KOREAN 1985 6162 Bessel 1841
KOREAN 1995 6166 WGS84
KOREAN GEODETIC DATUM (KGD) 6737 GRS 1980
LA CANOA (VENEZUELA) 6247 International 1909 (Hayford/Intl 1924) -27
LEIGON (GHANA) 6250 Clarke 1880 -13
LISBON/LISBOA 1937 (DLx) 6207 International 1909 (Hayford/Intl 1924) -28
LKS92 (LATVIA) 6661 GRS 1980
LUREF (LUXEMBOURG) Unknown International 1909 (Hayford/Intl 1924)
LUZON (PHILIPPINES) 6253 Clarke 1866 -13
M'PORALOKO (GABON) 6266 Clarke 1880 -8
MALONGO 1987 6259 International 1909 (Hayford/Intl 1924) -25
MERCHICH (MOROCCO) 6261 Clarke 1880 3
MGI AUSTRIA 6312 Bessel 1841 57
MINNA (CAMEROON) 6263 Clarke 1880 -8
MINNA (NIGERIA) 6263 Clarke 1880 -9
MN COUNTY (ANOKA) 6152 MN County - Anoka
MN COUNTY (BECKER) 6152 MN County - Becker
MN COUNTY (BELTRAMI NORTH) 6152 MN County - Beltrami North
MN COUNTY (BELTRAMI SOUTH) 6152 MN County - Beltrami South
MN COUNTY (BENTON) 6152 MN County - Benton
MN COUNTY (BIG STONE) 6152 MN County - Big Stone
MN COUNTY (BLUE EARTH) 6152 MN County - Blue Earth
MN COUNTY (BROWN) 6152 MN County - Brown
MN COUNTY (CARLTON) 6152 MN County - Carlton
MN COUNTY (CARVER) 6152 MN County - Carver
MN COUNTY (CASS NORTH) 6152 MN County - Cass North
MN COUNTY (CASS SOUTH) 6152 MN County - Cass South
MN COUNTY (CHIPPEWA) 6152 MN County - Chippewa
MN COUNTY (CHISAGO) 6152 MN County - Chisago
MN COUNTY (COOK NORTH) 6152 MN County - Cook North
MN COUNTY (COOK SOUTH) 6152 MN County - Cook South
MN COUNTY (COTTONWOOD) 6152 MN County - Cottonwood
MN COUNTY (CROW WING) 6152 MN County - Crow Wing
MN COUNTY (DAKOTA) 6152 MN County - Dakota

Built-in Datums 316

 Global Mapper User's Manual

MN COUNTY (DODGE) 6152 MN County - Dodge

MN COUNTY (DOUGLAS) 6152 MN County - Douglas
MN COUNTY (FARIBAULT) 6152 MN County - Faribault
MN COUNTY (FILLMORE) 6152 MN County - Fillmore
MN COUNTY (FREEBORN) 6152 MN County - Freeborn
MN COUNTY (GOODHUE) 6152 MN County - Goodhue
MN COUNTY (GRANT) 6152 MN County - Grant
MN COUNTY (HENNEPIN) 6152 MN County - Hennepin
MN COUNTY (HOUSTON) 6152 MN County - Houston
MN COUNTY (ISANTI) 6152 MN County - Isanti
MN COUNTY (ITASCA NORTH) 6152 MN County - Itasca North
MN COUNTY (ITASCA SOUTH) 6152 MN County - Itasca South
MN COUNTY (JACKSON) 6152 MN County - Jackson
MN COUNTY (KANABEC) 6152 MN County - Kanabec
MN COUNTY (KANDIYOHI) 6152 MN County - Kandiyohi
MN COUNTY (KITTSON) 6152 MN County - Kittson
MN COUNTY (KOOCHICHING) 6152 MN County - Koochiching
MN COUNTY (LAC QUI PARLE) 6152 MN County - Lac Qui Parle
MN COUNTY (LAKE OF THE WOODS NORTH) 6152 MN County - Lake of the Woods North
MN COUNTY (LAKE OF THE WOODS SOUTH) 6152 MN County - Lake of the Woods South
MN COUNTY (LE SUEUR) 6152 MN County - Le Sueur
MN COUNTY (LINCOLN) 6152 MN County - Lincoln
MN COUNTY (LYON) 6152 MN County - Lyon
MN COUNTY (MAHNOMEN) 6152 MN County - Mahnomen
MN COUNTY (MARSHALL) 6152 MN County - Marshall
MN COUNTY (MARTIN) 6152 MN County - Martin
MN COUNTY (MCLEOD) 6152 MN County - McLeod
MN COUNTY (MEEKER) 6152 MN County - Meeker
MN COUNTY (MORRISON) 6152 MN County - Morrison
MN COUNTY (MOWER) 6152 MN County - Mower
MN COUNTY (MURRAY) 6152 MN County - Murray
MN COUNTY (NICOLLET) 6152 MN County - Nicollet
MN COUNTY (NOBLES) 6152 MN County - Nobles
MN COUNTY (NORMAN) 6152 MN County - Norman
MN COUNTY (OLMSTED) 6152 MN County - Olmsted
MN COUNTY (OTTERTAIL) 6152 MN County - Ottertail
MN COUNTY (PENNINGTON) 6152 MN County - Pennington
MN COUNTY (PINE) 6152 MN County - Pine
MN COUNTY (PIPESTONE) 6152 MN County - Pipestone
MN COUNTY (POLK) 6152 MN County - Polk
MN COUNTY (POPE) 6152 MN County - Pope
MN COUNTY (RAMSEY) 6152 MN County - Ramsey

Built-in Datums 317

 Global Mapper User's Manual

MN COUNTY (RED LAKE) 6152 MN County - Red Lake

MN COUNTY (REDWOOD) 6152 MN County - Redwood
MN COUNTY (RENVILLE) 6152 MN County - Renville
MN COUNTY (RICE) 6152 MN County - Rice
MN COUNTY (ROCK) 6152 MN County - Rock
MN COUNTY (ROSEAU) 6152 MN County - Roseau
MN COUNTY (SCOTT) 6152 MN County - Scott
MN COUNTY (SHERBURNE) 6152 MN County - Sherburne
MN COUNTY (SIBLEY) 6152 MN County - Sibley
MN COUNTY (ST LOUIS CENTRAL) 6152 MN County - St Louis Central
MN COUNTY (ST LOUIS NORTH) 6152 MN County - St Louis North
MN COUNTY (ST LOUIS SOUTH) 6152 MN County - St Louis South
MN COUNTY (STEARNS) 6152 MN County - Stearns
MN COUNTY (STEELE) 6152 MN County - Steele
MN COUNTY (STEVENS) 6152 MN County - Stevens
MN COUNTY (SWIFT) 6152 MN County - Swift
MN COUNTY (TODD) 6152 MN County - Todd
MN COUNTY (TRAVERSE) 6152 MN County - Traverse
MN COUNTY (WABASHA) 6152 MN County - Wabasha
MN COUNTY (WADENA) 6152 MN County - Wadena
MN COUNTY (WASECA) 6152 MN County - Waseca
MN COUNTY (WATONWAN) 6152 MN County - Watonwan
MN COUNTY (WINONA) 6152 MN County - Winona
MN COUNTY (WRIGHT) 6152 MN County - Wright
MN COUNTY (YELLOW MEDICINE) 6152 MN County - Yellow Medicine
MODIS SPHEROID (6371007.181 M) Unknown Sphere Radius 6371007.181 m
NAD27 6267 Clarke 1866
NAD27 (ALASKA) 6267 Clarke 1866
NAD27 (ALEUTIAN ISLANDS EAST) 6267 Clarke 1866
NAD27 (ALEUTIAN ISLANDS WEST) 6267 Clarke 1866
NAD27 (BAHAMAS) 6267 Clarke 1866
NAD27 (CANADA) 6267 Clarke 1866
NAD27 (CANAL ZONE) 6267 Clarke 1866
NAD27 (CARIBBEAN) 6267 Clarke 1866
NAD27 (CENTRAL AMERICA) 6267 Clarke 1866
NAD27 (CONUS) 6267 Clarke 1866
NAD27 (CUBA) 6267 Clarke 1866
NAD27 (GREENLAND) 6267 Clarke 1866 1
NAD27 (MEXICO) 6267 Clarke 1866 -1
NAD27 (SAN SALVADOR) 6267 Clarke 1866
NAD27 (YUMA PROVING GROUNDS) 6267 Clarke 1866
NAD83 6269 GRS 1980

Built-in Datums 318

 Global Mapper User's Manual

NAD83 (ALABAMA HPGN) 6152 GRS 1980

NAD83 (ARIZONA HPGN) 6152 GRS 1980
NAD83 (ARKANSAS HPGN) 6152 GRS 1980
NAD83 (CALIFORNIA NORTH HPGN) 6152 GRS 1980
NAD83 (CALIFORNIA SOUTH HPGN) 6152 GRS 1980
NAD83 (COLORADO HPGN) 6152 GRS 1980
NAD83 (FLORIDA HPGN) 6152 GRS 1980
NAD83 (GEORGIA HPGN) 6152 GRS 1980
NAD83 (HAWAII HPGN) 6152 GRS 1980
NAD83 (ILLINOIS HPGN) 6152 GRS 1980
NAD83 (INDIANA HPGN) 6152 GRS 1980
NAD83 (IOWA HPGN) 6152 GRS 1980
NAD83 (KANSAS HPGN) 6152 GRS 1980
NAD83 (KENTUCKY HPGN) 6152 GRS 1980
NAD83 (LOUISIANA HPGN) 6152 GRS 1980
NAD83 (MAINE HPGN) 6152 GRS 1980
NAD83 (MARYLAND-DELAWARE HPGN) 6152 GRS 1980
NAD83 (MICHIGAN HPGN) 6152 GRS 1980
NAD83 (MINNESOTA HPGN) 6152 GRS 1980
NAD83 (MISSISSIPPI HPGN) 6152 GRS 1980
NAD83 (MISSOURI HPGN) 6152 GRS 1980
NAD83 (MONTANA EAST HPGN) 6152 GRS 1980
NAD83 (MONTANA WEST-IDAHO HPGN) 6152 GRS 1980
NAD83 (NEBRASKA HPGN) 6152 GRS 1980
NAD83 (NEVADA HPGN) 6152 GRS 1980
NAD83 (NEW ENGLAND HPGN) 6152 GRS 1980
NAD83 (NEW JERSEY HPGN) 6152 GRS 1980
NAD83 (NEW MEXICO HPGN) 6152 GRS 1980
NAD83 (NEW YORK HPGN) 6152 GRS 1980
NAD83 (NORTH DAKOTA HPGN) 6152 GRS 1980
NAD83 (OHIO HPGN) 6152 GRS 1980
NAD83 (OKLAHOMA HPGN) 6152 GRS 1980
NAD83 (PENNSYLVANIA HPGN) 6152 GRS 1980
NAD83 (PUERTO RICO/VIRGIN ISLANDS HPGN) 6152 GRS 1980
NAD83 (SOUTH CAROLINA HPGN) 6152 GRS 1980
NAD83 (SOUTH DAKOTA HPGN) 6152 GRS 1980
NAD83 (TENNESSEE HPGN) 6152 GRS 1980
NAD83 (TEXAS EAST HPGN) 6152 GRS 1980
NAD83 (TEXAS WEST HPGN) 6152 GRS 1980
NAD83 (UTAH HPGN) 6152 GRS 1980
NAD83 (VIRGINIA HPGN) 6152 GRS 1980
NAD83 (WASHINGTON-OREGON HPGN) 6152 GRS 1980

Built-in Datums 319

 Global Mapper User's Manual

NAD83 (WEST VIRGINIA HPGN) 6152 GRS 1980

NAD83 (WISCONSIN HPGN) 6152 GRS 1980
NAD83 (WYOMING HPGN) 6152 GRS 1980
NAHRWAN (UAE) 6270 Clarke 1880 (RGS) -24
NAPARIMA 1972 (TRINIDAD & TOBAGO) 6271 International 1909 (Hayford/Intl 1924)
NEW ISRAELI DATUM (NID) 6141 GRS 1980 -2
NGO 1948 (GREENWICH MERIDIAN) 6273 Bessel (Modified) 27
NGO 1948 (OSLO MERIDIAN) 6817 Bessel (Modified) 27
NORTH SAHARA 1959 6307 Clarke 1880 -18
NORTH SAHARA 1959 (HASSI MESSAOUD) 6307 Clarke 1880 -15
NTF FRANCE (GREENWICH MERIDIAN) 6275 Clarke 1880 (IGN)
NTF FRANCE (PARIS MERIDIAN) 6807 Clarke 1880 (IGN)
NZGD2000 6167 GRS 1980
NZGD49 6272 International 1909 (Hayford/Intl 1924)
OBSERVATORIO 1966 Unknown International 1909 (Hayford/Intl 1924) -42
OCOTEPEQUE (COSTA RICA) Unknown Clarke 1866 21
OLD HAWAIIAN MEAN 6267 Clarke 1866
OLD ISRAELI DATUM (OID) 6281 Clarke 1880 (Palestine) -27
OMAN Unknown Clarke 1880 -34
ORDNANCE SURVEY 1936 (OSGB36) 6277 Airy
PICO DE LAS NIEVES 6728 International 1909 (Hayford/Intl 1924) -30
POINTE NOIRE 1948 (CONGO) 6282 Clarke 1880 -14
PORTUGESE 1973 (DATUM 73) 6274 International 1909 (Hayford/Intl 1924) -23
POSGAR94 (ARGENTINA) 6694 GRS 1980
POTSDAM/DHDN (GERMANY) 6314 Bessel 1841 59
PROVISIONAL SOUTH CHILEAN Unknown International 1909 (Hayford/Intl 1924) 1
PRS92 (PHILIPPINES) 6683 Clarke 1866 -12
PSAD56 (PROV. S. AMERICAN 1956) 6248 International 1909 (Hayford/Intl 1924) -28
PSD93 (OMAN) 6134 Clarke 1880 -18
PUERTO RICO 6139 Clarke 1866
QND95 (QATAR) 6614 International 1909 (Hayford/Intl 1924) -11
QORNOQ 6287 International 1909 (Hayford/Intl 1924) 16
REUNION ISLAND 6626 International 1909 (Hayford/Intl 1924) 9
REYKJAVIK 1900 6659 Danish 1876 -2
RGF-93 6171 GRS 1980
RGNC91-93 (NEW CALEDONIA) 6749 GRS 1980
ROME 1940 [MONTE MARIO] (GREENWICH) 6265 International 1909 (Hayford/Intl 1924) -10
ROME 1940 [MONTE MARIO] (ROME) 6806 International 1909 (Hayford/Intl 1924) -10
RT90 6124 Bessel 1841 41
S-42 (PULKOVO 1942) 6284 Krassovsky
S-42 ALBANIA 6284 Krassovsky 2
S-42 AZERBAIJAN/GEORGIA 6284 Krassovsky 68

Built-in Datums 320

 Global Mapper User's Manual

S-42 CZECHOSLOVAKIA 6284 Krassovsky 2

S-42 ESTONIA 6284 Krassovsky 2
S-42 GERMANY 6284 Krassovsky 2
S-42 HUNGARY 6284 Krassovsky 2
S-42 KAZAKHSTAN 6284 Krassovsky 4
S-42 LATVIA 6284 Krassovsky 2
S-42 LITHUANIA 6284 Krassovsky -4
S-42 POLAND 6284 Krassovsky 3
S-42 ROMANIA 6284 Krassovsky
S-42 RUSSIA 6284 Krassovsky 2
S-JTSK (CZECH REPUBLIC) 6156 Bessel 1841 57
SAO BRAZ Unknown International 1909 (Hayford/Intl 1924) -20
SCHWARZECK (NAMIBIA) 6293 Bessel 1841 61
SIRGAS 2000 (BRAZIL) 6674 GRS 1980
SOLOMON 1968 (GUX 1 ASTRO) 6718 International 1909 (Hayford/Intl 1924) 25
SOUTH AMERICAN 1969 6291 South America 1969 -5
SOUTH AMERICAN 1969 (BRAZIL) 6291 South America 1969 -6
SOUTHEAST BASE Unknown International 1909 (Hayford/Intl 1924) -49
SOUTHWEST BASE Unknown International 1909 (Hayford/Intl 1924) -10
SWEREF99 (SWEDEN) 6619 GRS 1980
SWISS GRID (CH1903) 6149 Bessel 1841 67
TANANARIVE 1925 (GREENWICH) 6297 International 1909 (Hayford/Intl 1924) -17
TANANARIVE 1925 (PARIS) 6810 International 1909 (Hayford/Intl 1924) -17
TIMBALAI 1948 6298 Everest 1830 (1967 Definition) -67
TOKYO 6301 Bessel 1841 -12
TRINIDAD 1903 6302 Clarke 1858 -6
WGS72 6322 WGS72
WGS84 6326 WGS84
WI COUNTY (BURNETT) 6152 WI County - Burnett
WI COUNTY (DOUGLAS) 6152 WI County - Douglas
WI COUNTY (SHEBOYGAN) 6152 WI County - Sheboygan
YACARE (URAGUAY) 6309 International 1909 (Hayford/Intl 1924) -15
ZANDERIJ (SURINAME) 6311 International 1909 (Hayford/Intl 1924) -26

Built-in Ellipsoids
Ellipsoid Name Semi-Major Axis (m)
ATS77 6378135.000
Airy 6377563.396
Australian National 6378160.000
Bessel (Modified) 6377492.018

Built-in Ellipsoids 321

 Global Mapper User's Manual

Bessel 1841 6377397.155

Clarke 1858 6378293.645
Clarke 1866 6378206.400
Clarke 1880 6378249.145
Clarke 1880 (Benoit) 6378300.789
Clarke 1880 (IGN) 6378249.200
Clarke 1880 (Palestine) 6378300.789
Clarke 1880 (RGS) 6378249.145
Danish 1876 6377019.270
Everest 1830 6377276.345
Everest 1830 (1967 Definition) 6377298.556
Everest 1956 6377301.243
GRS 1967 (Indonesia 1974) 6378160.000
GRS 1980 6378137.000
Helmert 1906 6378200.000
Hough 6378270.000
International 1909 (Hayford/Intl 1924) 6378388.000
International 1967 6378157.500
Interplanetary, Callisto 2408800.000
Interplanetary, Europa 1561300.000
Interplanetary, Ganymede 2634500.000
Interplanetary, Io 1826100.000
Interplanetary, Jupiter 71398000.000
Interplanetary, Mars 1990 3393400.000
Interplanetary, Mars 2000 3396190.000
Interplanetary, Mars 2000 Polar Sphere 3376200.000
Interplanetary, Mars 2000 Sphere 3396190.000
Interplanetary, Mercury 2439000.000
Interplanetary, Moon 1737400.000
Interplanetary, Neptune 24712000.000
Interplanetary, Pluto 1175000.000
Interplanetary, Saturn 60268000.000
Interplanetary, Titan 2575000.000
Interplanetary, Uranus 26200000.000
Interplanetary, Venus 6051800.000
Interplanetary, Venus 1985 6051000.000
Krassovsky 6378245.000
MN County - Anoka 6378418.941
MN County - Becker 6378586.581
MN County - Beltrami North 6378505.809
MN County - Beltrami South 6378544.823
MN County - Benton 6378490.569

Built-in Ellipsoids 322

 Global Mapper User's Manual

MN County - Big Stone 6378470.757

MN County - Blue Earth 6378403.701
MN County - Brown 6378434.181
MN County - Carlton 6378454.907
MN County - Carver 6378400.653
MN County - Cass North 6378567.378
MN County - Cass South 6378546.957
MN County - Chippewa 6378476.853
MN County - Chisago 6378411.321
MN County - Cook North 6378647.541
MN County - Cook South 6378647.541
MN County - Cottonwood 6378514.953
MN County - Crow Wing 6378546.957
MN County - Dakota 6378421.989
MN County - Dodge 6378481.425
MN County - Douglas 6378518.001
MN County - Faribault 6378521.049
MN County - Fillmore 6378464.661
MN County - Freeborn 6378521.049
MN County - Goodhue 6378434.181
MN County - Grant 6378518.001
MN County - Hennepin 6378418.941
MN County - Houston 6378436.619
MN County - Isanti 6378411.321
MN County - Itasca North 6378574.389
MN County - Itasca South 6378574.389
MN County - Jackson 6378521.049
MN County - Kanabec 6378472.281
MN County - Kandiyohi 6378498.189
MN County - Kittson 6378449.421
MN County - Koochiching 6378525.621
MN County - Lac Qui Parle 6378476.853
MN County - Lake of the Woods North 6378466.185
MN County - Lake of the Woods South 6378496.665
MN County - Le Sueur 6378434.181
MN County - Lincoln 6378643.579
MN County - Lyon 6378559.758
MN County - Mahnomen 6378586.581
MN County - Marshall 6378441.801
MN County - Martin 6378521.049
MN County - McLeod 6378414.369
MN County - Meeker 6378498.189

Built-in Ellipsoids 323

 Global Mapper User's Manual

MN County - Morrison 6378502.761

MN County - Mower 6378521.049
MN County - Murray 6378617.061
MN County - Nicollet 6378403.701
MN County - Nobles 6378624.681
MN County - Norman 6378468.623
MN County - Olmsted 6378481.425
MN County - Ottertail 6378525.621
MN County - Pennington 6378445.763
MN County - Pine 6378472.281
MN County - Pipestone 6378670.401
MN County - Polk 6378445.763
MN County - Pope 6378502.761
MN County - Ramsey 6378418.941
MN County - Red Lake 6378445.763
MN County - Redwood 6378438.753
MN County - Renville 6378414.369
MN County - Rice 6378434.181
MN County - Rock 6378624.681
MN County - Roseau 6378449.421
MN County - Scott 6378421.989
MN County - Sherburne 6378443.325
MN County - Sibley 6378414.369
MN County - St Louis Central 6378605.783
MN County - St Louis North 6378543.909
MN County - St Louis South 6378540.861
MN County - Stearns 6378502.761
MN County - Steele 6378481.425
MN County - Stevens 6378502.761
MN County - Swift 6378470.757
MN County - Todd 6378548.481
MN County - Traverse 6378463.746
MN County - Wabasha 6378426.561
MN County - Wadena 6378546.957
MN County - Waseca 6378481.425
MN County - Watonwan 6378514.953
MN County - Winona 6378453.688
MN County - Wright 6378443.325
MN County - Yellow Medicine 6378530.193
Mercury 1960 6378166.000
Modified Airy 6377340.189
Modified Everest 1948 6377304.063

Built-in Ellipsoids 324

 Global Mapper User's Manual

Modified Mercury 1968 6378150.000

South America 1969 6378160.000
Southeast Asia 6378155.000
Sphere Radius 6356752 m 6356752.314
Sphere Radius 6370997 m 6370997.000
Sphere Radius 6371000 m 6371000.000
Sphere Radius 6371007.181 m 6371007.181
Sphere Radius 6371204 m 6371204.000
Sphere Radius 6378137 m 6378137.000
Sphere Radius 6378388 m 6378388.000
WGS66 6378145.000
WGS72 6378135.000
WGS84 6378137.000
WI County - Burnett 6378414.960
WI County - Douglas 6378414.930
WI County - Sheboygan 6378285.480
War Office (McCaw 1924) 6378300.000

Built-in Ellipsoids 325