SYNOPSIS

DESCRIPTION

Description: ossim-img2rr Creates overviews and optionally a histogram for the passed in image.

OPTIONS

--compression-quality

Compression quality varies from 0 to 100, where 100 is best. Currently only for JPEG compression

--compression-type

Compression type can be: NONE, JPEG, PACKBITS, or DEFLATE

--create-histogram

Computes full histogram alongside overview.

--create-histogram-fast

Computes a histogram in fast mode which samples partial tiles.

--create-mask

Computes and writes out an alpha mask to a separate .mask file.

--disable-elev

Will disable the elevation

--disable-notify

Takes an argument. Arguments are ALL, WARN, NOTICE, INFO, FATAL, DEBUG. If you want multiple disables then just do multiple --disable-notify on the command line. All argument are case insensitive. Default is all are enabled.

--disable-plugin

Will disable the plugin loader

--histogram-bins

Number of histogram bins. This will override the default for scalar type. Also this will force a separate pass.

--histogram-max

Maximum histogram value to use. This will override the default for scalar type. Also this will force a separate pass.

--histogram-min

Minimum histogram value to use. This will override the default for scalar type. Also this will force a separate pass.

--histogram-r0

Forces create-histogram code to compute a histogram using r0 instead of the starting resolution for the overview. Requires a separate pass of R0 layer.

--list-entries

Lists the entries within the image

--mask-mode <mode>

Specifies how to treat multi-band imagery when determining whether pixel will be masked according to the defined target value or range. Possible modes are: "mask_full_and_partial_targets" (default) | "mask_only_full_targets".

--mask-range <min> <max>

Specifies the range of pixels to target for masking out.

--mask-value <target>

Specifies the unique pixel value to target for masking out.

--ossim-logfile

takes a logfile as an argument. All output messages are redirected to the specified log file. By default there is no log file and all messages are enabled.

--scanForMinMax

Turns on min, max scanning when reading tiles. This option assumes the null is known.

--scanForMinMaxNull

Turns on min, max, null scanning when reading tiles. This option tries to find a null value which is useful for float data.

--set-property

key:value NOTE: separate key value by a colon. Deprecated, use --writer-prop instead.

--tile-size

Defines the tile size for the supported overview handler.

--version

Outputs version information.

--writer-prop

Adds a property to send to the writer. format is name=value

-K

specify individual keywords to add to the preferences keyword list: name=value

-P

specify a preference file to load

-T

specify the classes to trace, ex: ossimInit|ossimImage.* will trace ossimInit and all ossimImage classes

-a or --include-fullres

Wants to include full res dataset as well as reduced res sets.

-d

Write overview to directory specified.

-e or --entry

Give the entry(zero based) to build an overview for.

-h or --help

Shows help

-o

Write overview to file specified. If used on a multi-entry file, given "foo.ovr" you willget: "foo_e0.ovr"

-r or --rebuild

Rebuild overviews even if they are already present.

-s

Stop dimension for overviews. This controls how many layers will be built. If set to 64 then the builder will stop when height and width for current level are less than or equal to 64. Note a default can be set in the ossim preferences file, setting the keyword "overview_stop_dimension".

-t or --type

see list at bottom for valid types. (default = ossim_tiff_box)

Valid overview types: ossim_tiff_box ossim_tiff_nearest

Example command building j2k overviews with a histogram removing/overwriting any existing overviews:

ossim-img2rr -r -t ossim_kakadu_nitf_j2k --create-histogram image.tif