Struct TiffReader 

pub struct TiffReader<'a> { /* private fields */ }

Reader for TIFF and BigTIFF files

Implementations

impl<'a> TiffReader<'a>

pub fn new(logger: &'a Logger) -> Self

Creates a new TIFF reader

pub fn load(&mut self, filepath: &str) -> TiffResult<TIFF>

Loads a TIFF file from the given path

This is the main entry point for loading a TIFF file. It opens the file and delegates to the read() method.

Arguments

• filepath - Path to the TIFF file to load

Returns

A TIFF structure containing the file’s contents

pub fn read(&mut self, reader: &mut dyn SeekableReader) -> TiffResult<TIFF>

Reads a TIFF file from the given reader

This method handles the core process of reading a TIFF file:

1. Detect byte order (little/big endian)
2. Check for TIFF or BigTIFF format
3. Read all IFDs (Image File Directories)

Arguments

• reader - Any struct implementing the SeekableReader trait

Returns

A TIFF structure containing the file’s contents

pub fn read_ifd( &self, reader: &mut dyn SeekableReader, offset: u64, number: usize, ) -> TiffResult<IFD>

Reads an IFD from the reader

An IFD (Image File Directory) contains all the metadata for a single image. It consists of a count followed by a series of entries, each describing an aspect of the image (dimensions, color space, compression, etc.)

Arguments

• reader - The seekable reader to use
• offset - Offset in the file where the IFD starts
• number - The index of this IFD in the file

Returns

The parsed IFD structure

pub fn read_tag_values( &self, reader: &mut dyn SeekableReader, ifd: &IFD, tag: u16, ) -> TiffResult<Vec<u64>>

Reads a tag’s value as a vector of u64

This is a utility method for extracting tag values from an IFD. It handles different field types and automatically converts them to u64.

Arguments

• reader - The seekable reader to use
• ifd - The IFD containing the tag
• tag - The tag number to read

Returns

A vector of u64 values

pub fn read_rational( &self, reader: &mut dyn SeekableReader, ) -> TiffResult<(u32, u32)>

Reads a rational value (numerator/denominator pair)

Arguments

• reader - The seekable reader to use

Returns

A tuple with numerator and denominator

pub fn read_u16(&self, reader: &mut dyn SeekableReader) -> TiffResult<u16>

Reads a u16 value using the current byte order handler

Arguments

• reader - The seekable reader to use

Returns

The read u16 value

pub fn read_u32(&self, reader: &mut dyn SeekableReader) -> TiffResult<u32>

Reads a u32 value using the current byte order handler

Arguments

• reader - The seekable reader to use

Returns

The read u32 value

pub fn read_u64(&self, reader: &mut dyn SeekableReader) -> TiffResult<u64>

Reads a u64 value using the current byte order handler

Arguments

• reader - The seekable reader to use

Returns

The read u64 value

pub fn read_f64(&self, reader: &mut dyn SeekableReader) -> TiffResult<f64>

Reads an f64 value using the current byte order handler

Arguments

• reader - The seekable reader to use

Returns

The read f64 value

pub fn read_ascii_string( &self, reader: &mut dyn SeekableReader, count: u64, ) -> TiffResult<String>

Reads an ASCII string

Arguments

• reader - The seekable reader to use
• count - Number of bytes to read

Returns

The string value, with trailing null characters removed

pub fn read_ascii_string_at_offset( &self, offset: u64, count: u64, ) -> TiffResult<String>

Reads an ASCII string at a specific file offset

Arguments

• offset - File offset where the string starts
• count - Number of bytes to read

Returns

The string value

pub fn get_file_path(&self) -> Option<&str>

Gets the file path if available

Returns

The current file path or None

pub fn is_big_tiff(&self) -> bool

Returns whether the current file is a BigTIFF

Returns

true if the file is BigTIFF, false if it’s standard TIFF

pub fn read_overviews(&mut self, filepath: &str) -> TiffResult<Vec<IFD>>

Read IFD overviews (reduced resolution subfiles)

Overviews are lower-resolution versions of the main image, used for faster display at reduced zoom levels.

Arguments

• filepath - Path to the TIFF file

Returns

A vector of IFDs representing the overviews

pub fn get_byte_order_handler(&self) -> Option<&Box<dyn ByteOrderHandler>>

Gets the current byte order handler

Returns

A reference to the current byte order handler, or None if not yet set