1maketx(1) OpenImageIO maketx(1)
2
6 maketx -- convert images to tiled, MIP-mapped textures
7
9 Usage: maketx [options] file...
10
13 This program is part of the OpenImageIO (http://www.openimageio.org)
14 tool suite. Detailed documentation is available in pdf format with the
15 OpenImageIO distribution.
16
18 --help Print help message
19 -v Verbose status messages
21 -o FILENAME
23 Output filename
24 --threads NUMTHREADS
26 Number of threads (default: #cores)
27 -u Update mode
29 --format FILEFORMAT
31 Specify output file format (default: guess from extension)
32 --nchannels N
34 Specify the number of output image channels.
35 --chnames CHANNELNAMES
37 Rename channels (comma-separated)
38 -d TYPE
40 Set the output data format to one of: uint8, sint8, uint16,
41 sint16, half, float
42 --tile WIDTH HEIGHT
44 Specify tile size
45 --separate
47 Use planarconfig separate (default: contiguous)
48 --compression NAME
50 Set the compression method (default = zip, if possible)
51 --fovcot FOVCAT
53 Override the frame aspect ratio. Default is width/height.
54 --wrap WRAP
56 Specify wrap mode (black, clamp, periodic, mirror)
57 --swrap WRAP
59 Specific s wrap mode separately
60 --twrap WRAP
62 Specific t wrap mode separately
63 --resize
65 Resize textures to power of 2 (default: no)
66 --noresize
68 Do not resize textures to power of 2 (deprecated)
69 --filter FILTERNAME
71 Select filter for resizing (choices: box triangle gaussian
72 sharp-gaussian catmull-rom blackman-harris sinc lanczos3 radial-
73 lanczos3 nuke-lanczos6 mitchell bspline disk cubic keys simon
74 rifman, default=box)
75 --hicomp
77 Compress HDR range before resize, expand after.
78 --sharpen SHARPEN
80 Sharpen MIP levels (default = 0.0 = no)
81 --nomipmap
83 Do not make multiple MIP-map levels
84 --checknan
86 Check for NaN/Inf values (abort if found)
87 --fixnan STRATEGY
89 Attempt to fix NaN/Inf values in the image (options: none,
90 black, box3)
91 --fullpixels
93 Set the 'full' image range to be the pixel data window --Mcamera
94 %f %f %f %f %f %f %f %f %f %f %f %f %f %f %f %f Set the camera
95 matrix --Mscreen %f %f %f %f %f %f %f %f %f %f %f %f %f %f %f %f
96 Set the screen matrix --MNDC %f %f %f %f %f %f %f %f %f %f %f %f
97 %f %f %f %f Set the NDC matrix
98 --prman-metadata
100 Add prman specific metadata
101 --attrib NAME VALUE
103 Sets metadata attribute (name, value)
104 --sattrib NAME VALUE
106 Sets string metadata attribute (name, value)
107 --sansattrib
109 Write command line into Software & ImageHistory but remove
110 --sattrib and --attrib options
111 --constant-color-detect
113 Create 1-tile textures from constant color inputs
114 --monochrome-detect
116 Create 1-channel textures from monochrome inputs
117 --opaque-detect
119 Drop alpha channel that is always 1.0
120 --no-compute-average
122 Don't compute and store average color
123 --ignore-unassoc
125 Ignore unassociated alpha tags in input (don't autoconvert)
126 --runstats
128 Print runtime statistics
129 --mipimage FILENAME
131 Specify an individual MIP level
132 --cdf N
134 Store the forward and inverse Gaussian CDF as a lookup-table.
135 The variance is set by cdfsigma (1/6 by default), and the number
136 of buckets in the lookup table is determined by
137 cdfbits (8 bit - 256 buckets by default)
138 --cdfsigma N
140 Specify the Gaussian sigma parameter when writing the forward
141 and inverse Gaussian CDF data. The default vale is 1/6 (0.1667)
142 --cdfbits N
144 Specify the number of bits used to store the forward and inverse
145 Guassian CDF. The default value is 8 bits
146 Basic modes (default is plain texture):
148 --shadow
150 Create shadow map
151 --envlatl
153 Create lat/long environment map
154 --lightprobe
156 Create lat/long environment map from a light probe
157 --bumpslopes
159 Create a 6 channels bump-map with height, derivatives and
160 square derivatives from an height or a normal map
161 --uvslopes_scale VALUE
163 If specified, compute derivatives for --bumpslopes in UV
164 space rather than in texel space and divide them by a
165 scale factor. 0=disable by default, only valid for height
166 maps.
167 --bumpformat NAME
169 Specify the interpretation of a 3-channel input image for
170 --bumpslopes: "height", "normal" or "auto" (default).
171 Color Management Options (OpenColorIO enabled)
173 --colorconfig FILENAME
175 Explicitly specify an OCIO configuration file
176 --colorconvert IN OUT
178 Apply a color space conversion to the image. If the out‐
179 put color space is not the same bit depth as input color
180 space, it is your responsibility to set the data format
181 to the proper bit depth using the -d option. (choices:
182 NONE)
183 --unpremult
185 Unpremultiply before color conversion, then premultiply
186 after the color conversion. You'll probably want to use
187 this flag if your image contains an alpha channel.
188 Configuration Presets
190 --prman
192 Use PRMan-safe settings for tile size, planarconfig, and
193 metadata.
194 --oiio Use OIIO-optimized settings for tile size, planarconfig,
196 metadata.
197 02 July 2022 maketx(1)