.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.46.4.
.TH OSSIM-IMG2RR "1" "December 2015" "ossim-img2rr 1.8.20" "User Commands"
.SH NAME
ossim-img2rr \- ossim-img2rr
.SH SYNOPSIS
.B ossim-img2rr
[\fI\,options\/\fR] \fI\,<input file>\/\fR
.SH DESCRIPTION
MPI running with 1 processors...
.PP
Description:
ossim\-img2rr Creates overviews and optionally a histogram for the passed in image.
.SH OPTIONS
.TP
\fB\-\-compression\-quality\fR
Compression quality varies from 0 to 100, where 100
is best.  Currently only for JPEG compression
.TP
\fB\-\-compression\-type\fR
Compression type can be: NONE, JPEG, PACKBITS, or
DEFLATE
.TP
\fB\-\-create\-histogram\fR
Computes full histogram alongside overview.
.TP
\fB\-\-create\-histogram\-fast\fR
Computes a histogram in fast mode which samples
partial tiles.
.TP
\fB\-\-create\-mask\fR
Computes and writes out an alpha mask to a separate
\&.mask file.
.TP
\fB\-\-disable\-elev\fR
Will disable the elevation
.TP
\fB\-\-disable\-notify\fR
Takes an argument. Arguments are ALL, WARN, NOTICE,
INFO, FATAL, DEBUG.  If you want multiple disables
then just do multiple \fB\-\-disable\-notify\fR on the
command line.  All argument are case insensitive.
Default is all are enabled.
.TP
\fB\-\-disable\-plugin\fR
Will disable the plugin loader
.TP
\fB\-\-histogram\-bins\fR
Number of histogram bins.   This will override the
default for scalar type.  Also this will force a
separate pass.
.TP
\fB\-\-histogram\-max\fR
Maximum histogram value to use.  This will override
the default for scalar type.  Also this will force a
separate pass.
.TP
\fB\-\-histogram\-min\fR
Minimum histogram value to use.  This will override
the default for scalar type.  Also this will force a
separate pass.
.TP
\fB\-\-histogram\-r0\fR
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.
.TP
\fB\-\-list\-entries\fR
Lists the entries within the image
.TP
\fB\-\-mask\-mode\fR <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".
.TP
\fB\-\-mask\-range\fR <min> <max>
Specifies the range of pixels to target for masking
out.
.TP
\fB\-\-mask\-value\fR <target>
Specifies the unique pixel value to target for
masking out.
.TP
\fB\-\-ossim\-logfile\fR
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.
.TP
\fB\-\-scanForMinMax\fR
Turns on min, max scanning when reading tiles.  This
option assumes the null is known.
.TP
\fB\-\-scanForMinMaxNull\fR
Turns on min, max, null scanning when reading tiles.
This option tries to find a null value which is
useful for float data.
.TP
\fB\-\-set\-property\fR
key:value NOTE: separate key value by a colon.
Deprecated, use \fB\-\-writer\-prop\fR instead.
.TP
\fB\-\-tile\-size\fR
Defines the tile size for the supported overview
handler.
.TP
\fB\-\-version\fR
Outputs version information.
.TP
\fB\-\-writer\-prop\fR
Adds a property to send to the writer. format is
name=value
.TP
\fB\-K\fR
specify individual keywords to add to the
preferences keyword list: name=value
.TP
\fB\-P\fR
specify a preference file to load
.TP
\fB\-T\fR
specify the classes to trace, ex:
ossimInit|ossimImage.*
will trace ossimInit and all ossimImage classes
.TP
\fB\-a\fR or \fB\-\-include\-fullres\fR
Wants to include full res dataset as well as reduced
res sets.
.TP
\fB\-d\fR
Write overview to directory specified.
.TP
\fB\-e\fR or \fB\-\-entry\fR
Give the entry(zero based) to build an overview for.
.TP
\fB\-h\fR or \fB\-\-help\fR
Shows help
.TP
\fB\-o\fR
Write overview to file specified.  If used on a
multi\-entry file, given "foo.ovr" you willget:
"foo_e0.ovr"
.TP
\fB\-r\fR or \fB\-\-rebuild\fR
Rebuild overviews even if they are already present.
.TP
\fB\-s\fR
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".
.TP
\fB\-t\fR or \fB\-\-type\fR
see list at bottom for valid types. (default =
ossim_tiff_box)
.PP
Valid overview types:
ossim_tiff_box  
ossim_tiff_nearest      
.PP
Example command building j2k overviews with a histogram removing/overwriting
any existing overviews:
.PP
ossim\-img2rr \fB\-r\fR \fB\-t\fR ossim_kakadu_nitf_j2k \fB\-\-create\-histogram\fR image.tif
.SH "SEE ALSO"
The full documentation for
.B ossim-img2rr
is maintained as a Texinfo manual.  If the
.B info
and
.B ossim-img2rr
programs are properly installed at your site, the command
.IP
.B info ossim-img2rr
.PP
should give you access to the complete manual.