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 N
137 Store the forward and inverse Gaussian CDF as a lookup-table.
138 The variance is set by cdfsigma (1/6 by default), and the number
139 of buckets in the lookup table is determined by
140 cdfbits (8 bit - 256 buckets by default)
141 --cdfsigma N
143 Specify the Gaussian sigma parameter when writing the forward
144 and inverse Gaussian CDF data. The default vale is 1/6 (0.1667)
145 --cdfbits N
147 Specify the number of bits used to store the forward and inverse
148 Gaussian CDF. The default value is 8 bits
149 Basic modes (default is plain texture):
151 --shadow
153 Create shadow map
154 --envlatl
156 Create lat/long environment map
157 --lightprobe
159 Create lat/long environment map from a light probe
160 --bumpslopes
162 Create a 6 channels bump-map with height, derivatives and
163 square derivatives from an height or a normal map
164 --uvslopes_scale VALUE
166 If specified, compute derivatives for --bumpslopes in UV
167 space rather than in texel space and divide them by a
168 scale factor. 0=disable by default, only valid for height
169 maps.
170 --bumpformat NAME
172 Specify the interpretation of a 3-channel input image for
173 --bumpslopes: "height", "normal" or "auto" (default).
174 --handed STRING
176 Specify the handedness of a vector or normal map: "left",
177 "right", or "" (default).
178 Color Management Options (OpenColorIO enabled)
180 --colorconfig FILENAME
182 Explicitly specify an OCIO configuration file
183 --colorconvert IN OUT
185 Apply a color space conversion to the image. If the out‐
186 put color space is not the same bit depth as input color
187 space, it is your responsibility to set the data format
188 to the proper bit depth using the -d option. (choices:
189 NONE)
190 --unpremult
192 Unpremultiply before color conversion, then premultiply
193 after the color conversion. You'll probably want to use
194 this flag if your image contains an alpha channel.
195 Configuration Presets
197 --prman
199 Use PRMan-safe settings for tile size, planarconfig, and
200 metadata.
201 --oiio Use OIIO-optimized settings for tile size, planarconfig,
203 metadata.
204 12 January 2023 maketx(1)