--output | string | Yes | Image file to write; .png, .jpg, .webp or .avif picks the format. With several --view, an image path gets a contact sheet; any other path (or an existing directory, or one ending in /) gets . files; Aliases: o |
--format | string | No | Format of the files when --output is a directory (an image --output uses its extension); Choices: png, jpg, webp, avif; Default: png |
--view | string | No | Named views rendered in one browser session: plane, closeup, detail, grazing, sphere, totem, cube, or plane: for a head-on plane of that width (1 UV = 1 m); Variadic |
--geometry | string | No | Preview geometry; Aliases: g; Choices: totem, sphere, cube, plane; Default: totem |
--material | string | No | Material name (default: last material in the document); Aliases: m |
--background | string | No | Backdrop behind the model; none keeps the IBL lighting but leaves the PNG transparent; Aliases: b; Choices: none, environment; Default: none |
--size | number | No | Image width and height in pixels; Aliases: s; Default: 800 |
--ibl | string | No | Lighting: studio (generated neutral HDR room), bridge (outdoor, shows relief, green-yellow cast), sun (hard midday sun, strongest relief), overcast (soft medium daylight, near neutral), neutral (colorless grey studio, for judging albedo), strips (dark room with sharp softbox strips, for judging gloss and roughness breakup), dusk (warm, medium-dark street), night (very dark); Choices: studio, bridge, sun, overcast, neutral, strips, dusk, night; Default: studio |
--exposure | number | No | Exposure in stops (-2..2); Aliases: e; Default: 0 |
--zoom | number | No | Camera zoom factor for close-ups (1 = default framing); Aliases: z |
--elevation | number | No | Camera elevation in degrees (default 35; 0 = head-on to the plane) |
--center | string | No | UV point the plane view aims at, e.g. 0.25,0.7 |
--supersample | boolean | No | Render at 2x and downsample (smoother thin features); Default: false |
--channel | string | No | Show one nodegraph node unlit (floats grey, vectors as rgb) and print its value statistics |
--uv-scale | number | No | Multiply every texcoord by N, so the 1 m plane shows N × N m (layout checks over several meters) |
--grid | number | No | Overlay UV grid lines every N meters (with labels) on head-on plane views, e.g. 0.1 |
--crop | string | No | Crop x,y,size pixels of each view and enlarge it to --size (nearest neighbour) for pixel-level inspection |
--mirror | string | No | Print how symmetric each head-on plane view is about a UV line, e.g. u=0.15 or v=0.5 (book-match checks) |
--range | string | No | Value range mapped to black..white for --channel, e.g. -0.003,0.002 (default 0,1) |
--browser | string | No | Chromium-based browser executable (default: installed Chrome, Edge, or Playwright Chromium) |
--timeout | number | No | Seconds to wait for the material to compile and each view to render; Default: 60 |