CLI INTERFACE
Brutal Engine can be run in standalone mode via the command line, ideal for render farms and batch processing.
General
--width <n>/--height <n>: Set render resolution.--spp <n>: Samples per pixel.--output <path>: Output image path (Supports .exr, .png, .jpg).--threads <n>: Force number of render threads (default: all cores).
Integrator
--rcvm: Use the Runtime Compiled Virtual Machine integrator (Recommended).--native: Use the native C++ Bidirectional Path Tracer (BDPT), bypassing RCVM.--denoise: Enable OIDN AI denoising.
Physical Lens Presets
Note: Realistic physical lens simulation is not possible if you
manually override the focal length (e.g., using --focal-mm).
Why? Physical lenses are simulated by tracing light through accurate glass geometry. Arbitrarily changing the focal length "breaks" the optical formula by artificially stretching the glass elements. This destroys the unique characteristics (swirly bokeh, aberrations, vignetting) that define the lens's look.
To change focal length validly, you must choose a different preset (e.g., switching from a 50mm prime to an 85mm prime).
Use the --lens <id> argument with one of the following presets:
| ID | Name / Description | Focal Lengths (mm) |
|---|---|---|
0001 |
Angenieux 100mm (1953) Double Gauss design, swirly bokeh. |
49, 55, 85, 105 |
0002 |
Meyer Optik Primoplan (1936) Classic 58mm/75mm design, strong optical vignetting. |
58, 75 |
0003 |
Petzval Portrait (1900) The original portrait lens. Sharp center, swirly edges. |
65, 75, 85, 100 |
0004 |
Nikon Retrofocus (1971) Wide angle design (f/2.8). |
28, 35 |
0005 |
Canon 14mm Wide angle (114° FOV). |
14 (Fixed), 22 |
0006 |
Kodak Petzval Heavy optical vignetting, emphasized swirly bokeh. |
58, 65, 75, 85, 105, 150 |
0007 |
Cooke Speed Panchro (Series O) The legendary Hollywood look (25mm f/2.0). |
18, 28, 40, 50, 75, 100 |
0008 |
Nikon 50mm f/1.25 Modern high-speed design. |
40, 50, 65 |
0009 |
Zeiss Biotar 100mm Double Gauss, similar to Helios 44-2 styles. |
45, 58, 65, 85 |
0010 |
Asahi Takumar Pentax variant based on the Zeiss Biotar. |
45, 50, 58, 65, 75, 85 |
0011 |
Asahi SMC Takumar f/2.0 Classic fast 35mm lens. |
28, 35, 50 |
0012 |
Asahi SMC Takumar 18mm Wide angle f/3.5. |
18 (Fixed) |
0013 |
Zeiss Flektagon 35mm Classic wide angle f/2.8. |
35 (Fixed) |
0014 |
Fisheye 6mm Extreme 181° field of view. |
6 (Fixed) |
0015 |
Minolta Fisheye 180° FOV, f/2.8. |
16, 22, 28 |
0016 |
Canon 35mm f/1.8 High speed wide angle (1956). |
35, 52 |
2001 |
Cooke Anamorphic (2x) 25mm with 2x squeeze. |
25 (Fixed) |
2002 |
Panavision Rear Anamorph 1.34x squeeze factor, rear element. |
N/A (Rear Element) |
2003 |
Panavision-Angenieux Combination of Rear Anamorph + Angenieux 100mm. |
100 (Fixed) |
2004 |
Schneider Anamorphic (2001) 31mm Anamorphic design. |
31 (Fixed) |
Camera & Optics
--dof/--no-dof: Enable/Disable Depth of Field.--fstop <f>: Set aperture f-number.--focus <dist>: Set focus distance in scene units.--blades <n>: Number of aperture blades.--cat-eye <val>: Optical vignetting intensity.--anamorphic <val>: Anamorphic squeeze factor.
Advanced
--ipc: Enable Shared Memory (SHM) mode. (Note: IPC socket mode is deprecated).--port <n>: Set IPC port (Legacy).--dump-aovs: Write all AOV layers to disk.--checkpoint <path>: Enable periodic render state saving.--resume <path>: Resume render from a checkpoint file.