mtlx transform
mtlx transform
Convert, combine, or resize/reformat textures across one or more .mtlx / .mtlx.zip files (glob patterns accepted), writing --output. A directory --output batch-converts each input separately instead of combining.
Aliases: x
Usage
mtlx transform <inputs>... --output <output> [--verbose] [--dry-run] [--profile <profile>] [--max-image-size <max-image-size>] [--image-format <image-format>] [--image-quality <image-quality>] [--texture-library <texture-library>] [--format <format>]
| Argument | Type | Required | Description |
|---|---|---|---|
inputs | string | Yes | Variadic |
| Flag | Type | Required | Description |
|---|---|---|---|
--output | string | Yes | Output path; a .mtlx/.mtlx.zip path combines every input into one file, a directory converts each input separately (same basename, same format) into that directory; Aliases: o |
--verbose | boolean | No | Batch mode: print every file written instead of just a one-line summary; Default: false |
--dry-run | boolean | No | Transform and validate in memory, report planned files, and create no output; Default: false |
--profile | string | No | Apply a named texture preset (e.g. "web": webp-preferred, 2048px max, EXRs normalized to PIZ); only touches incompatible textures; Choices: web |
--max-image-size | number | No | Resize any texture whose longest edge exceeds this many pixels; overrides --profile |
--image-format | string | No | Comma-separated target formats (webp,png,jpg,avif,exr,hdr); overrides --profile. Each source converts to the target sharing its dynamic range: SDR sources use the first SDR target, HDR sources (exr/hdr) use the first HDR target. An HDR source with no HDR target requested is linearly clipped to SDR (no tone mapping). Append ": |
--image-quality | number | No | Quality for lossy image formats (webp/jpg/avif); Default: 95 |
--texture-library | string | No | Loose .mtlx output only: copy textures into this directory (relative to --output) instead of ./textures. Ignored for .mtlx.zip output, whose resources remain inside the archive.; Aliases: tl |
--format | string | No | Output format; Choices: text, json, yaml; Default: text |