This page provides information on the MakeTX utility and its usage.
Overview
MakeTX is a command-line utility that converts images to tiled, mip-mapped textures, e.g. a png or jpg image into a mip-mapped .tx file. Such optimizations make files in the .tx format faster to render, and also smaller as the files require less memory.
MakeTX is part of OpenImageIO and was developed by Larry Gritz at Sony Pictures Imageworks.
Usage
This is the same for ZIP builds.
- Go to the V-Ray install folder, e.g. C:\Program Files\Chaos\V-Ray\Houdini_20.5.410
- Go to the /appsdk/bin folder.
- Open a Command Prompt / Terminal window and call maketx.exe.
A lot of options are available → for more info on those, see Arnold's MakeTX.
Flag | Description |
---|---|
--help | Print help message |
-v | Verbose status messages |
-o %s | Output filename |
--threads %d | Number of threads (default: #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 | Specify s wrap mode separately |
--twrap %s | Specify 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 (choices: box triangle gaussian catrom blackman-harris sinc lanczos3 radial-lanczos3 mitchell bspline, disk, default=box) |
--nomipmap | Do not make multiple MIP-map levels |
--checknan | Check for NaN/Inf values (abort if found). |
--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 (deprecated. hashes are always computed). |
--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 | |
--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 | |
--oiio | Use OIIO-optimized settings for tile size, planarconfig, metadata, and constant-color optimizations. |
--prman | Use PRMan-safe settings for tile size, planarconfig, and metadata. |