ChromaFx 0.4.0-beta.29

Modern, high-performance .NET image processing and drawing library.

Key points:

• Pure C#, zero dependency implementation
• Image encoding/decoding (PNG, JPEG, GIF, BMP)
• Drawing primitives and effects
• Pipeline-friendly API for efficient image processing

Packages

ChromaFX is distributed as multiple NuGet packages to suit different needs:

• Use ChromaFx for new projects targeting .NET 8 or later.
• Use ChromaFx.Core, ChromaFx.IO, and ChromaFx.Processing for modular usage or advanced scenarios.
• Use ChromaFx.Legacy if you need support for older APIs or migration from previous versions.

Provides backward compatibility with the original Structure.Sketching API surface. Use only if migrating existing projects — for new development, prefer ChromaFx

Installation

Install via NuGet package:

dotnet add package ChromaFx

For modular usage:

dotnet add package ChromaFx.Core
dotnet add package ChromaFx.IO
dotnet add package ChromaFx.Processing

For legacy support:

dotnet add package ChromaFx.Legacy

Getting Started

Classic API (currently available)

using ChromaFx;
using ChromaFx.IO;
using ChromaFx.Processing;
using ChromaFx.Processing.Transforms;

class Program
{
    static void Main()
    {
        // Load an image from file
        var image = Image.Load("input.png");

        // Apply processing using the Apply() method
        image = image.Apply(new Resize(200, 200))
                     .Apply(new Rotate(90))
                     .Apply(new Invert());

        // Save the result
        image.Save("output.png");
    }
}

Modern API ⚠️ (preview / in development)

using ChromaFx;

class Program
{
    static void Main()
    {
        var image = Image.Load("input.png")
                         .Process(p => p
                             .Resize(200, 200)
                             .Rotate(90)
                             .Invert()
                         )
                         .Save("output.png");
    }
}

Requirements

• .NET 8 or later

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–2025).

Roadmap

• ✅ Modularization – Core, IO, Processing, and Legacy packages split out.
• 🔜 API Modernization – Introducing a cleaner, pipeline-friendly API (breaking changes).
• ⏭ Extended Features – Advanced algorithms such as pixel upscaling, new filters, and effects.

Contributing

Contributions, bug reports, and suggestions are welcome! The roadmap may evolve as the project grows — feel free to open an issue or pull request if you'd like to help shape ChromaFX.