Struct RawDecodeConfig 

#[non_exhaustive]
pub struct RawDecodeConfig {
    pub demosaic: DemosaicMethod,
    pub max_pixels: u64,
    pub output: OutputMode,
    pub target: OutputPrimaries,
    pub exposure_ev: f32,
    pub apply_crop: bool,
    pub apply_orientation: bool,
    pub wb_override: Option<[f32; 3]>,
}

Configuration for RAW/DNG decoding.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

demosaic: DemosaicMethod

Demosaicing algorithm to use.

max_pixels: u64

Maximum pixel count (width × height) before rejecting.

output: OutputMode

Output rendering mode.

• Develop (default): display-ready u16 sRGB with WB, color matrix, tone curve, and sRGB gamma.
• Linear: scene-referred f32 linear with WB and color matrix applied.
• CameraRaw: raw camera values as f32, no WB or color matrix.

target: OutputPrimaries

Target output color primaries.

Controls the RGB primaries of the output buffer. Only affects Develop and Linear modes; CameraRaw ignores this.

Default: Srgb.

exposure_ev: f32

Exposure compensation in EV (stops).

Applied as a linear multiplier (2^exposure_ev) after WB + color matrix, before tone mapping and gamma. Positive values brighten; negative darken. Only affects Develop and Linear.

Default: 0.0 (no adjustment).

apply_crop: bool

Whether to apply the crop specified in the RAW metadata.

apply_orientation: bool

Whether to apply EXIF orientation (rotation/flip) to the output.

When true (default), the decoded image is rotated/flipped to match display orientation, and RawInfo::orientation is set to 1. When false, the raw sensor orientation is preserved.

wb_override: Option<[f32; 3]>

Override white balance coefficients (RGB multipliers).

When set, these multipliers replace the camera’s as-shot WB during the color pipeline. Only has effect in Develop and Linear modes.

Values are relative multipliers (e.g., [1.0, 1.0, 1.0] = no WB, [2.0, 1.0, 1.5] = boost red, slight blue).

Implementations

impl RawDecodeConfig

pub fn new() -> Self

Create a config with default settings.

pub fn with_demosaic(self, method: DemosaicMethod) -> Self

Set the demosaicing method.

pub fn with_max_pixels(self, max: u64) -> Self

Set maximum allowed pixel count.

pub fn with_output(self, mode: OutputMode) -> Self

Set the output rendering mode.

• Develop (default): display-ready u16 sRGB
• Linear: scene-referred f32 linear
• CameraRaw: raw camera f32 values

pub fn with_target(self, primaries: OutputPrimaries) -> Self

Set the target output color primaries.

Affects Develop and Linear; ignored for CameraRaw.

pub fn with_exposure_ev(self, ev: f32) -> Self

Set exposure compensation in EV (stops).

Applied as 2^ev multiplier after WB + color matrix. Positive brightens, negative darkens.

pub fn with_crop(self, apply: bool) -> Self

Set whether to apply the crop from RAW metadata (default: true).

pub fn with_orientation(self, apply: bool) -> Self

Set whether to apply EXIF orientation transform (default: true).

When enabled, the output image matches display orientation and width/height reflect the rotated dimensions.

pub fn with_wb(self, rgb: [f32; 3]) -> Self

Override white balance with custom RGB multipliers.

Replaces the camera’s as-shot WB during color pipeline processing. Only effective in Develop and Linear modes.

Trait Implementations

impl Clone for RawDecodeConfig

fn clone(&self) -> RawDecodeConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RawDecodeConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for RawDecodeConfig

fn default() -> Self

Returns the “default value” for a type.