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