ChromaFx 0.4.0-beta.33

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 .NET 10.
• 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

using ChromaFx;

class Program
{
    static void Main()
    {
        // Load, transform, and save
        Image.Load("input.png")
            .Apply(new Resize(200, 200, ResamplingFiltersAvailable.Bilinear))
            .Apply(new Rotate(90))
            .Apply(new Invert())
            .Save("output.png");

        // Or use the fluent pipeline API
        Image.Load("input.png")
            .Process(p => p
                .Resize(200, 200)
                .Rotate(90)
                .Invert()
            )
            .Save("output.png");
    }
}

API notes

• Image.Load(path) and Image.Load(stream) require ChromaFx.IO (included in the main ChromaFx package).
• Filters live under ChromaFx.Processing.Filters.*; common types are re-exported via global using when you reference the meta-package.
• Apply(IFilter) mutates the image in place and returns it for chaining. Use Copy() when you need to preserve the original.

Requirements

• .NET 8 or .NET 10 SDK (builds for both target frameworks)

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 – Unified load/apply/process surface on Image.
• ⏭ 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.