This is a work in progress library to create, process, read and write different image formats with Zig programming language.

This project assume current Zig master (0.11.0-dev.3879+5804f3f75 or higher) with stage2 self-hosted compiler.

How to add to your project:

1. Clone this repository or add as a submodule
2. Add to your build.zig

exe.addAnonymousModule("zigimg", .{.source_file = .{ .path = "zigimg.zig" }});

1. Example build.zig.zon file

.{
    .name = "app",
    .version = "0.0.0",
    .dependencies = .{
        .zigimg = .{
            .url = "https://github.com/zigimg/zigimg/archive/$REPLACE_WITH_WANTED_COMMIT$.tar.gz",
        },
    },
}

2. When it fails to build due to a mismatched hash, add the hash line to the dependency

.zigimg = .{
    .url = "https://github.com/zigimg/zigimg/archive/$REPLACE_WITH_WANTED_COMMIT$.tar.gz",
    .hash = "$REPLACE_WITH_HASH_FROM_BUILD_ERROR$",
},

To run the test suite, checkout the test suite and run

1. Checkout zigimg
2. Go back one folder and checkout the test suite
3. Run the tests with zig build

zig build test

• version 4 BMP
• version 5 BMP
• 24-bit RGB
• 32 RGBA
• Doesn't support any compression

• Everything is supported

• Support monochrome, 4 color, 16 color and 256 color indexed images
• Support 24-bit RGB images

• Support 8-bit and 16-bit grayscale images
• 16-bit ascii grayscale loading not tested

• 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.

• Support 24-bit RGB (8-bit per channel)
• Missing 48-bit RGB (16-bit per channel)

• Imported from https://github.com/MasterQ32/zig-qoi with blessing of the author

• Supports uncompressed and compressed 8-bit grayscale, indexed with 16-bit colormap, truecolor with 24-bit or 32-bit bit depth.
• Supports version 1 and version 2