Struct TiffDecoder 

pub struct TiffDecoder { /* private fields */ }

Decoder for baseline TIFF images.

Reads chunky images compressed with None or PackBits: 8-bit grayscale/RGB, 1-bit bilevel, and 8-bit palette colour. Other compressions and colour modes return Error::Unsupported until their phases land.

Implementations

impl TiffDecoder

pub fn new() -> Self

Creates a decoder.

pub fn page_count(&self, data: &[u8]) -> Result<usize>

Returns the number of pages (subfile IFDs) in a TIFF.

Errors

Returns Error::InvalidInput if the file header or IFD chain is malformed.

pub fn decode_page(&self, data: &[u8], page: usize) -> Result<ImageBuf<Rgb8>>

Decodes page page of a multi-page TIFF to interleaved 8-bit Rgb8 (page 0 is the first; grayscale is replicated across channels, any alpha is dropped). Multi-page access is TIFF-specific, so it stays inherent; the DecodeImage impls present page 0.

Errors

Returns Error::InvalidInput for malformed input or an out-of-range page, or Error::Unsupported for a feature not yet implemented.

Trait Implementations

impl Clone for TiffDecoder

fn clone(&self) -> TiffDecoder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TiffDecoder

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

Formats the value using the given formatter.

impl DecodeImage<Cmyk8> for TiffDecoder

fn decode_image(&self, data: &[u8]) -> Result<ImageBuf<Cmyk8>>

Errors unless the image is 4-sample; the samples pass through unchanged.

fn decode_image_into( &self, data: &[u8], dst: &mut ImageBuf<P>, ) -> Result<(), Error>

Decode data into dst, reusing its allocation where possible.

impl DecodeImage<Gray8> for TiffDecoder

fn decode_image(&self, data: &[u8]) -> Result<ImageBuf<Gray8>>

Errors unless the image is single-sample; the samples pass through unchanged.

fn decode_image_into( &self, data: &[u8], dst: &mut ImageBuf<P>, ) -> Result<(), Error>

Decode data into dst, reusing its allocation where possible.

impl DecodeImage<Rgb8> for TiffDecoder

fn decode_image(&self, data: &[u8]) -> Result<ImageBuf<Rgb8>>

Grayscale is replicated across channels; any alpha is dropped.

fn decode_image_into( &self, data: &[u8], dst: &mut ImageBuf<P>, ) -> Result<(), Error>

Decode data into dst, reusing its allocation where possible.

impl DecodeImage<Rgba8> for TiffDecoder

fn decode_image(&self, data: &[u8]) -> Result<ImageBuf<Rgba8>>

RGB gains opaque alpha; grayscale is replicated then made opaque.

fn decode_image_into( &self, data: &[u8], dst: &mut ImageBuf<P>, ) -> Result<(), Error>

Decode data into dst, reusing its allocation where possible.

impl Default for TiffDecoder

fn default() -> TiffDecoder

Returns the “default value” for a type.