CgePix - Pixel Manipulation Library for C

A compact, dependency-free C library for pixel manipulation, color handling, and image data management.

Features

• Support for indexed, grayscale, RGB/BGR, RGBA/BGRA/ARGB/ABGR, and packed formats (e.g. RGB565, RGBA1010102)
• Color types: RGBA, HSVA, HSLA with 16-bit per channel
• Palette support for indexed images
• Color space conversion: RGBA - HSVA - HSLA
• Alpha handling: premultiply and unpremultiply
• Multiple blending modes: normal, multiply, screen, overlay, darken, lighten, difference, exclusion, and more
• Subimage view creation and row-wise pixel access
• Safe pixel get/set with format conversion

Build Systems

• CMake - supports Linux, macOS, Windows (MSVC, MinGW)
• Makefile.posix - for GCC/Clang on POSIX systems
• Makefile.mingw - for MinGW on Windows
• Makefile.win32 - for MSVC with NMake

Builds a static library. No shared library or external dependencies.

Usage Example

#include "CgePix.h"
#include <stdio.h>
#include <stdlib.h>

int main() {
    uint32_t width = 256;
    uint32_t height = 256;

    CgePix img = {0};
    int format = CGE_PIX_RGBA8;
    int flags = 0;

    size_t dataSize = CgePixInitLayout(width, height, format, flags, &img);
    img.data = malloc(dataSize);

    CgeColor red;
    CgeColorSetRGBA8(&red, 255, 0, 0, 255);

    for (uint32_t y = 0; y < height; y++) {
        for (uint32_t x = 0; x < width; x++) {
            CgePixSetColor(&img, x, y, &red);
        }
    }

    FILE *file = fopen("output.raw", "wb");
    fwrite(img.data, 1, dataSize, file);
    fclose(file);

    free(img.data);
    return 0;
}

Portability

• Written in C89 + stdint.h and stddef.h
• No dynamic memory allocation in library functions
• No external dependencies

License

0BSD - a permissive license with no attribution required.