Skip to content

oneimage docs

Everything about OneImage: install and first steps, the guide, the add-on packages, drawing and layers, migrating from ImageSharp and System.Drawing, how it compares, and the reference pages.

OneImage 1.10.1Markdown All docs as one file

Start

Getting startedInstall OneImage, make a first thumbnail, convert formats, load, edit and save, and serve resized images from ASP.NET Core.GuideThe lazy model, errors, sources and lifetime, saving, every operation, Canvas and pixel access, metadata, color, animation, limits, threading, AOT and formats.

Packages

OneImage.Web (ASP.NET Core)Image processing for ASP.NET Core: URL commands, ImageSharp.Web compatibility, security defaults, signed URLs, the disk cache, providers and hooks.OneImage.TextFonts, OpenType shaping, right-to-left and complex scripts, line breaking, rich text, color fonts, vertical layout and hinting.OneImage.SvgSVG and SVGZ as an image format drawn at the size you ask for, what it supports, and how it is checked against the SVG test suite.OneImage.PsdRead PSD and PSB as an image, load the layers into a document, edit them and write them back, and the known limitations.OneImage.PdfPDF pages as an image format, drawn per tile at the size you ask for, with its options, limits and render checks.

Drawing and layers

DrawingVector drawing in the core package: paths, the rasterizer, brushes, pens and strokes, boolean operations and clipping, and the ImageSharp.Drawing names.LayersLayered documents in the core package: pixel, group, fill and adjustment layers, masks, clipping, blend modes, layer styles and render on demand.

Migrating

From ImageSharp and System.DrawingPort ImageSharp and System.Drawing code to OneImage: concepts that differ, common tasks side by side, and each ImageSharp API with what OneImage has instead.

Choosing

ComparisonHow OneImage compares with ImageSharp, SkiaSharp, Magick.NET and NetVips, where it is the better fit and where one of the others is.PerformanceBenchmarks against ImageSharp and the native wrappers: time and peak memory for every task, the ties and losses, and the method.

Reference

JBIG2 decodingThe JBIG2 decoder in the core package, used for scanned PDF pages: what is decoded, strictness, limits, conformance and speed.JPEG 2000 decodingThe JPEG 2000 decoder in the core package, used for PDF images: what is decoded, behavior, limits, testing and speed.PDF spec-truth testsHow the PDF renderer is tested against pages whose correct pixels follow from the specification, with the tolerances and known failures.ChangelogEvery release of the OneImage packages: what was added, changed and fixed.

Migration guides

All migration guidesFrom ImageSharp, SkiaSharp, System.Drawing or ImageSharp.Web, with code side by side.Migrate from ImageSharpImageSharp code and its OneImage equivalent, side by side.Migrate from SkiaSharpFrom SKBitmap and SKCanvas to Image and Canvas: resizing, cropping, encoders, drawing, text, SVG and ASP.NET Core.