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).
--newer
Only create the texture if the source image has a more recent timestamp than the existing texture.
--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
Normally, imaketx
will sanitize floating point input images, checking for NAN (not a number) or infinite values. This option disables the sanitization process.
--no-color-metadata
Normally, imaketx
will store metadata describing the color space for the image in both .exr and .rat files. This option will disable the storing of color space information.
--mode
‹mode›, --smode
‹smode›, --tmode
‹tmode›
Store the default wrapping modes for the s
and t
directions as metadata in the texture. If the --mode
option is used, the value will be used for both s
and t
directions.
Valid values for the ‹mode› argument are: black
, periodic
, clamp
or mirror
.
It’s possible for texture evaluation to override these default values. If the wrapping mode isn’t specified, its up to the renderer to choose a default.
--filter=‹name›
/ -f ‹name›
The filter to use when down-scaling the image. Available options are:
-
box
-
gauss
-
sinc
-
bartlett
-
blackman
-
catrom
-
hanning
-
mitchell
--exrmode ‹mode›
-1
Use HOUDINI_OIIO_EXR
variable.
0
Use classic driver.
1
Use improved driver.
--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
.