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  mitchell  bspline  disk  cubic  keys   simon   rifman,
71              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
140Color Management Options (OpenColorIO enabled)
141
142       --colorconfig %s
143              Explicitly specify an OCIO configuration file
144
145       --colorconvert %s %s
146              Apply a color space conversion to the image. If the output color
147              space is not the same bit depth as input color space, it is your
148              responsibility to set the data format to the  proper  bit  depth
149              using the -d option.  (choices: linear, sRGB, Rec709)
150
151       --unpremult
152              Unpremultiply  before  color  conversion, then premultiply after
153              the color conversion.  You'll probably want to use this flag  if
154              your image contains an alpha channel.
155
156Configuration Presets
157
158       --prman
159              Use  PRMan-safe  settings for tile size, planarconfig, and meta‐
160              data.
161
162       --oiio Use OIIO-optimized settings for tile size,  planarconfig,  meta‐
163              data.
164
165
166
167                               02 November 2018                      maketx(1)