https://github.com/douglau/pix
Library for working with pixels and images
https://github.com/douglau/pix
image-processing
Last synced: about 1 year ago
JSON representation
Library for working with pixels and images
- Host: GitHub
- URL: https://github.com/douglau/pix
- Owner: DougLau
- License: apache-2.0
- Created: 2019-04-07T13:34:25.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2025-04-06T14:57:22.000Z (about 1 year ago)
- Last Synced: 2025-04-15T16:59:25.550Z (about 1 year ago)
- Topics: image-processing
- Language: Rust
- Size: 548 KB
- Stars: 26
- Watchers: 4
- Forks: 2
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE-APACHE
Awesome Lists containing this project
README
# 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::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 color model
let raster = Raster::::with_raster(&r);
```
### Compositing Example
Compositing is supported for *premultiplied* images with *linear* gamma.
```rust
use pix::{ops::SrcOver, rgb::Rgba8p, Raster};
let mut r0 = Raster::with_clear(100, 100);
let r1 = Raster::with_color(5, 5, Rgba8p::new(80, 0, 80, 200));
r0.composite_raster((40, 40), &r1, (), SrcOver);
```
## Documentation
[https://docs.rs/pix](https://docs.rs/pix)