Tx Manager

The 'Tx Manager' can be used to automate the process of converting Maya texture files and Ai Image files to .tx file format directly within Maya. It enables the conversion of textures from within the current scene or all of the textures within a folder (and its subfolders). You can also specify if you want to convert specific textures. More information about the use of .tx can be found on the maketx page. The Tx Manager can be accessed from both the Arnold menu and the MtoA shelf.


TX Manager window


A video that demonstrates how to use the Tx Manager can be found here.

Refresh

Searches the current scene for available textures and lists the texture paths in the Tx Manager window.

Select all

Selects all of the available texture files within the scene.

Select Untiled

Selects all textures that have not been processed as .tx files.

Select Missing

Selects all textures that have missing files.

Relink ...

Allows you to replace all selected textures by images found in a select a folder and its subfolders. This feature is the same as in the native Texture Manager's Relink function.

Options

Use Scene Textures

This shows the file textures that exist within the current Maya scene. 

  • hastx = original and tx exists.
  • missing = texture is missing or path is incorrect.
  • onlytx = only the .tx file is available.

Click the file pathname to view the texture in the Attribute Editor

Use Folder Textures

Uses the textures files that exist within the 'Textures Folder'.

Scene Options

Scene Options

Set options for finding textures in the current may scene

Scan attributes

A list of node types and attributes to scan for file texture paths

Add

Add a new node type and attribute to search for in the scene

Remove

remove the selected attribute from the list

TX Options

Enables you to add parameters to the conversion process. The default parameter uses the flags -u (update image) and --oiio (OpenImageIO).

Update

Only update .tx files if there is a new version of the input texture

Verbose

Show information on the conversion of the texture to .tx

Check NaNs

check for and warn for Nan values in the source texture

Print stats

print statistics on the output .tx file

Unpremult

unpremult the input texture before convertion

Threads

number of CPU threads to use for the converstion

Preset

choose a pre-defined preset of options, arnold always adds --oiio to the maketx options

Extra args

add any custom arguments that maketx accepts from the maketx options

 Available maketx options

flagdescription
--helpPrint help message
-vVerbose status messages
-o %sOutput filename
--threads %dNumber of threads (default: #cores)
-uUpdate mode
--format %sSpecify output file format (default: guess from extension)
--nchannels %dSpecify the number of output image channels.
-d %sSet the output data format to one of: uint8, sint8, uint16, sint16, half, float
--tile %d %dSpecify tile size
--separateUse planarconfig separate (default: contiguous)
--fov %fField of view for envcube/shadcube/twofish
--fovcot %fOverride the frame aspect ratio. Default is width/height.
--wrap %sSpecify wrap mode (black, clamp, periodic, mirror)
--swrap %sSpecifiy s wrap mode separately
--twrap %sSpecifiy t wrap mode separately
--resizeResize textures to power of 2 (default: no)
--noresizeDo not resize textures to power of 2 (deprecated)
--filter %sSelect filter for resizing (choices: box triangle gaussian catrom blackman-harris sinc lanczos3 radial-lanczos3 mitchell bspline, disk, default=box)
--nomipmap

Do not make multiple MIP-map levels 

--checknanCheck for NaN/Inf values (abort if found).
--Mcamera %f %f %f %f %f %f %f %f %f %f %f %f %f %f %f %fSet the camera matrix
--Mscreen %f %f %f %f %f %f %f %f %f %f %f %f %f %f %f %fSet the camera matrix
--hashEmbed SHA-1 hash of pixels in the header (deprecated. hashes are always computed).
--prman-metadataAdd prman specific metadata
--constant-color-detectCreate 1-tile textures from constant color inputs
--monochrome-detectCreate 1-channel textures from monochrome inputs
--opaque-detectDrop alpha channel that is always 1.0
--statsPrint runtime statistics
--mipimage %sSpecify an individual MIP level
Basic modes (default is plain texture) 
--shadowCreate shadow map
--envlatlCreate lat/long environment map
--envcubeCreate cubic env map (file order: px, nx, py, ny, pz, nz) (UNIMP)
Color Management Options 
--colorconvert %s %s
Apply a color space conversion to the image. If the output color space is not the same bit depth as input color space, it is your responsibility to set the data format to the proper bit depth using the -d option. (choices: linear, sRGB, Rec709)
--unpremult 
Unpremultiply before color conversion, then premultiply after the color conversion. You'll probably want to use this flag if your image contains an alpha channel.
Configuration Presets 
--oiioUse OIIO-optimized settings for tile size, planarconfig, metadata, and constant-color optimizations.
--prmanUse PRMan-safe settings for tile size, planarconfig, and metadata.

Preview

previews the currently selected arguments

Default Options (auto tx)

Check this to use the defaults via MtoA's auto-tx options

Actions

Create .tx for Selected

Starts the conversion of texture files to .tx file format. If cancelled, this process will finish after the current file has been processed.

Remove .tx for selected

Deletes any .tx texture files associated with the selected textures.

Processed textures (.tx) will only be used when the 'Use Existing .tx Textures' option is enabled under Textures in the MtoA render settings window.

Tx Manager supports the same file formats that maketx does:

 

BMP
Cineon
DDS
DPX
FITS
HDR/RGBE
ICO
IFF
JPEG
OpenEXR
PNG
PNM
PSD (flattened)
RLA
SGI
Softimage PIC
Targa
TIFF
Zfile
  • No labels