.TH OCIOCONVERT "1" "August 2023" "ocioconvert -- apply colorspace transform to an image" "User Commands"
.SH NAME
ocioconvert \- apply colorspace transform to an image
.SH DESCRIPTION
ocioconvert \fB\-\-\fR apply colorspace transform to an image
.PP
usage: ocioconvert [options]  inputimage inputcolorspace outputimage outputcolorspace
.IP
or: ocioconvert [options] \fB\-\-lut\fR lutfile inputimage outputimage
or: ocioconvert [options] \fB\-\-view\fR inputimage inputcolorspace outputimage displayname viewname
.SH OPTIONS
.TP
\fB\-\-lut\fR
Convert using a LUT rather than a config file
.TP
\fB\-\-view\fR
Convert to a (display,view) pair rather than to an output color space
.TP
\fB\-\-gpu\fR
Use GPU color processing instead of CPU (CPU is the default)
.TP
\fB\-\-gpulegacy\fR
Use the legacy (i.e. baked) GPU color processing instead of the CPU one (\fB\-\-gpu\fR is ignored)
.TP
\fB\-\-gpuinfo\fR
Output the OCIO shader program
.TP
\fB\-\-help\fR
Print help message
.TP
\fB\-v\fR
Display general information
.SS "OpenImageIO options:"
.TP
\fB\-\-float\-attribute\fR %L
"name=float" pair defining OIIO float attribute for outputimage
.TP
\fB\-\-int\-attribute\fR %L
"name=int" pair defining OIIO int attribute for outputimage
.TP
\fB\-\-string\-attribute\fR %L
"name=string" pair defining OIIO string attribute for outputimage
.TP
\fB\-\-croptofull\fR
Crop or pad to make pixel data region match the "full" region
.TP
\fB\-\-ch\fR %s
Select channels (e.g., "2,3,4")