PictureSharp 0.7.8

PictureSharp

A pure managed image processing library for .NET. No native dependencies.

PictureSharp reads, writes and processes JPEG, PNG, WebP, GIF, BMP, ICO and PCX in 100% C# for .NET 10 and later, with no NuGet dependencies, native libraries or P/Invoke. Output is verified pixel for pixel against libwebp, libjpeg-turbo and Pillow.

Every format except TIFF is both read and written. Variants and options for each one are listed in Loading and saving.

¹ With the PictureSharp.Heif plugin package, also 100% C#: dotnet add package PictureSharp.Heif.

² Read only, with the PictureSharp.Tiff plugin, also 100% C#: classic TIFF and BigTIFF with LZW, Deflate, PackBits, JPEG and CCITT compression. Not on NuGet yet.

• Resizing, geometry, color adjustments, filters, compositing and EXIF auto-orientation
• Levels, gamma, auto contrast, histograms, trimming, alpha masks and W3C blend modes
• Photo adjustments: exposure, white balance, shadows/highlights, clarity, vibrance, vignette and edge-preserving denoise
• Conversion of ICC and PNG color descriptions to sRGB, linear-light resize and compositing
• Fast JPEG thumbnails decoded at 1/2, 1/4 or 1/8 scale
• Frame-by-frame reading and writing of GIF, APNG and WebP animations
• Typed EXIF and ICC/XMP metadata, editable without recompressing the image
• HDR photos with gain maps (ISO 21496-1, Apple): reconstruction, tone mapping, editing and saving as JPEG
• Limits for untrusted input and cancellation of all long-running work
• SIMD on x64 and ARM64, bit-identical to the scalar code
• Extensible with format plugins (including HDR gain maps and metadata) and custom processors
• Optional adapter packages for System.Drawing, SkiaSharp and ASP.NET Core

Quick start

using PictureSharp;

using var image = await Image.LoadAsync("photo.jpg");
image.Mutate(x => x
    .AutoOrient()
    .Resize(1600, 0)                 // 0 keeps the aspect ratio
    .UnsharpMask());
await image.SaveAsync("photo.webp");  // the format comes from the extension

using Image thumbnail = image.Clone(x => x.Thumbnail(256, 256));
thumbnail.Save("thumbnail.png");

Mutate edits the image; Clone returns an edited copy.

Documentation

The public API may still change between 0.x releases.

• Getting started
• Loading and saving · Limits and cancellation
• Image processing · Encoder options · Pixels and interop
• Animation · Metadata · Color management · HDR photos · ICO icons
• Adapters: System.Drawing, SkiaSharp, ASP.NET Core
• Extending PictureSharp · Architecture · Performance
• Command-line sample · Migrating from 0.5.0 · Development · Release notes

Building from source

dotnet build -c Release
dotnet test -c Release

License

PictureSharp is licensed under MIT. It includes ports from libwebp, libjpeg-turbo, zlib and Pillow, and is based in part on the work of the Independent JPEG Group; see THIRD-PARTY-NOTICES.txt.