Struct CameraProfile 

#[non_exhaustive]
pub struct CameraProfile {
    pub name: Option<String>,
    pub unique_camera_model: Option<String>,
    pub copyright: Option<String>,
    pub embed_policy: Option<u32>,
    pub color_matrices: Vec<ColorMatrix>,
    pub forward_matrices: Vec<ColorMatrix>,
    pub hue_sat_map: Option<ProfileTable>,
    pub look_table: Option<ProfileTable>,
    pub tone_curve: Option<Vec<[f32; 2]>>,
    pub baseline_exposure_offset: f64,
    pub default_black_render: u32,
}

A DNG camera profile.

Build one from a .dcp file (CameraProfile::from_dcp) or take the one embedded in a DNG (FlashRaw::embedded_camera_profile in the flashraw crate). Every field is optional data; a profile with neither matrices nor tables does nothing.

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.

name: Option<String>

ProfileName.

unique_camera_model: Option<String>

UniqueCameraModel: the camera the profile was made for.

copyright: Option<String>

ProfileCopyright.

embed_policy: Option<u32>

ProfileEmbedPolicy (0 allow copying, 1 embed if used, 2 embed never, 3 no restrictions).

color_matrices: Vec<ColorMatrix>

ColorMatrix1/2 (XYZ to camera, 3 x 3) with their calibration illuminants.

forward_matrices: Vec<ColorMatrix>

ForwardMatrix1/2 (white balanced camera to XYZ D50, 3 x 3) with their illuminants.

hue_sat_map: Option<ProfileTable>

ProfileHueSatMapDims / ProfileHueSatMapData1/2 / ProfileHueSatMapEncoding.

look_table: Option<ProfileTable>

ProfileLookTableDims / ProfileLookTableData / ProfileLookTableEncoding.

tone_curve: Option<Vec<[f32; 2]>>

ProfileToneCurve as (input, output) points in [0, 1], ascending in input.

baseline_exposure_offset: f64

BaselineExposureOffset in stops.

default_black_render: u32

DefaultBlackRender (0 auto, 1 none). Recorded, not applied.

Implementations

impl CameraProfile

pub fn from_dcp(bytes: &[u8]) -> Result<Self>

Parse a DNG Camera Profile (.dcp) file.

Errors

Error::UnsupportedFormat without the IIRC magic, Error::InvalidMetadata for tables whose size does not match their dimensions or contain non-finite values.

pub fn from_dng_ifd(ifd: &Ifd<'_>) -> Option<Self>

The profile tags of a DNG’s first IFD. Returns None when the file carries no profile data (no forward matrix, hue/sat map, look table or tone curve); ordinary colour matrices alone do not make a profile. Malformed tables are skipped.

pub fn is_empty(&self) -> bool

Whether the profile carries nothing to apply.

pub fn to_dcp(&self) -> Vec<u8>

Serialise as a .dcp file (little-endian TIFF with the IIRC magic), the inverse of CameraProfile::from_dcp. Used by tests and tools; matrices are written as floats.

Trait Implementations

impl Clone for CameraProfile

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CameraProfile

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

Formats the value using the given formatter.

impl Default for CameraProfile

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for CameraProfile

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for CameraProfile