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 ChromaFxRequires 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
| Concern | Package |
|---|---|
Image, Color, Animation | ChromaFx.Core |
Load / Save, encoders, ImageFormats | ChromaFx.IO |
Mutate / Clone, filters | ChromaFx.Processing |
Scale2x / Scale3x / Hq2x–4x / CleanEdge / Eagle / SaI / RotateSprite / CleanEdgeRotate | ChromaFx.PixelArt (opt-in; details) |
| Web-safe / CGA / EGA / VGA DAC quantize | ChromaFx.Retro (opt-in; details) |
| Still WebP / AVIF / JPEG XL | ChromaFx.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
- Packages — NuGet layout
- Processing — Mutate, Clone, Terminal / HTML art
- Filters — fluent helpers and catalog
- Formats & encoders — JPEG/PNG/GIF/BMP/TGA/TIFF/ICO and plugins
- Migration — Structure.Sketching-era API removals
- ChromaLab — desktop showcase (download zips; not a NuGet package)