Struct GeoTIFFReader 

pub struct GeoTIFFReader<T: Reader> {
    pub header: GeoTIFFHeaderReader,
    /* private fields */
}

GeoTIFF Reader

Description

This class reads a GeoTIFF file and returns a list of GeoTIFF images.

Implements the FeatureReader trait

Usage

The methods you have access to:

• GeoTIFFReader::new: Create a new GeoTIFFReader
• GeoTIFFReader::len: Get the length (number of features)
• GeoTIFFReader::is_empty: Check if the reader is empty
• GeoTIFFReader::get_image: Get an image at index
• GeoTIFFReader::iter: Iterate over the features
• GeoTIFFReader::par_iter: Iterate over the features

File Reader

use gistools::{
    parsers::{FeatureReader, FileReader},
    readers::{GeoTIFFReader, GeoTIFFOptions},
};
use std::path::PathBuf;

let mut path = PathBuf::from(env!("CARGO_MANIFEST_DIR"));
path.push("tests/readers/geotiff/fixtures/ycbcr.tif");
let geotiff = GeoTIFFReader::new(FileReader::from(path), None);

{
    // you can pull in the image directly
    let mut image = geotiff.get_image(None).unwrap();
    // read the raster data as any data format
    let raster = image.raster_data(None);
    // or read in the RGB data as RGBA u8 linear encoded
    let rgb = image.get_rgba();
}

// Or you can just pull in the all the grids
let grids: Vec<_> = geotiff.iter().collect();
assert_eq!(grids.len(), 1);

Buffer Reader

use gistools::{
    parsers::{FeatureReader, BufferReader},
    readers::{GeoTIFFReader, GeoTIFFOptions},
};

// Ignore this, used to setup example
use std::path::PathBuf;
let mut path = PathBuf::from(env!("CARGO_MANIFEST_DIR"));
path.push("tests/readers/geotiff/fixtures/ycbcr.tif");
let bytes: Vec<u8> = std::fs::read(path).unwrap();

// read in the data and build the grid
let geotiff = GeoTIFFReader::new(BufferReader::from(bytes), None);
let grid: Vec<_> = geotiff.iter().collect();
assert_eq!(grid.len(), 1);

Links

• https://www.ogc.org/publications/standard/geotiff/
• https://download.osgeo.org/geotiff/spec/tiff6.pdf
• https://geospatialworld.net/article/geotiff-a-standard-image-file-format-for-gis-applications/
• https://docs.ogc.org/is/19-008r4/19-008r4.html
• https://gitlab.com/libtiff/libtiff

Fields

header: GeoTIFFHeaderReader

The GeoTIFF header

Implementations

impl<T: Reader> GeoTIFFReader<T>

pub fn new(reader: T, options: Option<GeoTIFFOptions>) -> GeoTIFFReader<T>

Create a new GeoTIFFReader

pub fn is_empty(&self) -> bool

Check if the reader is empty

pub fn len(&self) -> usize

Get the length of internal subfiles

pub fn get_image(&self, index: Option<usize>) -> Option<GeoTIFFImage<T>>

Get the nth internal subfile of an image. By default, the first is returned.

Parameters

• index: the index of the image to get [Default=0]

Returns

The image at the given index

Trait Implementations

impl<T: Clone + Reader> Clone for GeoTIFFReader<T>

fn clone(&self) -> GeoTIFFReader<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug + Reader> Debug for GeoTIFFReader<T>

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

Formats the value using the given formatter.

impl<T: Default + Reader> Default for GeoTIFFReader<T>

fn default() -> GeoTIFFReader<T>

Returns the “default value” for a type.

impl<T: Reader> FeatureReader<GeoTIFFMetadata, Map<String, ValueType>, RGBA> for GeoTIFFReader<T>

A feature reader trait with a callback-based approach

type FeatureIterator<'a> = GeoTIFFIterator<'a, T> where T: 'a

The Feature Reader should implement an iterator of some kind

fn iter(&self) -> Self::FeatureIterator<'_>

All readers have an iter function that returns a Iterator struct

fn par_iter( &self, pool_size: usize, thread_id: usize, ) -> Self::FeatureIterator<'_>

All readers have a par_iter function that returns a ParallelIterator struct

impl<T: PartialEq + Reader> PartialEq for GeoTIFFReader<T>

fn eq(&self, other: &GeoTIFFReader<T>) -> 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<T: Reader> StructuralPartialEq for GeoTIFFReader<T>