.\" Text automatically generated by txt2man
.TH maketx 1 "13 April 2024" "" "OpenImageIO"
.SH NAME
\fBmaketx -- convert images to tiled, MIP-mapped textures
\fB
.SH SYNOPSIS
.nf
.fam C

Usage: \fImaketx\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--version\fP
Print version and exit
.TP
.B
\fB-v\fP
Verbose status messages
.TP
.B
\fB-o\fP FILENAME
Output filename
.TP
.B
\fB--threads\fP NUMTHREADS
Number of threads (default: #cores)
.TP
.B
\fB-u\fP
Update mode
.TP
.B
\fB--format\fP FILEFORMAT
Specify output file format (default: guess from extension)
.TP
.B
\fB--nchannels\fP N
Specify the number of output image channels.
.TP
.B
\fB--chnames\fP CHANNELNAMES
Rename channels (comma-separated)
.TP
.B
\fB-d\fP TYPE
Set the output data format to one of: uint8, sint8, uint16, sint16, half, float
.TP
.B
\fB--tile\fP WIDTH HEIGHT
Specify tile size
.TP
.B
\fB--separate\fP
Use planarconfig separate (default: contiguous)
.TP
.B
\fB--compression\fP NAME
Set the compression method (default = zip, if possible)
.TP
.B
\fB--fovcot\fP FOVCAT
Override the frame aspect ratio. Default is width/height.
.TP
.B
\fB--wrap\fP WRAP
Specify wrap mode (black, clamp, periodic, mirror)
.TP
.B
\fB--swrap\fP WRAP
Specific s wrap mode separately
.TP
.B
\fB--twrap\fP WRAP
Specific t wrap mode separately
.TP
.B
\fB--resize\fP
Resize textures to power of 2 (default: no)
.TP
.B
\fB--noresize\fP
Do not resize textures to power of 2 (deprecated)
.TP
.B
\fB--filter\fP FILTERNAME
Select filter for resizing (choices: box triangle gaussian sharp-gaussian catmull-rom blackman-harris sinc lanczos3 radial-lanczos3 nuke-lanczos6 mitchell bspline disk cubic keys simon rifman, default=box)
.TP
.B
\fB--hicomp\fP
Compress HDR range before resize, expand after.
.TP
.B
\fB--sharpen\fP SHARPEN
Sharpen MIP levels (default = 0.0 = no)
.TP
.B
\fB--nomipmap\fP
Do not make multiple MIP-map levels
.TP
.B
\fB--checknan\fP
Check for NaN/Inf values (abort if found)
.TP
.B
\fB--fixnan\fP STRATEGY
Attempt to fix NaN/Inf values in the image (\fIoptions\fP: none, black, box3)
.TP
.B
\fB--fullpixels\fP
Set the 'full' image range to be the pixel data window
\fB--Mcamera\fP %f %f %f %f %f %f %f %f %f %f %f %f %f %f %f %f
Set the camera matrix
\fB--Mscreen\fP %f %f %f %f %f %f %f %f %f %f %f %f %f %f %f %f
Set the screen matrix
\fB--MNDC\fP %f %f %f %f %f %f %f %f %f %f %f %f %f %f %f %f
Set the NDC matrix
.TP
.B
\fB--prman-metadata\fP
Add prman specific metadata
.TP
.B
\fB--attrib\fP NAME VALUE
Sets metadata attribute (name, value)
.TP
.B
\fB--sattrib\fP NAME VALUE
Sets string metadata attribute (name, value)
.TP
.B
\fB--sansattrib\fP
Write command line into Software & ImageHistory but remove \fB--sattrib\fP and \fB--attrib\fP \fIoptions\fP
.TP
.B
\fB--constant-color-detect\fP
Create 1-tile textures from constant color inputs
.TP
.B
\fB--monochrome-detect\fP
Create 1-channel textures from monochrome inputs
.TP
.B
\fB--opaque-detect\fP
Drop alpha channel that is always 1.0
.TP
.B
\fB--no-compute-average\fP
Don't compute and store average color
.TP
.B
\fB--ignore-unassoc\fP
Ignore unassociated alpha tags in input (don't autoconvert)
.TP
.B
\fB--runstats\fP
Print runtime statistics
.TP
.B
\fB--mipimage\fP FILENAME
Specify an individual MIP level
.TP
.B
\fB--cdf\fP
Store the forward and inverse Gaussian CDF as a lookup-table. The variance is set by cdfsigma (1/6 by default), and the number of buckets               in the lookup table is determined by cdfbits (8 bit - 256 buckets by default)
.TP
.B
\fB--cdfsigma\fP N
Specify the Gaussian sigma parameter when writing the forward and inverse Gaussian CDF data. The default vale is 1/6 (0.1667)
.TP
.B
\fB--cdfbits\fP N
Specify the number of bits used to store the forward and inverse Gaussian CDF. The default value is 8 bits
.RE
.PP
Basic modes (default is plain texture):
.RS
.TP
.B
\fB--shadow\fP
Create shadow map
.TP
.B
\fB--envlatl\fP
Create lat/long environment map
.TP
.B
\fB--lightprobe\fP
Create lat/long environment map from a light probe
.TP
.B
\fB--bumpslopes\fP
Create a 6 channels bump-map with height, derivatives and square derivatives from an height or a normal map
.TP
.B
\fB--uvslopes_scale\fP VALUE
If specified, compute derivatives for \fB--bumpslopes\fP in UV space rather than in texel space and divide them by a scale factor. 0=disable by default, only valid for height maps.
.TP
.B
\fB--bumpformat\fP NAME
Specify the interpretation of a 3-channel input image for \fB--bumpslopes\fP: "height", "normal" or "auto" (default).
.TP
.B
\fB--handed\fP STRING
Specify the handedness of a vector or normal map: "left", "right", or "" (default).
.RE
.PP
Color Management Options (OpenColorIO enabled)
.RS
.TP
.B
\fB--colorconfig\fP FILENAME
Explicitly specify an OCIO configuration file
.TP
.B
\fB--colorconvert\fP IN OUT
Apply a color space conversion to the image. If the output color space is not the same bit depth as input color space, it is your responsibility to set the data format to the proper bit depth using the \fB-d\fP option.  (choices: NONE)
.TP
.B
\fB--unpremult\fP
Unpremultiply before color conversion, then premultiply after the color conversion.  You'll probably want to use this flag if your image contains an alpha channel.
.RE
.PP
Configuration Presets
.RS
.TP
.B
\fB--prman\fP
Use PRMan-safe settings for tile size, planarconfig, and metadata.
.TP
.B
\fB--oiio\fP
Use OIIO-optimized settings for tile size, planarconfig, metadata.