---
title: "oneimage docs"
url: https://recursiveai.org/oneimage/docs/
description: "Everything about OneImage: install and first steps, the guide, the add-on packages, drawing and layers, migrating from ImageSharp and System.Drawing, how…"
version: "1.10.1"
---

# 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.

## Start

- [Getting started](https://recursiveai.org/oneimage/docs/getting-started/index.md): Install OneImage, make a first thumbnail, convert formats, load, edit and save, and serve resized images from ASP.NET Core.
- [Guide](https://recursiveai.org/oneimage/docs/guide/index.md): The 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)](https://recursiveai.org/oneimage/docs/web/index.md): Image processing for ASP.NET Core: URL commands, ImageSharp.Web compatibility, security defaults, signed URLs, the disk cache, providers and hooks.
- [OneImage.Text](https://recursiveai.org/oneimage/docs/text/index.md): Fonts, OpenType shaping, right-to-left and complex scripts, line breaking, rich text, color fonts, vertical layout and hinting.
- [OneImage.Svg](https://recursiveai.org/oneimage/docs/svg/index.md): SVG 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.Psd](https://recursiveai.org/oneimage/docs/psd/index.md): Read PSD and PSB as an image, load the layers into a document, edit them and write them back, and the known limitations.
- [OneImage.Pdf](https://recursiveai.org/oneimage/docs/pdf/index.md): PDF pages as an image format, drawn per tile at the size you ask for, with its options, limits and render checks.

## Drawing and layers

- [Drawing](https://recursiveai.org/oneimage/docs/drawing/index.md): Vector drawing in the core package: paths, the rasterizer, brushes, pens and strokes, boolean operations and clipping, and the ImageSharp.Drawing names.
- [Layers](https://recursiveai.org/oneimage/docs/layers/index.md): Layered 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.Drawing](https://recursiveai.org/oneimage/docs/migrating/index.md): Port 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

- [Comparison](https://recursiveai.org/oneimage/docs/comparison/index.md): How OneImage compares with ImageSharp, SkiaSharp, Magick.NET and NetVips, where it is the better fit and where one of the others is.
- [Performance](https://recursiveai.org/oneimage/docs/performance/index.md): Benchmarks against ImageSharp and the native wrappers: time and peak memory for every task, the ties and losses, and the method.

## Reference

- [JBIG2 decoding](https://recursiveai.org/oneimage/docs/jbig2/index.md): The JBIG2 decoder in the core package, used for scanned PDF pages: what is decoded, strictness, limits, conformance and speed.
- [JPEG 2000 decoding](https://recursiveai.org/oneimage/docs/jpx/index.md): The JPEG 2000 decoder in the core package, used for PDF images: what is decoded, behavior, limits, testing and speed.
- [PDF spec-truth tests](https://recursiveai.org/oneimage/docs/pdf-spec-truth/index.md): How the PDF renderer is tested against pages whose correct pixels follow from the specification, with the tolerances and known failures.
- [Changelog](https://recursiveai.org/oneimage/docs/changelog/index.md): Every release of the OneImage packages: what was added, changed and fixed.

## Migration guides

- [All migration guides](https://recursiveai.org/oneimage/migrate/index.md): From ImageSharp, SkiaSharp, System.Drawing or ImageSharp.Web, with code side by side.
- [Migrate from ImageSharp](https://recursiveai.org/oneimage/articles/migrate-from-imagesharp/index.md): ImageSharp code and its OneImage equivalent, side by side.
- [Migrate from SkiaSharp](https://recursiveai.org/oneimage/articles/migrate-from-skiasharp/index.md): From SKBitmap and SKCanvas to Image and Canvas: resizing, cropping, encoders, drawing, text, SVG and ASP.NET Core.