DOKK / manpages / debian 11 / openimageio-tools / maketx.1.en
maketx(1) OpenImageIO maketx(1)

maketx -- convert images to tiled, MIP-mapped textures

Usage: maketx [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
Output filename
Number of threads (default: #cores)
Update mode
Specify output file format (default: guess from extension)
Specify the number of output image channels.
Rename channels (comma-separated)
Set the output data format to one of: uint8, sint8, uint16, sint16, half, float
Specify tile size
Use planarconfig separate (default: contiguous)
Set the compression method (default = zip, if possible)
Override the frame aspect ratio. Default is width/height.
Specify wrap mode (black, clamp, periodic, mirror)
Specific s wrap mode separately
Specific t wrap mode separately
Resize textures to power of 2 (default: no)
Do not resize textures to power of 2 (deprecated)
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)
Compress HDR range before resize, expand after.
Sharpen MIP levels (default = 0.0 = no)
Do not make multiple MIP-map levels
Check for NaN/Inf values (abort if found)
Attempt to fix NaN/Inf values in the image (options: none, black, box3)
Set the 'full' image range to be the pixel data window --Mcamera %f %f %f %f %f %f %f %f %f %f %f %f %f %f %f %f Set the camera matrix --Mscreen %f %f %f %f %f %f %f %f %f %f %f %f %f %f %f %f Set the screen matrix --MNDC %f %f %f %f %f %f %f %f %f %f %f %f %f %f %f %f Set the NDC matrix
Add prman specific metadata
Sets metadata attribute (name, value)
Sets string metadata attribute (name, value)
Write command line into Software & ImageHistory but remove --sattrib and --attrib options
Create 1-tile textures from constant color inputs
Create 1-channel textures from monochrome inputs
Drop alpha channel that is always 1.0
Don't compute and store average color
Ignore unassociated alpha tags in input (don't autoconvert)
Print runtime statistics
Specify an individual MIP level

Basic modes (default is plain texture):

Create shadow map
Create lat/long environment map
Create lat/long environment map from a light probe
Create a 6 channels bump-map with height, derivatives and square derivatives from an height or a normal map
Specify the interpretation of a 3-channel input image for --bumpslopes: "height", "normal" or "auto" (default).

Color Management Options (OpenColorIO enabled)

Explicitly specify an OCIO configuration file
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 -d option. (choices: linear, default, rgb, RGB, sRGB, Rec709)
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.

Configuration Presets

Use PRMan-safe settings for tile size, planarconfig, and metadata.
Use OIIO-optimized settings for tile size, planarconfig, metadata.
09 April 2023