16.29. image2qtree¶
image2qtree
turns a georeferenced image (or images) into a quadtree
with geographical metadata. For example, it can output a kml file for
viewing in Google Earth.
Command-line options for image2qtree:
- --help
Display a help message.
- -o, --output-name <directory-name>
Specify the base output directory.
- -q, --quiet
Quiet output.
- -v, --verbose
Verbose output.
- --cache <number-of-MB (default: 1024)>
Cache size, in megabytes.
- --force-wgs84
Use WGS84 as the input images’ geographic coordinate systems, even if they’re not (old behavior).
- --pixel-scale <factor (default: 1)>
Scale factor to apply to pixels.
- --pixel-offset <offset (default: 0)>
Offset to apply to pixels.
- --normalize
Normalize input images so that their full dynamic range falls in between [0,255].
- -m, --output-metadata <kmltms|uniview|gmap|celestia|none (default: none)>
Specify the output metadata type.
- --file-type <type (default: png)>
Output file type.
- --channel-type <uint8|uint16|int16|float (default: uint8)>
Output (and input) channel type.
- --module-name <name (default: marsds)>
The module where the output will be placed. Ex: marsds for Uniview, or Sol/Mars for Celestia.
- --terrain
Outputs image files suitable for a Uniview terrain view. Implies output format as PNG, channel type uint16. Uniview only.
- --jpeg-quality <factor (default: 0.75)>
JPEG quality factor (0.0 to 1.0).
- --png-compression <level (default: 3)>
PNG compression level (0 to 9).
- --palette-file <filename>
Apply a palette from the given file.
- --palette-scale <factor>
Apply a scale factor before applying the palette.
- --palette-offset <value>
Apply an offset before applying the palette.
- --tile-size <number-of-pixels (default: 256)>
Tile size, in pixels.
- --max-lod-pixels <number-of-pixels (default: 1024)>
Max LoD in pixels, or -1 for none (kml only).
- --draw-order-offset <value (default: 0)>
Offset for the
<drawOrder>
tag for this overlay (kml only).- --composite-multiband
Composite images using multi-band blending.
- --aspect-ratio <ratio (default: 1)>
Pixel aspect ratio (for polar overlays; should be a power of two).
- --north <latitude-in-degrees>
The northernmost latitude in degrees.
- --south <latitude-in-degrees>
The southernmost latitude in degrees.
- --east <longitude-in-degrees>
The easternmost longitude in degrees.
- --west <longitude-in-degrees>
The westernmost longitude in degrees.
- --sinusoidal
Assume a sinusoidal projection.
- --mercator
Assume a Mercator projection.
- --transverse-mercator
Assume a transverse Mercator projection.
- --orthographic
Assume an orthographic projection.
- --stereographic
Assume a stereographic projection.
- --lambert-azimuthal
Assume a Lambert azimuthal projection.
- --lambert-conformal-conic
Assume a Lambert Conformal Conic projection.
- --utm <zone>
Assume UTM projection with the given zone.
- --proj-lat <latitude>
The center of projection latitude (if applicable).
- --proj-lon <longitude>
The center of projection longitude (if applicable).
- --proj-scale <scale>
The projection scale (if applicable).
- --std-parallel1 <latitude>
Standard parallels for Lambert Conformal Conic projection.
- --std-parallel2 <latitude>
Standard parallels for Lambert Conformal Conic projection.
- --nudge-x <arg>
Nudge the image, in projected coordinates.
- --nudge-y <arg>
Nudge the image, in projected coordinates.