imaketx [options] infile outfile
Options ¶
--help
/ -h
Display help for the command’s options.
--verbose
/ -v
Print progress messages as the command works.
--aov=name
/ -a name
Which image plane from the input file to use to create the texture. Default is C
(color).
--tile_width=w
/ -x w
The tile width to use for mipmapping. Default is 64
.
--tile_height=w
/ -y h
The tile height to use for mipmapping. Default is 64
.
--colormanagement=mode
/ -m mode
Specify the color management used to convert color spaces
-
ocio
- Uses OpenColorIO to transform color spaces -
builtin
- Uses a simple built-in color transform for sRGB images
--colorconvert from to
/ `-c from to
When using ocio
for color management, this option can be used to specify the source and destination color spaces when making the texture map. When this option isn’t specified, imaketx
will still perform color space conversion if the input file format is a three channel 8-bit image (unless the --linearize
option disables conversion). With ocio
, the default sRGB
color space will be converted to the scene_linear
color space.
--disableparse
When using ocio
for color management, imaketx
will normally see if the color space is encoded in the image filename using parseColorSpaceFromString()
. This option can be used to disables that behavior.
--format
Normally imaketx
will infer the texture format from the filename. This option explicitly sets the texture format (RAT, OpenEXR).
--linearize=mode
/ -l mode
Convert 8-bit sRGB images to linear space. Three channel 8-bit images are assumed to be in sRGB space, while single channel images are assumed to be in linear space. The possible values for mode
are
-
0 = Disable conversion from sRGB to linear space
-
1 = Force conversion
-
2 = Automatically detect (default)
--no-sanitize
--filter=name
/ -f name
The filter to use when down-scaling the image. Available options are:
-
box
-
gauss
-
sinc
-
bartlett
-
blackman
-
catrom
-
hanning
-
mitchell
--threads=n
/ -j n
Maximum number of threads to use. 0
means use all available cores. A negative n means use all cores except n (for example, on an 8-core CPU, specifying -j -3
would use 5 threads). Default is 0
.