| 1 |
# image-tiff |
| 2 |
[](https://github.com/image-rs/image-tiff/actions) |
| 3 |
[](https://docs.rs/tiff) |
| 4 |
[](https://crates.io/crates/tiff) |
| 5 |
|
| 6 |
TIFF decoding and encoding library in pure Rust |
| 7 |
|
| 8 |
## Supported |
| 9 |
|
| 10 |
### Features |
| 11 |
- Baseline spec (other than formats and tags listed below as not supported) |
| 12 |
- Multipage |
| 13 |
- BigTIFF |
| 14 |
- Incremental decoding |
| 15 |
|
| 16 |
### Formats |
| 17 |
This table lists photometric interpretations and sample formats which are supported for encoding and decoding. The entries are `ColorType` variants for which sample bit depths are supported. Only samples where all bit depths are equal are currently supported. For example, `RGB(8)` means that the bit depth [8, 8, 8] is supported and will be interpreted as an 8 bit per channel RGB color type. |
| 18 |
|
| 19 |
| `PhotometricInterpretation` | UINT Format | IEEEFP Format | |
| 20 |
| --------------------------- | --------------------------------------- | ------------------------- | |
| 21 |
| `WhiteIsZero` | Gray(8\|16\|32\|64) | Gray(32\|64) | |
| 22 |
| `BlackIsZero` | Gray(8\|16\|32\|64) | Gray(32\|64) | |
| 23 |
| `RGB` | RGB(8\|16\|32\|64), RGBA(8\|16\|32\|64) | RGB(32\|64), RGBA(32\|64) | |
| 24 |
| `RGBPalette` | | | |
| 25 |
| `Mask` | | | |
| 26 |
| `CMYK` | CMYK(8\|16\|32\|64) | CMYK(32\|64) | |
| 27 |
| `CMYKA` | CMYKA(8) | | |
| 28 |
| `YCbCr` | | | |
| 29 |
| `CIELab` | | | |
| 30 |
|
| 31 |
### Compressions |
| 32 |
|
| 33 |
| | Decoding | Encoding | |
| 34 |
| -------- | -------- | -------- | |
| 35 |
| None | ✓ | ✓ | |
| 36 |
| LZW | ✓ | ✓ | |
| 37 |
| Deflate | ✓ | ✓ | |
| 38 |
| PackBits | ✓ | ✓ | |
| 39 |
| Fax4 | ✓ | not yet | |
| 40 |
| JPEG | ✓ | not yet | |
| 41 |
| ZSTD | ✓ | not yet | |
| 42 |
|
| 43 |
|
| 44 |
## Not yet supported |
| 45 |
|
| 46 |
Formats and interpretations not listed above or with empty entries are unsupported. |
| 47 |
|
| 48 |
- Baseline tags |
| 49 |
- `ExtraSamples` |
| 50 |
- Extension tags |
| 51 |
|
| 52 |
## Fuzzing |
| 53 |
|
| 54 |
This crate uses [cargo-fuzz](https://github.com/rust-fuzz/cargo-fuzz) in order to test the image parser. |
| 55 |
|
| 56 |
After installing it with `cargo install cargo-fuzz` on a nightly rustc, the |
| 57 |
fuzzing harness can be run with recommended settings using |
| 58 |
`cargo fuzz run decode_image -snone -- -timeout=5`. |