NAME¶
maketx - convert images to tiled, MIP-mapped textures
SYNOPSIS¶
maketx [
options]
files...
DESCRIPTION¶
The
maketx program will read an image (from any file format for which an
ImageInput plugin can be found) and then write it in a form in which it will
have high performance when used by TextureSystem. This involves converting it
to tiled (versus scanline) orientation, writing multiple subimages at
different resolutions (MIP-map), and setting a variety of header or metadata
fields appropriately for texture maps.
The maketx utility is invoked as follows:
maketx [
options]
input...
-o output
Where input and output name the input image and desired output filename. The
input files may be of any image format recognized by OpenImageIO (i.e., for
which ImageInput plugins are available). The file format of the output image
will be inferred from the file extension of the output filename (e.g.,
"foo.tif" will write a TIFF file).
For a complete description, see
/usr/share/doc/libopenimageio-dev/openimageio.pdf.gz.
OPTIONS¶
- --help
- Print help message
- -v
- Verbose status messages
- -o %s
- Output filename
- --threads %d
- Number of threads (default 0 == #cores)
- -u
- Update mode
- --format %s
- Specify output file format (default: guess from
extension)
- --nchannels %d
- Specify the number of output image channels.
- -d %s
- Set the output data format to one of:
uint8, sint8, uint16, sint16, half, float
- --tile %d %d
- Specify tile size
- --separate
- Use planarconfig separate (default: contiguous)
- --fov %f
- Field of view for envcube/shadcube/twofish
- --fovcot %f
- Override the frame aspect ratio. Default is
width/height.
- --wrap %s
- Specify wrap mode (black, clamp, periodic, mirror)
- --swrap %s
- Specific s wrap mode separately
- --twrap %s
- Specific t wrap mode separately
- --resize
- Resize textures to power of 2 (default: no)
- --noresize
- Do not resize textures to power of 2 (deprecated)
- --filter %s
- Select filter for resizing (default: box)
(choices: box triangle gaussian catrom blackman-harris sinc lanczos3
radial-lanczos3 mitchell bspline disk)
- --nomipmap
- Do not make multiple MIP-map levels
- --checknan
- Check for NaN/Inf values (abort if found)
- --fixnan %s
- Attempt to fix NaN/Inf values in the image (options: none,
black, box3)
- --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 camera matrix
- --hash
- Embed SHA-1 hash of pixels in the header
- --prman-metadata
- Add prman specific metadata
- --constant-color-detect
- Create 1-tile textures from constant color inputs
- --monochrome-detect
- Create 1-channel textures from monochrome inputs
- --opaque-detect
- Drop alpha channel that is always 1.0
- --stats
- Print runtime statistics
- --mipimage %s
- Specify an individual MIP level
Basic modes (default is plain texture):¶
- --shadow
- Create shadow map
- --envlatl
- Create lat/long environment map
- --envcube
- Create cubic env map (file order: px, nx, py, ny, pz, nz)
(UNIMP)
Color Management Options (OpenColorIO DISABLED)¶
- --colorconvert %s %s
- 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, sRGB, Rec709)
- --unpremult
- 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¶
- --prman
- Use PRMan-safe settings for tile size, planarconfig, and
metadata.
- --oiio
- Use OIIO-optimized settings for tile size, planarconfig,
metadata, and constant-color optimizations.
SEE ALSO¶
iconvert(1),
idiff(1),
igrep(1),
iinfo(1),
iprocess(1),
iv(1),
oiiotool(1).
AUTHOR¶
OpenImageIO was written by Larry Gritz and the other authors and contributors.
This manual page was written by IRIE Shinsuke <irieshinsuke@yahoo.co.jp>,
for the Debian project (and may be used by others).