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

TITLE

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

SYNOPSIS

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

DESCRIPTION

12       This  program  is  part of the OpenImageIO (http://www.openimageio.org)
13       tool suite.  Detailed documentation is avaliable in pdf format with the
14       OpenImageIO distribution.
15

OPTIONS

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