Skip to content

Processing ​

ChromaFx uses an explicit Mutate / Clone model instead of silent in-place helpers.

Mutate vs Clone ​

csharp
// In-place
image.Mutate(ctx => ctx.Resize(800, 600).Brightness(0.1f));

// New image; original unchanged
var copy = image.Clone(ctx => ctx.Rotate(90).Invert());

Fluent context ​

Core ops live on IImageProcessingContext. More filters arrive via extensions (BoxBlur, Saturation, Dilate, Grayscale, …). Escape hatch:

csharp
image.Mutate(ctx => ctx.Apply(myFilter));

See the filters catalog for the full list.

Pixel art ​

Opt-in ChromaFx.PixelArt (Scale2x / Scale3x / Hq2x–4x / CleanEdge / Eagle / SaI / RotateSprite / CleanEdgeRotate) — see the filters guide.

Retro ​

Adaptive palette: Quantize(maxColors, dither?) (shared Core octree; DitherMethod Bayer / Floyd–Steinberg). Fixed retro palettes: opt-in ChromaFx.Retro (WebSafeQuantize, CgaQuantize, … with Core OrderedDitherMethod) — see the filters guide.

Terminal art ​

ChromaFx.Processing.Terminal renders images for TUIs (album-art panels, previews). The meta-package injects this namespace automatically.

csharp
// Grayscale ramp (dark terminal)
var ascii = image.ToAsciiArt(new AsciiArtOptions
{
    MaxWidth = 40,
    Invert = true,
});

// Truecolor half-blocks in a fixed 24×12 panel
var ansi = cover.ToAnsiArt(new AnsiArtOptions
{
    MaxWidth = 24,
    MaxHeight = 12,
    SizeMode = TerminalArtSizeMode.Exact,
    BackgroundColor = new Color(0, 0, 0),
});
OptionNotes
SizeModeFit (default) or Exact letterbox (requires both maxima)
CharacterAspect0 = auto → 2 (typical monospace cell height/width); half-block ▀ still uses 2
UseHalfBlocksANSI only; ▀ with FG+BG (default) or █ with FG
ColorModeANSI TrueColor or Ansi256
Invert / CharactersASCII ramp; Invert also picks black bg when BackgroundColor is unset

For frequent redraws, reuse a StringBuilder with AppendAsciiArt / AppendAnsiArt (or Write*Art into an IBufferWriter<char>) instead of allocating a new string each time.

Inline images (Kitty / iTerm2):

csharp
var png = image.ToByteArray(ManagedFormats.Png);
Console.Write(KittyGraphics.FromPng(png, columns: 24, rows: 12));
// or ITerm2InlineImage.FromPng(png, ...)

Use TerminalImageCapabilities.Detect() to choose a protocol.

HTML art ​

ChromaFx.Processing.HtmlArt emits the same half-block / full-block grid as ANSI art, but as fixed-width colored HTML (<pre> + merged <span> CSS colors). Also injected by the meta-package.

csharp
var html = image.ToHtmlArt(new HtmlArtOptions
{
    MaxWidth = 48,
    MaxHeight = 24,
    SizeMode = TerminalArtSizeMode.Exact,
});
bash
# from the library repo (github.com/chromafx/chromafx)
dotnet run --project samples/TextArt

Performance notes ​

Hot paths lean on Span<T>, ArrayPool, and SIMD where it pays off. Native codecs can still win raw pixel throughput; ChromaFx prioritizes deployability and allocation-conscious decode → filter → encode loops. Measure with tests/ChromaFx.Benchmarks in the library repo.

Released under the Apache License 2.0.