Your company here ā€” click to reach over 10,000 unique daily visitors

iconvert - Man Page

copy images with format conversions and other alterations


Usage:  iconvert [options] inputfile outputfile
 or:  iconvert --inplace [options] file...



This program is part of the OpenImageIO (http://www.openimageio.org) tool suite. Detailed documentation is available in pdf format with the OpenImageIO distribution.



Print help message


Verbose status messages

--threads NTHREADS

Number of threads (default 0 = #cores)


Set the output data format to one of:uint8, sint8, uint10, uint12, uint16, sint16, half, float, double


Set gamma correction (default = 1.0)


Output as a tiled image


Output as a scanline image

--compression METHOD

Set the compression method (default = same as input). Note: may be in the form "name:quality" --quality %d


Do not use ImageOutput copy_image functionality (dbg)


Adjust file times to match DateTime metadata

--caption TEXT

Set caption (ImageDescription)

--keyword NAME

Add a keyword


Clear keywords

--attrib NAME VALUE

Set a string attribute

--orientation ORIENT

Set the orientation


Rotate 90 deg clockwise


Rotate 90 deg counter-clockwise


Rotate 180 deg


Do operations in place on images


This file is in sRGB color space


Force planarconfig separate


Force planarconfig contig


Do not overwrite existing files


02 July 2024 OpenImageIO