Struct exr::image::Encoding

pub struct Encoding {
    pub compression: Compression,
    pub blocks: Blocks,
    pub line_order: LineOrder,
}

How the pixels are split up and compressed.

Fields

compression: Compression

How the pixel data of all channels in this layer is compressed. May be Compression::Uncompressed. See layer.attributes for more attributes.

blocks: Blocks

Describes how the pixels of this layer are divided into smaller blocks. Either splits the image into its scan lines or splits the image into tiles of the specified size. A single block can be loaded without processing all bytes of a file.

line_order: LineOrder

In what order the tiles of this header occur in the file. Does not change any actual image orientation. See layer.attributes for more attributes.

Implementations

impl Encoding

pub const UNCOMPRESSED: Encoding = Encoding { compression: Compression::Uncompressed, blocks: Blocks::ScanLines, // longest lines, faster memcpy line_order: LineOrder::Increasing // presumably fastest? }

No compression. Massive space requirements. Fast, because it minimizes data shuffling and reallocation.

pub const FAST_LOSSLESS: Encoding = Encoding { compression: Compression::RLE, blocks: Blocks::Tiles(Vec2(64, 64)), // optimize for RLE compression line_order: LineOrder::Unspecified }

Run-length encoding with tiles of 64x64 pixels. This is the recommended default encoding. Almost as fast as uncompressed data, but optimizes single-colored areas such as mattes and masks.

pub const SMALL_LOSSLESS: Encoding = Encoding { compression: Compression::ZIP16, blocks: Blocks::ScanLines, // largest possible, but also with high probability of parallel workers line_order: LineOrder::Increasing }

ZIP compression with blocks of 16 lines. Slow, but produces small files without visible artefacts.

pub const SMALL_FAST_LOSSY: Encoding = Encoding { compression: Compression::PIZ, blocks: Blocks::Tiles(Vec2(256, 256)), line_order: LineOrder::Unspecified }

PIZ compression with tiles of 256x256 pixels. Small images, not too slow. Might produce visible artefacts in the image.

Trait Implementations

impl Clone for Encoding

fn clone(&self) -> Encoding

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Encoding

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

Formats the value using the given formatter.

impl Default for Encoding

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq<Encoding> for Encoding

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl Copy for Encoding

impl StructuralPartialEq for Encoding