zCrop

A simple image cropping tool built with Zig. And C libraries. Ok, it's mostly C.

A cropped image of an image demonstrating how to crop an image with zCrop.

Features

• Load PNG, JPEG, and BMP images
• Interactive crop rectangle with mouse drag-and-resize
• Zoom in/out for precise cropping (Ctrl + scroll wheel)
• Pan around zoomed images
• Visual overlay showing crop region
• Save cropped image to disk

Requirements

• Zig 0.15.0 or later
• SDL2 development libraries

Installing SDL2

# Arch Linux
sudo pacman -S sdl2

# Ubuntu/Debian
sudo apt install libsdl2-dev

# macOS
brew install sdl2

# Windows (vcpkg)
vcpkg install sdl2

Building

# Using Make (recommended)
make              # Build optimized release binary
make debug        # Build debug binary
make test         # Run tests
make run IMG=photo.png  # Build and run with image
make install      # Install to ~/.local/bin
make clean        # Remove build artifacts

# Using Zig directly
zig build -Doptimize=ReleaseSmall  # Optimized (~130KB)
zig build                           # Debug build
zig build test                      # Run tests
zig build run -- path/to/image.png  # Build and run

Usage

zcrop image.png
# or
./zig-out/bin/zcrop image.png

Controls

The cropped image is saved as originalname_cropped.ext in the same directory.

Libraries Used

• stb_image - Single-header C library for image loading/saving. Chosen for simplicity and to demonstrate Zig's C interop.
• SDL2 - Cross-platform windowing, input, and rendering. Mature and widely available.

License

MIT