Struct Engine 

pub struct Engine { /* private fields */ }

The rendering engine. Holds an immutable original image and mutable parameters.

On each render() call, all adjustments are applied from scratch in a fixed internal order. This gives user-facing order-independence.

Implementations

impl Engine

pub fn new(image: Rgb32FImage) -> Self

Create a new engine with the given linear sRGB image and neutral parameters.

Always uses the CPU pipeline. This is the canonical path for deterministic output across all platforms. Use Engine::new_gpu or Engine::new_gpu_auto for GPU acceleration.

pub fn new_gpu_auto(image: Rgb32FImage) -> Self

Create an engine that tries GPU first, falling back to CPU.

Use this when the caller explicitly opts into GPU acceleration (e.g. via a --gpu CLI flag). Output may differ slightly from the CPU path due to floating-point precision differences.

pub fn new_gpu(image: Rgb32FImage) -> Result<Self, AgxError>

Create an engine that uses the GPU pipeline. Returns Err if GPU initialization fails.

pub fn new_gpu_fallback(image: Rgb32FImage) -> Result<Self, AgxError>

Create an engine using wgpu’s software fallback adapter. Returns Err if no fallback adapter is available.

pub fn original(&self) -> &Rgb32FImage

Get a reference to the original (unmodified) image.

pub fn params(&self) -> &Parameters

Get a reference to the current parameters.

pub fn params_mut(&mut self) -> &mut Parameters

Get a mutable reference to the current parameters.

pub fn set_params(&mut self, params: Parameters)

Set parameters from a full Parameters struct.

pub fn lut(&self) -> Option<&Lut3D>

Get a reference to the current LUT, if any.

pub fn set_lut(&mut self, lut: Option<Arc<Lut3D>>)

Set or clear the 3D LUT.

Accepts Arc<Lut3D> so the same LUT can be shared across multiple engine instances (e.g. in batch processing) without cloning the table.

pub fn apply_preset(&mut self, preset: &Preset)

Apply a preset, replacing the current parameters and LUT.

pub fn layer_preset(&mut self, preset: &Preset)

Layer a preset on top of current parameters. Only fields specified in the preset (Some values in partial_params) are overridden. Unspecified fields keep their current values.

pub fn pipeline_name(&self) -> &'static str

Returns "gpu" or "cpu" depending on which pipeline is active.

pub fn render(&mut self) -> RenderResult

Render the image by applying all adjustments from scratch.

Delegates to the stage-based pipeline. Each render starts from the original image — no state accumulates between renders.