ChromaFx.Processing 0.4.0-beta.44

Modern .NET image processing library.

A lean, managed alternative for .NET apps that need image processing without native codec DLLs.

Key points:

• Pure managed C# on .NET 10 — no third-party NuGet dependencies, no native codec binaries to deploy (BMP, PNG, JPEG, GIF)
• Uses Span<T>, ArrayPool, and SIMD on key paths
• Explicit Mutate / Clone processing API
• Typed encoders (JpegEncoder, PngEncoder, …) and a public ImageFormats registry for extensions
• Pipeline-friendly fluent context for common filters

Performance & Architecture

Fully managed on .NET 10 — no native codec binaries for Docker/Lambda multi-arch. Native code can still edge out pure managed pixel loops; ChromaFx prioritizes deployability and allocation-conscious processing for typical decode → filter → encode pipelines. Measure with tests/ChromaFx.Benchmarks for your scenario.

Packages

• Use ChromaFx for new projects targeting .NET 10.
• Use ChromaFx.Core, ChromaFx.IO, and ChromaFx.Processing for modular usage.

Installation

dotnet add package ChromaFx

Getting Started

// With PackageReference to ChromaFx, common namespaces are injected.
var thumb = Image.Load("input.png")
    .Clone(ctx => ctx
        .Resize(200, 200)
        .Rotate(90)
        .Invert());

thumb.Save("output.jpg", new JpegEncoder { Quality = 85 });

Image.Load("input.png")
    .Mutate(ctx => ctx.Resize(800, 600).Brightness(0.1f))
    .Save("output.png");

API notes

• Prefer the ChromaFx meta-package (ChromaFx.Core + .IO + .Processing).
• Image.Load / Save / ImageFormats live in IO; Mutate/Clone in Processing.
• Fluent context: core ops on IImageProcessingContext, more via extensions (BoxBlur, Saturation, Dilate, Grayscale, …); escape hatch Apply(IFilter).
• Typed encoders: ChromaFx.IO.Encoders (JpegEncoder, PngEncoder, GifEncoder as IAnimationEncoder, …).
• Plugins: IImageFormat / IAnimationFormat (Encode throws on failure); FileFormats.WebP / Avif reserved for ChromaFx.Native or custom plugins.
• Animation supports per-frame delays (GetFrameDelay / SetFrameDelay / FrameDelays); Delay sets all frames.
• Path Save uses the registered format matching the extension; ImageFormats.TryGetFormat looks up by id.
• Meta-package injects common usings via buildTransitive/ChromaFx.props.
• Pack with dotnet pack (not on every local build).

Migration (breaking)

These older APIs are removed (not obsolete):

Requirements

• .NET 10 SDK

License

Apache 2.0 - see LICENSE

Attribution

This project is a fork of Structure.Sketching, originally developed by JaCraig under the Apache License 2.0.

Modifications and ongoing maintenance by Ho Tzin Mein (2023–2026).

Roadmap

• ✅ Modularization – Core, IO, Processing packages split out.
• ✅ API modernization – Mutate/Clone, typed encoders, ImageFormats registry.
• ⏭ Performance – broaden Span/ArrayPool/SIMD coverage beyond current hot paths.
• ⏭ Extended formats – optional native extension package (WebP/AVIF/…).
• ⏭ Extended features – pixel upscaling, more drawing/effects.

Contributing

Contributions, bug reports, and suggestions are welcome!