Zig Image library
This is a work in progress library to create, process, read and write different image formats with Zig programming language.
Install & Build
This project assume current Zig master (0.10.0+) with stage2 self-hosted compiler.
Use zigimg in your project
How to add to your project:
- Clone this repository or add as a submodule
- Add to your
build.zig
exe.addPackagePath("zigimg", "zigimg/zigimg.zig");
Test suite
To run the test suite, checkout the test suite and run
- Checkout zigimg
- Go back one folder and checkout the test suite
- Run the tests with
zig build
zig build test
Supported image formats
Image Format | Read | Write |
---|---|---|
ANIM | ❌ | ❌ |
BMP | ✔️ (Partial) | ❌ |
GIF | ❌ | ❌ |
ICO | ❌ | ❌ |
IILBM | ❌ | ❌ |
JPEG | ❌ | ❌ |
PAM | ❌ | ❌ |
PBM | ✔️ | ❌ |
PCX | ✔️ | ❌ |
PGM | ✔️ (Partial) | ✔️ (Partial) |
PNG | ✔️ | ✔️ (Partial) |
PPM | ✔️ (Partial) | ❌ |
QOI | ✔️ | ✔️ |
TGA | ✔️ | ❌ |
TIFF | ❌ | ❌ |
XBM | ❌ | ❌ |
XPM | ❌ | ❌ |
BMP - Bitmap
- version 4 BMP
- version 5 BMP
- 24-bit RGB
- 32 RGBA
- Doesn't support any compression
PBM - Portable Bitmap format
- Everything is supported
PCX - ZSoft Picture Exchange format
- Support monochrome, 4 color, 16 color and 256 color indexed images
- Support 24-bit RGB images
PGM - Portable Graymap format
- Support 8-bit and 16-bit grayscale images
- 16-bit ascii grayscale loading not tested
PNG - Portable Network Graphics
- Support all pixel formats supported by PNG (grayscale, grayscale+alpha, indexed, truecolor, truecolor with alpha) in 8-bit or 16-bit.
- Support the mininal chunks in order to decode the image.
- Not all images in Png Test Suite is covered but should be good enough for now.
PPM - Portable Pixmap format
- Support 24-bit RGB (8-bit per channel)
- Missing 48-bit RGB (16-bit per channel)
QOI - Quite OK Image Format
- Imported from https://github.com/MasterQ32/zig-qoi with blessing of the author
TGA - Truevision TGA format
- Supports uncompressed and compressed 8-bit grayscale, indexed with 16-bit colormap, truecolor with 24-bit or 32-bit bit depth.