Enum exr::image::FlatSamples

pub enum FlatSamples {
    F16(Vec<f16>),
    F32(Vec<f32>),
    U32(Vec<u32>),
}

A vector of non-deep values (one value per pixel per channel). Stores row after row in a single vector. The precision of all values is either f16, f32 or u32.

Since this is close to the pixel layout in the byte file, this will most likely be the fastest storage. Using a different storage, for example SpecificChannels, will probably be slower.

Variants

F16(Vec<f16>)

A vector of non-deep f16 values.

F32(Vec<f32>)

A vector of non-deep f32 values.

U32(Vec<u32>)

A vector of non-deep u32 values.

Implementations

impl FlatSamples

pub fn len(&self) -> usize

The number of samples in the image. Should be the width times the height. Might vary when subsampling is used.

pub fn values_as_f32<'s>(&'s self) -> impl 's + Iterator<Item = f32>

Views all samples in this storage as f32. Matches the underlying sample type again for every sample, match yourself if performance is critical! Does not allocate.

pub fn values<'s>(&'s self) -> impl 's + Iterator<Item = Sample>

All samples in this storage as iterator. Matches the underlying sample type again for every sample, match yourself if performance is critical! Does not allocate.

pub fn value_by_flat_index(&self, index: usize) -> Sample

Lookup a single value, by flat index. The flat index can be obtained using Vec2::flatten_for_width which computes the index in a flattened array of pixel rows.

Trait Implementations

impl Clone for FlatSamples

fn clone(&self) -> FlatSamples

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for FlatSamples

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

Formats the value using the given formatter.

impl PartialEq for FlatSamples

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl ValidateResult for FlatSamples

fn validate_result( &self, other: &Self, options: ValidationOptions, location: impl Fn() -> String, ) -> ValidationResult

Compare self with the other. Exceptional behaviour:

fn assert_equals_result(&self, result: &Self)

Compare self with the other. Panics if not equal.

impl<'samples> WritableLevel<'samples> for FlatSamples

fn sample_type(&self) -> SampleType

Generate the file meta data regarding the number type of these samples

type Writer = FlatSamplesWriter<'samples>

The type of the temporary writer for this single level of samples

fn create_level_writer(&'samples self, size: Vec2<usize>) -> Self::Writer

Create a temporary writer for this single level of samples

impl<'samples> WritableSamples<'samples> for FlatSamples

fn sample_type(&self) -> SampleType

Generate the file meta data regarding the number type of this storage

fn infer_level_modes(&self) -> (LevelMode, RoundingMode)

Generate the file meta data regarding resolution levels

type Writer = FlatSamplesWriter<'samples>

The type of the temporary writer for this sample storage

fn create_samples_writer(&'samples self, header: &Header) -> Self::Writer

Create a temporary writer for this sample storage

impl StructuralPartialEq for FlatSamples