Crate 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)

Compositing with blending operations is supported for premultiplied images with linear gamma.

HWB Color Example

use pix::hwb::SHwb8;
use pix::rgb::SRgb8;
use pix::Raster;

let mut r = Raster::with_clear(256, 256);
for (y, row) in r.rows_mut(()).enumerate() {
    for (x, p) in row.iter_mut().enumerate() {
        let h = ((x + y) >> 1) as u8;
        let w = y.saturating_sub(x) as u8;
        let b = x.saturating_sub(y) as u8;
        *p = SHwb8::new(h, w, b);
    }
}
// Convert to SRgb8 pixel format
let raster = Raster::<SRgb8>::with_raster(&r);

Modules

bgr

BGR color model and types.

chan

Component channels

cmy

CMY color model and types.

el

Module for pix::el items

gray

Gray color model and types.

hsl

HSL color model and types.

hsv

HSV color model and types.

hwb

HWB color model and types.

matte

Matte color model and types.

oklab

Oklab color model and types.

ops

Compositing and blending operations.

rgb

RGB color model and types.

xyz

CIE 1931 XYZ color model and types.

ycc

YCbCr color model and types.

Structs

Palette

Color table for use with indexed Rasters.

Raster

Image arranged as a rectangular array of pixels. Rows are ordered top to bottom, and pixels within rows are left to right.

Region

Location / dimensions of pixels relative to a Raster.

Rows

Iterator of rows in a raster, as slices of pixels.

RowsMut

Iterator of rows in a raster, as mutable slices of pixels.

Traits

ColorModel

Model for pixel colors.