pix

Library for image conversion and compositing.

A raster image can be cheaply converted to and from raw byte buffers, enabling interoperability with other crates.

Many image formats are supported:

• Bit depth: 8- or 16-bit integer and 32-bit float
• Alpha: premultiplied or straight
• Gamma: linear or sRGB
• Color models:
  • RGB / BGR (red, green, blue)
  • CMY (cyan, magenta, yellow)
  • Gray (luma / relative luminance)
  • HSV (hue, saturation, value)
  • HSL (hue, saturation, lightness)
  • HWB (hue, whiteness, blackness)
  • YCbCr (used by JPEG)
  • Matte (alpha only)
  • OkLab (lightness, green/red, blue/yellow)
  • XYZ (CIE 1931 XYZ)

HWB Color Example

```rust use pix::{hwb::SHwb8, rgb::SRgb8, Raster};

let mut r = Raster::withclear(256, 256); for (y, row) in r.rowsmut(()).enumerate() { for (x, p) in row.itermut().enumerate() { let h = ((x + y) >> 1) as u8; let w = y.saturatingsub(x) as u8; let b = x.saturatingsub(y) as u8; *p = SHwb8::new(h, w, b); } } // Convert to SRgb8 color model let raster = Raster::::withraster(&r); ```

Compositing Example

Compositing is supported for premultiplied images with linear gamma.

```rust use pix::{ops::SrcOver, rgb::Rgba8p, Raster};

let mut r0 = Raster::withclear(100, 100); let r1 = Raster::withcolor(5, 5, Rgba8p::new(80, 0, 80, 200)); r0.composite_raster((40, 40), &r1, (), SrcOver); ```

Documentation

https://docs.rs/pix