General

-h or --help

Display commandline arguments information

--task

-s <filename>

Specify a VPB source file containing all commandline options.

--so <filename>

Output the VPB source file for the current run.

--report

--cache <filename>

Read the cache file to use a look up for locally cached files.

--version

Print out version

--version-number

Print out version number only.

--comment

Added a comment/description string to the top most node in the dataset

empty

--split

Set the distributed build split level.

--splits

Set the distributed build primary and secondary split levels.

--run-path

Set the path that the build should be run from.

--notify-level

Set the notify level when logging messages.

Input

-d <filename>

Specify the digital elevation map input file to process

-t <filename>

Specify the texture map input file to process

--building <filename>

Specify building outlines using shapefiles.

--forest <filename>

Specify forest outlines using shapefiles

--levels <begin_level> <end_level>

Specify the range of levels that the next source Texture or DEM will contribute to.

--layer <layer_num>

Specify the layer that the next source Texture will contribute to..

Coordinate system

--cs <coordinates system string>

Set the coordinates system of source imagery, DEM or destination database. The string may be any of the usual GDAL/OGR forms, complete WKT, PROJ.4, EPS

--wkt <WKT string>

Set the coordinates system of source imagery, DEM or destination database in WellKownText form.

--wkt-file <WKT file>

Set the coordinates system of source imagery, DEM or destination database by as file containing WellKownText definition.

Geocentric database

--geocentric

Build a database in geocentric (i.e. whole earth) database.

--bluemarble-east

Set the coordinates system for next texture or dem to represent the eastern hemisphere of the earth.

--bluemarble-west

Set the coordinates system for next texture or dem to represent the western hemisphere of the earth.

--whole-globe

Set the coordinates system for next texture or dem to represent the whole hemisphere of the earth.

Ellipsoid model

--radius-polar

Set the polar radius of the ellipsoid model when building a geocentric database.

6356752.3142

--radius-equator

Set the equatorial radius of the ellipsoid model when building a geocentric database.

6378137

--spherical

Set the polar and equatorial radius both to the average of the two.

Flat database

--range <xMin> <xMax> <yMin> <yMax>

Set the coordinates system for next texture or dem to the given range.

--xx

--xt

--yy

--yt

--zz

--zt

DataType

--vector

Interpret input as a vector data set

--raster

Interpret input as a raster data set (default)

Output

--image-ext <ext>

Specify the Image format to output to via its plugin name, i.e. rgb, dds, jp2, jpeg.

.dds

-o <outputfile>

Specify the output master file to generate

-a <archivename>

Specify the archive to place the generated database

--ibn <buildname>

Specify the intermediate build file name

-l <numOfLevels>

Specify the number of PagedLOD levels to generate

30

-e <x> <y> <w> <h>

Extents of the model to generate

-ge <x> <y> <w> <h>

Geographic (Lat/Lon) Extents of the model to generate.

-b <xa> <ya> <xb> <yb>

Bounds (similar to extents) of the model to generate. Max/Min order is not important.

-gb <xa> <ya> <xb> <yb>

Geographic Bounds (similar to extents) of the model to generate. Max/Min order is not important.

--skirt-ratio <float>

Set the ratio of skirt height to tile size

0.02

-v

Set the vertical multiplier

1.0

--no-terrain-simplification

Switch off terrain simplification.

true

--default-color <r,g,b,a>

Sets the default color of the terrain.

(0.5, 0.5, 1.0, 1.0)

--radius-to-max-visible-distance-ratio

Set the maximum visible distance ratio for all tiles apart from the top most tile. The maximum visible distance is computed from the ratio * tile radius.

7.0

--max-anisotropy

Max anisotropy level to use when texturing

1.0

GeometryType?

--HEIGHT_FIELD

Create a height field database

--POLYGONAL

Create a height field database (default)

--TERRAIN

Create a osgTerrain::Terrain database

DatabaseType?

--LOD

Create a LOD'd database

--PagedLOD

Create a PagedLOD'd database (default)

TextureType

--compressed

Use OpenGL compression on RGB destination imagery (default)

--RGBA-compressed

Use OpenGL compression on RGBA destination imagery

--RGB-16

Use 16bit RGB destination imagery

--RGB-24

Use 24bit RGB destination imagery

--RGBA-16

Use 16bit RGBA destination imagery

--RGBA

Use 32bit RGBA destination imagery

MipMappingMode

--no-mip-mapping

Disable mip mapping of textures

--mip-mapping-hardware

Use mip mapped textures, and generate the mipmaps in hardware when available.

--mip-mapping-imagery

Use mip mapped textures, and generate the mipmaps in imagery. (default)

--BuildOverlays [True/False]

Switch on/off the building of overlay within the source imagery. Overlays can help reduce texture aliasing artifacts.

false

--ReprojectSources [True/False]

Switch on/off the reprojection of any source imagery that aren't in the correct projection for the database build.

true

--GenerateTiles [True/False]

Switch on/off the generation of the output database tiles.

true

--tile-image-size

Set the tile maximum image size

256

--tile-terrain-size

Set the tile maximum terrain size

64

-O

string option to pass to write plugins, use "" for multiple options

--subtile <LOD> <X> <Y>

Set the subtile to begin the build from.

--record-subtile-on-leaf-tiles

Enable the setting of the subtile file name of the leaf tiles.

false

--type-attribute

Set the type name which specify how the shapes should be interpreted in shapefile/dbase files. (empty signifies no type attribute has been defined)

NAME

--height-attribute

Set the attribute name for height attributes used in shapefile/dbase files.

HGT

--height

Set the height to use for associated shapefiles. (negative signifies that no height has been defined)

-1.0

--mask

Set the mask to assign indivual shapefile/model.

0xffffffff

--terrain-mask

Set the overall mask to assign terrain.

0xffffffff

--read-threads-ratio <ratio>

Set the ratio number of read threads relative to number of cores to use.

0.0

--write-threads-ratio <ratio>

Set the ratio number of write threads relative to number of cores to use.

0.0

--build-options <string>

Set build options string.

DEM interpolation

--interpolate-terrain

Enable the use of interpolation when sampling data from source DEMs. (default)

--no-interpolate-terrain

Disable the use of interpolation when sampling data from source DEMs.

Imagery interpolation

--interpolate-imagery

Enable the use of interpolation when sampling data from source imagery. (default)

--no-interpolate-imagery

Disable the use of interpolation when sampling data from source imagery.