cinematic_render
Transform simulation files into publication-quality 3D images with auto-framing, cinematic lighting, and adjustable rendering presets.
Instructions
Cinematic-quality rendering with auto-framing, 3-point lighting, SSAO, and PBR.
Produces publication/presentation-quality images with:
PCA-based auto-camera: analyzes object shape and picks optimal viewing angle
3-point cinematic lighting (key + fill + rim)
SSAO (Screen-Space Ambient Occlusion) for contact shadows
FXAA anti-aliasing
Gradient backgrounds
PBR material support (metallic/roughness)
Quality presets:
draft: 960x540, no post-processing (fast preview)
standard: 1920x1080, SSAO + FXAA
cinematic: 1920x1080, all effects + ground plane
ultra: 3840x2160, all effects + ground plane
publication: 2400x1800, clean lighting, white background
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| file_path | Yes | Path to simulation file | |
| field_name | No | Field to visualize (None for auto-detect) | |
| colormap | No | Color map preset (e.g., "Cool to Warm", "Viridis") | Cool to Warm |
| quality | No | Rendering quality preset | standard |
| lighting | No | Lighting preset (cinematic, dramatic, studio, publication, outdoor, None) | cinematic |
| background | No | Background preset (dark_gradient, light_gradient, blue_gradient, publication, None) | dark_gradient |
| azimuth | No | Camera azimuth in degrees (None for auto from shape analysis) | |
| elevation | No | Camera elevation in degrees (None for auto from shape analysis) | |
| fill_ratio | No | How much of viewport the object fills (0.0-1.0, default 0.75) | |
| metallic | No | PBR metallic factor (0.0-1.0) | |
| roughness | No | PBR roughness factor (0.0-1.0) | |
| ground_plane | No | Add a semi-transparent ground plane for shadow catching | |
| ssao | No | Enable Screen-Space Ambient Occlusion | |
| fxaa | No | Enable Fast Approximate Anti-Aliasing | |
| width | No | Override image width (None uses quality preset) | |
| height | No | Override image height (None uses quality preset) | |
| scalar_range | No | [min, max] for color scale, None for auto | |
| timestep | No | Specific timestep, "latest", or None for first | |
| output_filename | No | Output PNG filename | cinematic.png |