tiff-reader 0.1.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
98
99
100
101
102
103
104
105

# geotiff-rust

Pure-Rust, read-only decoders for TIFF/BigTIFF and GeoTIFF/COG. No C libraries, no build scripts, and no unsafe beyond `memmap2`.

## Crates

| Crate | Description |
|---|---|
| `tiff-reader` | TIFF/BigTIFF decoder with random-access sources, strip/tile reads, and typed raster decode |
| `geotiff-reader` | GeoTIFF reader with CRS/transform extraction, overview discovery, and optional HTTP range-backed remote open |

## Usage

```rust
use geotiff_reader::GeoTiffFile;

let file = GeoTiffFile::open("dem.tif")?;
println!("CRS EPSG: {:?}", file.epsg());
println!("bounds: {:?}", file.geo_bounds());
println!("size: {}x{} ({} bands)", file.width(), file.height(), file.band_count());
println!("nodata: {:?}", file.nodata());
```

Using `tiff-reader` directly:

```rust
use tiff_reader::TiffFile;

let file = TiffFile::open("image.tif")?;
println!("byte order: {:?}", file.byte_order());
println!("BigTIFF: {}", file.is_bigtiff());

for i in 0..file.ifd_count() {
    let ifd = file.ifd(i)?;
    println!("  IFD {}: {}x{}, compression={}", i, ifd.width(), ifd.height(), ifd.compression());
    println!("    tiled: {}, bands: {}", ifd.is_tiled(), ifd.samples_per_pixel());
}

let pixels: ndarray::ArrayD<u16> = file.read_image(0)?;
```

## Features

**TIFF**
- Classic TIFF and BigTIFF support
- Little-endian and big-endian byte orders
- IFD chain traversal (multi-page/multi-image)
- Random-access decode from mmap, in-memory bytes, or custom sources
- Strip and tile data access
- Compression: Deflate, LZW, PackBits, JPEG-in-TIFF compression 7 (optional), ZSTD (optional)
- Parallel strip/tile decompression via Rayon
- All standard tag types (BYTE through IFD8)
- Typed raster reads into `ndarray::ArrayD`

**GeoTIFF**
- GeoKey directory parsing (tag 34735)
- CRS/EPSG extraction (ProjectedCSType, GeographicType)
- Model tiepoint and pixel scale (tags 33922, 33550)
- Model transformation matrix (tag 34264)
- Correct `PixelIsArea`/`PixelIsPoint` normalization for affine bounds and transforms
- Nodata from GDAL_NODATA tag (42113)
- Band interleaving detection
- Pixel-to-geographic coordinate transforms
- Overview discovery for reduced-resolution GeoTIFF IFDs
- Optional HTTP range-backed remote COG/GeoTIFF access

## Feature flags

```toml
[dependencies]
geotiff-reader = "0.1"              # local file reading (default)
geotiff-reader = { version = "0.1", features = ["cog"] }  # + HTTP range-backed remote open
```

| Flag | Default | Description |
|---|---|---|
| `local` | yes | Local file reading via `tiff-reader` |
| `rayon` | yes | Parallel strip/tile decompression |
| `jpeg` | yes | JPEG-in-TIFF compression 7 support, including `JPEGTables`-backed abbreviated streams |
| `zstd` | yes | ZSTD compression support (tiff-reader) |
| `cog` | no | Enable HTTP range-backed remote GeoTIFF/COG open; implies `local` |

## Testing

```sh
cargo test --all-features
```

Real-world interoperability fixtures are checked in under `testdata/interoperability` and can be re-verified locally without network access:

```sh
./scripts/fetch-interoperability-corpus.sh --verify-only
```

Fuzzing uses that corpus as its seed set:

```sh
./scripts/seed-fuzz-corpus.sh
cargo fuzz run tiff_open fuzz/corpus/tiff_open
cargo fuzz run geotiff_open fuzz/corpus/geotiff_open
```

## License

MIT OR Apache-2.0