viznoir

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

Args: file_path: Path to simulation file field_name: Field to visualize (None for auto-detect) colormap: Color map preset (e.g., "Cool to Warm", "Viridis") quality: Rendering quality preset lighting: Lighting preset (cinematic, dramatic, studio, publication, outdoor, None) background: Background preset (dark_gradient, light_gradient, blue_gradient, publication, None) azimuth: Camera azimuth in degrees (None for auto from shape analysis) elevation: Camera elevation in degrees (None for auto from shape analysis) fill_ratio: How much of viewport the object fills (0.0-1.0, default 0.75) metallic: PBR metallic factor (0.0-1.0) roughness: PBR roughness factor (0.0-1.0) ground_plane: Add a semi-transparent ground plane for shadow catching ssao: Enable Screen-Space Ambient Occlusion fxaa: Enable Fast Approximate Anti-Aliasing width: Override image width (None uses quality preset) height: Override image height (None uses quality preset) scalar_range: [min, max] for color scale, None for auto timestep: Specific timestep, "latest", or None for first output_filename: Output PNG filename