tiff-reader 0.4.0

Pure-Rust, read-only TIFF/BigTIFF file decoder with no C dependencies
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97

use std::path::{Path, PathBuf};

use ndarray::ArrayD;
use tiff_reader::TiffFile;

fn fixture(path: &str) -> PathBuf {
    Path::new(env!("CARGO_MANIFEST_DIR"))
        .join("../testdata/interoperability")
        .join(path)
}

#[test]
fn decodes_real_world_tiff_corpus() {
    let byte = TiffFile::open(fixture("gdal/gcore/data/byte.tif")).unwrap();
    assert!(!byte.is_bigtiff());
    assert_eq!(byte.ifd(0).unwrap().compression(), 1);
    let raster: ArrayD<u8> = byte.read_image(0).unwrap();
    assert_eq!(raster.shape(), &[20, 20]);

    let signed = TiffFile::open(fixture("gdal/gdrivers/data/gtiff/int8.tif")).unwrap();
    assert_eq!(signed.ifd(0).unwrap().sample_format(), vec![2]);
    let raster: ArrayD<i8> = signed.read_image(0).unwrap();
    assert_eq!(raster.shape(), &[20, 20]);

    #[cfg(feature = "jpeg")]
    let jpeg = TiffFile::open(fixture("gdal/gcore/data/gtiff/byte_JPEG.tif")).unwrap();
    #[cfg(feature = "jpeg")]
    assert_eq!(jpeg.ifd(0).unwrap().compression(), 7);
    #[cfg(feature = "jpeg")]
    let raster: ArrayD<u8> = jpeg.read_image(0).unwrap();
    #[cfg(feature = "jpeg")]
    assert_eq!(raster.shape(), &[20, 20]);

    let lerc = TiffFile::open(fixture("gdal/gcore/data/gtiff/byte_LERC.tif")).unwrap();
    assert_eq!(lerc.ifd(0).unwrap().compression(), 34887);
    let raster: ArrayD<u8> = lerc.read_image(0).unwrap();
    assert_eq!(raster.shape(), &[20, 20]);

    let lerc_deflate =
        TiffFile::open(fixture("gdal/gcore/data/gtiff/byte_LERC_DEFLATE.tif")).unwrap();
    assert_eq!(lerc_deflate.ifd(0).unwrap().compression(), 34887);
    let raster: ArrayD<u8> = lerc_deflate.read_image(0).unwrap();
    assert_eq!(raster.shape(), &[20, 20]);

    let lerc_rgb = TiffFile::open(fixture(
        "gdal/gcore/data/gtiff/rgbsmall_LERC_tiled_separate.tif",
    ))
    .unwrap();
    assert!(lerc_rgb.ifd(0).unwrap().is_tiled());
    assert_eq!(lerc_rgb.ifd(0).unwrap().planar_configuration(), 2);
    let raster: ArrayD<u8> = lerc_rgb.read_image(0).unwrap();
    assert_eq!(raster.ndim(), 3);
    assert_eq!(raster.shape()[2], 3);

    #[cfg(feature = "zstd")]
    let zstd = TiffFile::open(fixture("gdal/gcore/data/byte_zstd.tif")).unwrap();
    #[cfg(feature = "zstd")]
    assert_eq!(zstd.ifd(0).unwrap().compression(), 50000);
    #[cfg(feature = "zstd")]
    let raster: ArrayD<u8> = zstd.read_image(0).unwrap();
    #[cfg(feature = "zstd")]
    assert_eq!(raster.shape(), &[20, 20]);

    #[cfg(feature = "zstd")]
    let lerc_zstd = TiffFile::open(fixture("gdal/gcore/data/gtiff/byte_LERC_ZSTD.tif")).unwrap();
    #[cfg(feature = "zstd")]
    assert_eq!(lerc_zstd.ifd(0).unwrap().compression(), 34887);
    #[cfg(feature = "zstd")]
    let raster: ArrayD<u8> = lerc_zstd.read_image(0).unwrap();
    #[cfg(feature = "zstd")]
    assert_eq!(raster.shape(), &[20, 20]);
}

#[test]
fn opens_real_world_bigtiff_and_cog_layouts() {
    let bigtiff = TiffFile::open(fixture("gdal/gcore/data/bigtiff_one_strip_long.tif")).unwrap();
    assert!(bigtiff.is_bigtiff());
    let raster: ArrayD<u8> = bigtiff.read_image(0).unwrap();
    assert_eq!(raster.shape(), &[1, 1]);

    let tiled = TiffFile::open(fixture("gdal/gcore/data/gtiff/byte_NONE_tiled.tif")).unwrap();
    assert!(tiled.ifd(0).unwrap().is_tiled());
    let raster: ArrayD<u8> = tiled.read_image(0).unwrap();
    assert_eq!(raster.shape(), &[20, 20]);
}

#[test]
fn opens_real_world_tiff_with_internal_overviews() {
    let file = TiffFile::open(fixture("gdal/gcore/data/byte_with_ovr.tif")).unwrap();
    assert!(file.ifd_count() > 1);

    let base: ArrayD<u8> = file.read_image(0).unwrap();
    assert_eq!(base.shape(), &[20, 20]);

    let overview: ArrayD<u8> = file.read_image(1).unwrap();
    assert!(!overview.is_empty());
}