1maketx(1)                         OpenImageIO                        maketx(1)
2
3
4

NAME

6       maketx -- convert images to tiled, MIP-mapped textures
7

SYNOPSIS

9       Usage: maketx [options] file...
10
11

DESCRIPTION

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

OPTIONS

18       --help Print help message
19
20       -v     Verbose status messages
21
22       -o FILENAME
23              Output filename
24
25       --threads NUMTHREADS
26              Number of threads (default: #cores)
27
28       -u     Update mode
29
30       --format FILEFORMAT
31              Specify output file format (default: guess from extension)
32
33       --nchannels N
34              Specify the number of output image channels.
35
36       --chnames CHANNELNAMES
37              Rename channels (comma-separated)
38
39       -d TYPE
40              Set  the  output  data  format  to one of: uint8, sint8, uint16,
41              sint16, half, float
42
43       --tile WIDTH HEIGHT
44              Specify tile size
45
46       --separate
47              Use planarconfig separate (default: contiguous)
48
49       --compression NAME
50              Set the compression method (default = zip, if possible)
51
52       --fovcot FOVCAT
53              Override the frame aspect ratio. Default is width/height.
54
55       --wrap WRAP
56              Specify wrap mode (black, clamp, periodic, mirror)
57
58       --swrap WRAP
59              Specific s wrap mode separately
60
61       --twrap WRAP
62              Specific t wrap mode separately
63
64       --resize
65              Resize textures to power of 2 (default: no)
66
67       --noresize
68              Do not resize textures to power of 2 (deprecated)
69
70       --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
76       --hicomp
77              Compress HDR range before resize, expand after.
78
79       --sharpen SHARPEN
80              Sharpen MIP levels (default = 0.0 = no)
81
82       --nomipmap
83              Do not make multiple MIP-map levels
84
85       --checknan
86              Check for NaN/Inf values (abort if found)
87
88       --fixnan STRATEGY
89              Attempt  to  fix  NaN/Inf  values  in  the image (options: none,
90              black, box3)
91
92       --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
99       --prman-metadata
100              Add prman specific metadata
101
102       --attrib NAME VALUE
103              Sets metadata attribute (name, value)
104
105       --sattrib NAME VALUE
106              Sets string metadata attribute (name, value)
107
108       --sansattrib
109              Write command line  into  Software  &  ImageHistory  but  remove
110              --sattrib and --attrib options
111
112       --constant-color-detect
113              Create 1-tile textures from constant color inputs
114
115       --monochrome-detect
116              Create 1-channel textures from monochrome inputs
117
118       --opaque-detect
119              Drop alpha channel that is always 1.0
120
121       --no-compute-average
122              Don't compute and store average color
123
124       --ignore-unassoc
125              Ignore unassociated alpha tags in input (don't autoconvert)
126
127       --runstats
128              Print runtime statistics
129
130       --mipimage FILENAME
131              Specify an individual MIP level
132
133       Basic modes (default is plain texture):
134
135              --shadow
136                     Create shadow map
137
138              --envlatl
139                     Create lat/long environment map
140
141              --lightprobe
142                     Create lat/long environment map from a light probe
143
144              --bumpslopes
145                     Create a 6 channels bump-map with height, derivatives and
146                     square derivatives from an height or a normal map
147
148              --bumpformat NAME
149                     Specify the interpretation of a 3-channel input image for
150                     --bumpslopes: "height", "normal" or "auto" (default).
151
152       Color Management Options (OpenColorIO enabled)
153
154              --colorconfig FILENAME
155                     Explicitly specify an OCIO configuration file
156
157              --colorconvert IN OUT
158                     Apply  a color space conversion to the image. If the out‐
159                     put color space is not the same bit depth as input  color
160                     space,  it  is your responsibility to set the data format
161                     to the proper bit depth using the -d  option.   (choices:
162                     linear, default, rgb, RGB, sRGB, Rec709)
163
164              --unpremult
165                     Unpremultiply  before  color conversion, then premultiply
166                     after the color conversion.  You'll probably want to  use
167                     this flag if your image contains an alpha channel.
168
169       Configuration Presets
170
171              --prman
172                     Use  PRMan-safe settings for tile size, planarconfig, and
173                     metadata.
174
175              --oiio Use OIIO-optimized settings for tile size,  planarconfig,
176                     metadata.
177
178
179
180                                  02 May 2021                        maketx(1)