# image2 - image processing library

<a href="https://crates.io/crates/image2">
    <img src="https://img.shields.io/crates/v/image2.svg">
</a>

A Rust crate focused on generic image processing for a wide range of image formats and data types. [OpenImageIO](https://github.com/OpenImageIO/oiio) is used to read/write images and supports "`TIFF`, `JPEG`/`JFIF`, `OpenEXR`, `PNG`, `HDR`/`RGBE`, `ICO`, `BMP`, `Targa`, `JPEG-2000`, `RMan Zfile`, `FITS`, `DDS`, `Softimage PIC`, `PNM`, `DPX`, `Cineon`, `IFF`, `Field3D`, `Ptex`, `Photoshop PSD`, `Wavefront RLA`, `SGI`, `WebP`, `GIF`, and a variety of RAW digital camera formats"  but `ImageMagick` can also be used instead. This is not a pure Rust crate, if that's important to you then [image](https://github.com/image-rs/image) is probably a better fit.

- Supported image data types: `u8`, `i8`, `u16`, `i16`, `u32`, `i32`, `u64`, `i64`, `f16`, `f32`, `f64`
- Supported color types: `gray`, `rgb`, `rgba`, `hsv`, `cmyk`, `xyz`
- Read and write images of any supported type/color
  * Colors other than `gray`, `rgb` and `rgba` will be converted to `rgb` before writing
- Easy to add new colors
- Generic image processing across data types using `Pixel`
- Composable operations using `Filter` (with async support)

## Features

- `oiio`
  * Enables I/O using OpenImageIO
- `parallel`:
  * Enables parallel image iterators
- `window`:
  * Enables ability to draw images to a graphical window
- `halide`:
  * [halide-runtime](https://github.com/zshipko/halide-runtime) interop

## External dependencies

- `libOpenImageIO` (optional)
    * `oiio` feature
    * Version >= 2.0
    * Debian-based distros: `apt install libopenimageio-dev`


