Skip to content

Getting started ​

Install the meta-package and start with Image.Load / Mutate / Clone / Save.

0.x line

Current line is 0.6.4 on NuGet (tag-only releases). API may still change before 1.0. See the library changelog.

Install ​

bash
dotnet add package ChromaFx

Requires the .NET 10 SDK. The meta-package injects common usings via buildTransitive props.

Quick example ​

csharp
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");

Where things live ​

ConcernPackage
Image, Color, AnimationChromaFx.Core
Load / Save, encoders, ImageFormatsChromaFx.IO
Mutate / Clone, filtersChromaFx.Processing
Scale2x / Scale3x / Hq2x–4x / CleanEdge / Eagle / SaI / RotateSprite / CleanEdgeRotateChromaFx.PixelArt (opt-in; details)
Web-safe / CGA / EGA / VGA DAC quantizeChromaFx.Retro (opt-in; details)
Still WebP / AVIF / JPEG XLChromaFx.Native (opt-in; details)

Prefer ChromaFx for new apps. Pull Core / IO / Processing separately when you want a smaller graph. Add ChromaFx.PixelArt for pixel-art upscaling or rotation, ChromaFx.Retro for retro palettes, and ChromaFx.Native for still WebP, AVIF, or JPEG XL. Animated WebP/AVIF/JPEG XL are not supported.

Next ​

Released under the Apache License 2.0.