tensors/imagekit

imagekit

A general-purpose image processing library for Ballerina — the Ballerina equivalent of Python's Pillow. Wraps Java's javax.imageio and java.awt via Ballerina–Java interop.

Supported formats: PNG, JPEG, BMP, GIF

Installation

[[dependency]]
org     = "vishwajayawickrama"
name    = "imagekit"
version = "0.1.0"

Quick Start

import tensors/imagekit;
import ballerina/io;

public function main() returns error? {
    // Read metadata
    imagekit:ImageInfo info = check imagekit:getInfo("photo.png");
    io:println(info.width.toString() + "x" + info.height.toString() + " " + info.format);

    // Crop 20px from each edge
    check imagekit:crop("photo.png", top = 20, bottom = 20, left = 10, right = 10);

    // Resize to exact dimensions
    check imagekit:resize("photo.png", 1920, 1080);

    // Resize preserving aspect ratio
    check imagekit:resizeToFit("photo.png", 800, 600);

    // Rotate 90° clockwise
    check imagekit:rotate("photo.png", 90);

    // Mirror
    check imagekit:flipHorizontal("photo.png");
    check imagekit:flipVertical("photo.png");

    // Grayscale
    check imagekit:toGrayscale("photo.png");

    // Convert format (writes a new file)
    check imagekit:convert("photo.png", "photo.jpg", "JPEG");

    // Create thumbnail fitting within 200×200, aspect ratio preserved
    check imagekit:thumbnail("photo.png", "thumb.png", 200, 200);
}

Batch Crop

imagekit:CropSummary summary = check imagekit:cropDirectory(
    "images/",
    top    = 20,
    bottom = 20,
    backup = true   // saves originals as *.orig.png
);
io:println("Cropped " + summary.processed.toString() + " files, "
    + summary.pixelReductionPct.toString() + "% pixel reduction");

API Reference

Comparison with Pillow