Changes between Version 38 and Version 39 of Support/UserGuides/osgdem

Show
Ignore:
Timestamp:
05/14/09 20:02:59 (6 years ago)
Author:
XenonofArcticus (IP: 12.46.189.10)
Comment:

Break out commandline optinos to new page

Legend:

Unmodified
Added
Removed
Modified
  • Support/UserGuides/osgdem

    v38 v39  
    6666== Commandline options == 
    6767 
    68 ||'''Parameter''' || '''Description''' || '''Default''' 
    69 ||'''General''' 
    70 || -h or --help || Display commandline arguments information || ||  
    71 || --task || || ||  
    72 || -s <filename> || Specify a VPB source file containing all commandline options. || ||  
    73 || --so <filename> || Output the VPB source file for the current run. || ||  
    74 || --report || || ||  
    75 ||--cache <filename> || Read the cache file to use a look up for locally cached files. || || 
    76 || --version || Print out version || || || 
    77 || --version-number || Print out version number only. || || || 
    78 || --comment || Added a comment/description string to the top most node in the dataset || empty || 
    79 || --split || Set the distributed build split level. ||  ||  
    80 || --splits || Set the distributed build primary and secondary split levels. ||  ||  
    81 || --run-path || Set the path that the build should be run from. ||  ||  
    82 || --notify-level || Set the notify level when logging messages. ||  ||  
    83 ||'''Input''' || || || 
    84 || -d <filename> || Specify the digital elevation map input file to process ||  ||  
    85 || -t <filename> || Specify the texture map input file to process ||  ||  
    86 || --building <filename> || Specify building outlines using shapefiles. ||  ||  
    87 || --forest <filename> || Specify forest outlines using shapefiles ||  ||  
    88 || --levels <begin_level> <end_level> || Specify the range of levels that the next source Texture or DEM will contribute to. || ||  
    89 || --layer <layer_num> || Specify the layer that the next source Texture will contribute to.. ||  ||  
    90 ||''Coordinate system'' 
    91 || --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 ||  ||  
    92 || --wkt <WKT string> || Set the coordinates system of source imagery, DEM or destination database in !WellKownText form. || ||  
    93 || --wkt-file <WKT file> || Set the coordinates system of source imagery, DEM or destination database by as file containing !WellKownText definition. || ||  
    94 || ''Geocentric database'' || || || 
    95 || --geocentric || Build a database in geocentric (i.e. whole earth) database. ||  ||  
    96 || --bluemarble-east || Set the coordinates system for next texture or dem to represent the eastern hemisphere of the earth. || ||  
    97 || --bluemarble-west || Set the coordinates system for next texture or dem to represent the western hemisphere of the earth. || ||       
    98 || --whole-globe || Set the coordinates system for next texture or dem to represent the whole hemisphere of the earth. ||  ||  
    99 || ''Ellipsoid model'' || || || 
    100 || --radius-polar || Set the polar radius of the ellipsoid model when building a geocentric database. || 6356752.3142 ||  
    101 || --radius-equator || Set the equatorial radius of the ellipsoid model when building a geocentric database. || 6378137 ||  
    102 || --spherical || Set the polar and equatorial radius both to the average of the two. || ||  
    103 || ''Flat database'' || || ||  
    104 || --range <xMin> <xMax> <yMin> <yMax> ||  Set the coordinates system for next texture or dem to the given range. ||  ||  
    105 || --xx ||  ||       
    106 || --xt ||  ||       
    107 || --yy ||  ||       
    108 || --yt ||  ||       
    109 || --zz ||  ||       
    110 || --zt ||  ||  
    111 || || || || 
    112 || ''DataType'' 
    113 || --vector || Interpret input as a vector data set || ||   
    114 || --raster || Interpret input as a raster data set (default) || ||  
    115 || || || || 
    116 ||'''Output''' || || || 
    117 || --image-ext <ext> || Specify the Image format to output to via its plugin name, i.e. rgb, dds, jp2, jpeg. || .dds ||  
    118 || -o <outputfile> || Specify the output master file to generate ||  ||  
    119 || -a <archivename> || Specify the archive to place the generated database ||  ||  
    120 || --ibn <buildname> || Specify the intermediate build file name ||  ||  
    121 || -l <numOfLevels> || Specify the number of PagedLOD levels to generate || 30 
    122 || -e <x> <y> <w> <h> || Extents of the model to generate ||  ||  
    123 || --skirt-ratio <float> || Set the ratio of skirt height to tile size || 0.02 ||  
    124 || -v || Set the vertical multiplier || 1.0 ||  
    125 || --no-terrain-simplification || Switch off terrain simplification. || true ||  
    126 || --default-color <r,g,b,a> || Sets the default color of the terrain. || (0.5, 0.5, 1.0, 1.0) ||  
    127 || --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 || 
    128 || --max-anisotropy || Max anisotropy level to use when texturing || 1.0 ||  
    129 || ''GeometryType'' || || ||  
    130 || --HEIGHT_FIELD || Create a height field database || ||  
    131 || --POLYGONAL || Create a height field database (default) || ||  
    132 || --TERRAIN || Create a osgTerrain::Terrain database || ||  
    133 || || || || 
    134 || ''DatabaseType'' || || ||  
    135 || --LOD || Create a LOD'd database || ||  
    136 || --PagedLOD || Create a PagedLOD'd database (default) || ||  
    137 || || || || 
    138 || ''TextureType'' || || ||  
    139 || --compressed || Use OpenGL compression on RGB destination imagery (default) || ||  
    140 || --RGBA-compressed || Use OpenGL compression on RGBA destination imagery || ||  
    141 || --RGB-16 || Use 16bit RGB destination imagery || ||  
    142 || --RGBA-24 || Use 24bit RGB destination imagery || ||     
    143 || --RGB-16 || Use 16bit RGBA destination imagery || ||    
    144 || --RGBA || Use 32bit RGBA destination imagery || ||  
    145 || || || || 
    146 || ''MipMappingMode'' 
    147 || --no-mip-mapping || Disable mip mapping of textures ||  ||  
    148 || --mip-mapping-hardware || Use mip mapped textures, and generate the mipmaps in hardware when available. || ||  
    149 || --mip-mapping-imagery || Use mip mapped textures, and generate the mipmaps in imagery. (default) || ||  
    150 || || || 
    151 || --!BuildOverlays [True/False] || Switch on/off the building of overlay within the source imagery. Overlays can help reduce texture aliasing artifacts. || false ||  
    152 || --!ReprojectSources [True/False] || Switch on/off the reprojection of any source imagery that aren't in the correct projection for the database build. || true ||  
    153 || --!GenerateTiles [True/False] || Switch on/off the generation of the output database tiles. || true ||  
    154 || --tile-image-size || Set the tile maximum image size ||  256 || 
    155 || --tile-terrain-size || Set the tile maximum terrain size ||  64 || 
    156 || -O || string option to pass to write plugins, use "" for multiple options ||  ||  
    157 || --subtile <LOD> <X> <Y> || Set the subtile to begin the build from. ||  ||  
    158 || --record-subtile-on-leaf-tiles || Enable the setting of the subtile file name of the leaf tiles. || false ||  
    159 || --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 ||  
    160 || --height-attribute || Set the attribute name for height attributes used in shapefile/dbase files. || HGT ||  
    161 || --height || Set the height to use for associated shapefiles. (negative signifies that no height has been defined) || -1.0 ||  
    162 || --mask || Set the mask to assign indivual shapefile/model.  || 0xffffffff ||  
    163 || --terrain-mask || Set the overall mask to assign terrain. || 0xffffffff ||  
    164 || --read-threads-ratio <ratio> || Set the ratio number of read threads relative to number of cores to use. || 0.0 ||  
    165 || --write-threads-ratio <ratio> || Set the ratio number of write threads relative to number of cores to use. || 0.0 ||  
    166 || --build-options <string> || Set build options string. ||  ||  
    167 || ''DEM interpolation'' || || ||  
    168 || --interpolate-terrain || Enable the use of interpolation when sampling data from source DEMs. (default) ||  ||  
    169 || --no-interpolate-terrain || Disable the use of interpolation when sampling data from source DEMs. ||  ||  
    170 || ''Imagery interpolation'' || || ||  
    171 || --interpolate-imagery || Enable the use of interpolation when sampling data from source imagery. (default) ||  ||  
    172 || --no-interpolate-imagery || Disable the use of interpolation when sampling data from source imagery. ||  ||  
     68See [[http://www.openscenegraph.org/projects/VirtualPlanetBuilder/wiki/CommandLineOptions CommandLineOptions]] 
    17369 
    17470== Usage of VPB source file ==