.\"                                      Hey, EMACS: -*- nroff -*-
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH IINFO 1 "Dec 11, 2012"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh        disable hyphenation
.\" .hy        enable hyphenation
.\" .ad l      left justify
.\" .ad b      justify to both left and right margins
.\" .nf        disable filling
.\" .fi        enable filling
.\" .br        insert line break
.\" .sp <n>    insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH NAME
iinfo \- print information about images
.SH SYNOPSIS
.B iinfo
.RI [ options ] " files" ...
.SH DESCRIPTION
.\" TeX users may be more comfortable with the \fB<whatever>\fP and
.\" \fI<whatever>\fP escape sequences to invode bold face and italics,
.\" respectively.
The \fBiinfo\fP utility is invoked as follows:

.B iinfo
.RI [ options ] " filename" ...

Where filename (and any following strings) names the image file(s)
whose information should be printed. The image files may be of any
format recognized by OpenImageIO (i.e., for which ImageInput plugins
are available).
.PP
In its most basic usage, it simply prints the resolution, number of
channels, pixel data type, and file format type of each of the files
listed:

.nf
$ iinfo img_6019m.jpg grid.tif lenna.png
img_6019m.jpg : 1024 x  683, 3 channel, uint8 jpeg
grid.tif      :  512 x  512, 3 channel, uint8 tiff
lenna.png     :  120 x  120, 4 channel, uint8 png
.fi
.PP
For a complete description, see
.IR /usr/share/doc/openimageio-doc/openimageio.pdf.gz .
.SH OPTIONS
.TP
.B \-\-help
Print help message
.TP
.B \-v
Verbose output
.TP
.BI \-m\  %s
Metadata names to print (default: all)
.TP
.B \-f
Prefix each line with the filename
.TP
.B \-s
Sum the image sizes
.TP
.B \-a
Print info about all subimages
.TP
.B \-\-hash
Print SHA-1 hash of pixel values
.TP
.B \-\-stats
Print image pixel statistics (data window)
.SH SEE ALSO
.BR iconvert (1),
.BR idiff (1),
.BR igrep (1),
.BR iv (1),
.BR maketx (1),
.BR oiiotool (1).
.SH AUTHOR
OpenImageIO was written by Larry Gritz and the other authors and contributors.
.PP
This manual page was written by IRIE Shinsuke <irieshinsuke@yahoo.co.jp>,
for the Debian project (and may be used by others).