PlutoFilter: The Zero-Allocation Image Processing Library for Embedded Systems

Why PlutoFilter Stands Out in Image Processing

PlutoFilter solves two critical challenges in resource-constrained environments: dynamic memory elimination and consistent cross-platform rendering. Unlike traditional libraries, this single-header C99 implementation delivers professional-grade image effects without a single malloc call. Its secret lies in precomputed transformation matrices and in-place processing algorithms that maintain CSS/SVG filter semantics with pixel-perfect accuracy.

Key Advantages at a Glance

Installation: Two Simple Modes

Header-Only Configuration

// In your project files
#include "plutofilter.h"

This exposes all API declarations without implementations—perfect for multi-file projects.

Full Implementation Mode

// In ONE source file
#define PLUTOFILTER_IMPLEMENTATION
#include "plutofilter.h"

// Other files use standard inclusion
#include "plutofilter.h"

For embedded projects, add this before inclusion:

#define PLUTOFILTER_BUILD_STATIC  // Makes functions static
#define PLUTOFILTER_IMPLEMENTATION
#include "plutofilter.h"

Core Functionality Deep Dive

Gaussian Blur: Precision Without Overhead

plutofilter_gaussian_blur(input, output, horiz_stddev, vert_stddev);

Real-world application:

// Create depth-of-field effect
plutofilter_gaussian_blur(background, background, 8.0f, 8.0f);
plutofilter_gaussian_blur(foreground, foreground, 1.5f, 1.5f);

Color Transformation Matrix

The 5×4 matrix engine powers advanced color operations:

const float sepia[20] = {
    0.393f, 0.769f, 0.189f, 0.0f, 0.0f,
    0.349f, 0.686f, 0.168f, 0.0f, 0.0f,
    0.272f, 0.534f, 0.131f, 0.0f, 0.0f,
    0.0f,   0.0f,   0.0f,   1.0f, 0.0f
};
plutofilter_color_transform(input, output, sepia);

Grayscale Conversion

plutofilter_color_transform_grayscale(image, result, intensity);

Hue Rotation Mechanics

plutofilter_color_transform_hue_rotate(image, result, 30.0f); // 30-degree shift

Practical use: Create color theme variations from single assets:

// Generate UI theme variants
plutofilter_color_transform_hue_rotate(blue_button, red_button, 180.0f);
plutofilter_color_transform_hue_rotate(blue_button, green_button, 90.0f);

Professional Blending Modes

plutofilter_blend(foreground, background, result, PLUTOFILTER_BLEND_SOFT_LIGHT);

Alpha Compositing Operations

plutofilter_composite(layer1, layer2, result, PLUTOFILTER_COMPOSITE_ATOP);

Memory Optimization Techniques

Zero-Allocation Architecture

PlutoFilter achieves memory efficiency through:

1. In-place processing: Modifies pixel buffers directly
2. Precomputed kernels: Eliminates runtime calculations
3. Fixed-size temporaries: Requires only width×height buffers
4. Matrix-based transforms: Avoids intermediate buffers

Performance Benchmark (4000×3000 image)

Practical Implementation Guide

Creating Instagram-style Filters

// "Clarendon" filter simulation
plutofilter_color_transform_contrast(input, temp, 1.2f);
plutofilter_color_transform_saturate(temp, temp, 1.1f);
plutofilter_color_transform_brightness(temp, output, 1.05f);

// "Juno" filter effect
plutofilter_color_transform_hue_rotate(input, temp, 330.0f);
plutofilter_color_transform_contrast(temp, output, 0.97f);

UI Asset Processing Pipeline

// Generate pressed button state
plutofilter_color_transform_brightness(button_idle, button_pressed, 0.8f);
plutofilter_blend(button_pressed, shadow_layer, result, PLUTOFILTER_BLEND_MULTIPLY);

// Create disabled state
plutofilter_color_transform_grayscale(button_idle, button_disabled, 0.6f);
plutofilter_color_transform_opacity(button_disabled, button_disabled, 0.7f);

Future Development Roadmap

graph LR
    A[Current Features] --> B[Morphology Operations]
    A --> C[Diffuse Lighting]
    A --> D[Convolution Matrices]
    B --> E[Erosion/Dilation]
    C --> F[Light Source Simulation]
    D --> G[Custom Kernels]

Frequently Asked Questions

How to handle different color spaces?
PlutoFilter includes built-in conversions:

plutofilter_color_transform_linear_to_srgb(input, output); // For HDR rendering
plutofilter_color_transform_srgb_to_linear(input, output); // For color operations

Can PlutoFilter process video streams?
Yes, when used with circular buffers:

while(video_frames_available) {
    plutofilter_gaussian_blur(frame_in, frame_out, 2.0f, 2.0f);
    plutofilter_color_transform_saturate(frame_out, frame_out, 1.2f);
    display_frame(frame_out);
}

What image formats are supported?
PlutoFilter operates on raw pixel buffers:

typedef struct {
    float* pixels;    // RGBA floating-point data
    int width;        // Surface width
    int height;       // Surface height
    int stride;       // Bytes per row (0 for packed)
} plutofilter_surface_t;

How to extend with custom filters?
Implement matrix-based effects:

const float emboss_kernel[20] = { /* Custom matrix */ };
plutofilter_color_transform(input, output, emboss_kernel);

Conclusion: Where PlutoFilter Excels

PlutoFilter delivers unparalleled efficiency in:

• Embedded UIs: Smooth animations on microcontrollers
• WebAssembly: Fast image processing in browsers
• Real-time systems: Predictable memory footprints
• Cross-platform tools: Consistent SVG filter rendering

By combining mathematical precision with zero-allocation discipline, it enables complex imaging workflows where traditional libraries cannot operate. As the roadmap expands toward advanced computer vision operations, PlutoFilter is positioned to become the definitive solution for resource-constrained image processing.