.\" Text automatically generated by txt2man
.TH iconvert 1 "13 April 2024" "" "OpenImageIO"
.SH NAME
\fBiconvert -- copy images with format conversions and other alterations
\fB
.SH SYNOPSIS
.nf
.fam C
Usage:  \fIiconvert\fP [\fIoptions\fP] \fIinputfile\fP \fIoutputfile\fP
 or:  \fIiconvert\fP \fB--inplace\fP [\fIoptions\fP] file\.\.\.

  %*
.fam T
.fi
.fam T
.fi
.SH DESCRIPTION
This program is part of the OpenImageIO (http://www.openimageio.org) tool suite.
Detailed documentation is available in pdf format with the OpenImageIO
distribution.
.SH OPTIONS
.TP
.B
\fB--help\fP
Print help message
.TP
.B
\fB-v\fP
Verbose status messages
.TP
.B
\fB--threads\fP NTHREADS
Number of threads (default 0 = #cores)
.TP
.B
\fB-d\fP TYPE
Set the output data format to one of:uint8, sint8, uint10, uint12, uint16, sint16, half, float, double
.TP
.B
\fB-g\fP GAMMA
Set gamma correction (default = 1.0)
.TP
.B
\fB--tile\fP WIDTH HEIGHT
Output as a tiled image
.TP
.B
\fB--scanline\fP
Output as a scanline image
.TP
.B
\fB--compression\fP METHOD
Set the compression method (default = same as input). Note: may be in the form "name:quality"
\fB--quality\fP %d
.TP
.B
\fB--no-copy-image\fP
Do not use ImageOutput copy_image functionality (dbg)
.TP
.B
\fB--adjust-time\fP
Adjust file times to match DateTime metadata
.TP
.B
\fB--caption\fP TEXT
Set caption (ImageDescription)
.TP
.B
\fB--keyword\fP NAME
Add a keyword
.TP
.B
\fB--clear-keywords\fP
Clear keywords
.TP
.B
\fB--attrib\fP NAME VALUE
Set a string attribute
.TP
.B
\fB--orientation\fP ORIENT
Set the orientation
.TP
.B
\fB--rotcw\fP
Rotate 90 deg clockwise
.TP
.B
\fB--rotccw\fP
Rotate 90 deg counter-clockwise
.TP
.B
\fB--rot180\fP
Rotate 180 deg
.TP
.B
\fB--inplace\fP
Do operations in place on images
.TP
.B
\fB--sRGB\fP
This file is in sRGB color space
.TP
.B
\fB--separate\fP
Force planarconfig separate
.TP
.B
\fB--contig\fP
Force planarconfig contig
.TP
.B
\fB--no-clobber\fP
Do not overwrite existing files