osgdem/vpbmaster Command Line Options
Common Commandline options
| Parameter | Description | Default | |
| 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. |
osgdem-specific Commandline options
TODO
vpbmaster-specific Commandline options
TODO
