ImageSharp для C# (.NET): полное руководство с примерами

1. Что это и зачем нужна?

ImageSharp — это мощная, полностью управляемая, кроссплатформенная библиотека для обработки изображений, написанная на C# для экосистемы .NET. Она является частью семейства библиотек SixLabors и предоставляет разработчикам чистый, безопасный и высокопроизводительный API для работы с изображениями без необходимости использования внешних нативных зависимостей (таких как ImageMagick, SkiaSharp или GDI+). Это означает, что ImageSharp работает одинаково хорошо на Windows, Linux и macOS, что делает её идеальным выбором для веб-приложений (ASP.NET Core), микросервисов, консольных утилит и мобильных приложений (через Xamarin/MAUI).

Зачем нужна ImageSharp? В современной разработке обработка изображений требуется повсеместно: от создания миниатюр для галерей и изменения размера аватарок пользователей до наложения водяных знаков, применения фильтров и конвертации форматов. ImageSharp предлагает всё это "из коробки" с акцентом на производительность и безопасность. В отличие от устаревшего System.Drawing, который привязан к Windows и имеет проблемы с потоками, ImageSharp является потокобезопасной и полностью кроссплатформенной. Она также активно поддерживается сообществом и имеет подробную документацию.

Ключевые возможности библиотеки включают: загрузку и сохранение изображений в популярных форматах (JPEG, PNG, BMP, GIF, WebP, TIFF), изменение размера, обрезку, поворот, отражение, наложение текста и фигур, применение цветовых матриц, фильтров (размытие, резкость, сепия, чёрно-белое), работу с EXIF-данными, анимацию GIF и многое другое. ImageSharp построена на концепции Image как контейнера для пиксельных данных и предоставляет гибкий API через методы расширения.

2. Установка

Установка ImageSharp в проект .NET выполняется через менеджер пакетов NuGet. Выполните одну из следующих команд в терминале или консоли диспетчера пакетов:

// Через .NET CLI (рекомендуется)
dotnet add package SixLabors.ImageSharp

// Через Package Manager Console
Install-Package SixLabors.ImageSharp

// Через NuGet Package Manager в Visual Studio/Rider
// Ищите "SixLabors.ImageSharp" и установите последнюю стабильную версию

После установки добавьте директиву using в начало вашего файла:

using SixLabors.ImageSharp;
using SixLabors.ImageSharp.Processing;
using SixLabors.ImageSharp.Formats.Jpeg;
using SixLabors.ImageSharp.PixelFormats;

3. Быстрый старт — минимальный рабочий пример

Первый пример: загружаем изображение, изменяем его размер до 300x300 пикселей и сохраняем в формате JPEG с качеством 75%.

using SixLabors.ImageSharp;
using SixLabors.ImageSharp.Processing;
using SixLabors.ImageSharp.Formats.Jpeg;

string inputPath = "input.jpg";
string outputPath = "output_resized.jpg";

using (Image image = Image.Load(inputPath))
{
    // Изменяем размер, сохраняя пропорции
    image.Mutate(x => x.Resize(300, 300));

    // Сохраняем с настройками качества
    var encoder = new JpegEncoder { Quality = 75 };
    image.Save(outputPath, encoder);
}

Console.WriteLine("Изображение успешно обработано!");

Этот код загружает изображение, применяет мутацию (изменение размера) и сохраняет результат. Обратите внимание на использование using — ImageSharp реализует IDisposable для освобождения ресурсов.

4. Основные методы и классы

Ниже представлены ключевые методы и классы ImageSharp с сигнатурами, описанием и примерами кода.

using SixLabors.ImageSharp;
using SixLabors.ImageSharp.PixelFormats;

// Загрузка с явным указанием типа пикселя
using (Image<Rgba32> image = Image.Load<Rgba32>("photo.jpg"))
{
    Console.WriteLine($"Размер: {image.Width}x{image.Height}");
}

// Загрузка без указания типа (автоматически Rgba32)
using (Image image = Image.Load("photo.jpg"))
{
    Console.WriteLine($"Формат: {image.Metadata.DecodedImageFormat?.Name}");
}

using SixLabors.ImageSharp;
using SixLabors.ImageSharp.Formats.Png;
using SixLabors.ImageSharp.Formats.Webp;

using (Image image = Image.Load("input.jpg"))
{
    // Сохранение в PNG
    image.Save("output.png");

    // Сохранение в WebP с настройками
    var webpEncoder = new WebpEncoder { Quality = 80, FileFormat = WebpFileFormatType.Lossy };
    image.Save("output.webp", webpEncoder);
}

using SixLabors.ImageSharp;
using SixLabors.ImageSharp.Processing;

using (Image image = Image.Load("input.jpg"))
{
    image.Mutate(ctx => ctx
        .Resize(800, 600)
        .Grayscale()
        .Rotate(45));
    image.Save("output_modified.jpg");
}

using SixLabors.ImageSharp;
using SixLabors.ImageSharp.Processing;

using (Image image = Image.Load("input.jpg"))
{
    // Изменение размера с сохранением пропорций (Pad)
    image.Mutate(x => x.Resize(new ResizeOptions
    {
        Size = new Size(200, 200),
        Mode = ResizeMode.Pad, // Добавляет фон, если пропорции не совпадают
        PadColor = Color.White
    }));
    image.Save("output_pad.jpg");
}

using SixLabors.ImageSharp;
using SixLabors.ImageSharp.Processing;

using (Image image = Image.Load("input.jpg"))
{
    // Обрезка центральной части 300x300
    int x = (image.Width - 300) / 2;
    int y = (image.Height - 300) / 2;
    image.Mutate(ctx => ctx.Crop(new Rectangle(x, y, 300, 300)));
    image.Save("output_cropped.jpg");
}

using SixLabors.ImageSharp;
using SixLabors.ImageSharp.Processing;

using (Image image = Image.Load("input.jpg"))
{
    image.Mutate(x => x.Grayscale());
    image.Save("output_grayscale.jpg");
}

using SixLabors.ImageSharp;
using SixLabors.ImageSharp.Processing;

using (Image image = Image.Load("input.jpg"))
{
    // Поворот на 90 градусов
    image.Mutate(x => x.Rotate(90));
    image.Save("output_rotated.jpg");

    // Поворот на 180 и отражение по горизонтали
    image.Mutate(x => x.RotateFlip(RotateMode.Rotate180, FlipMode.Horizontal));
    image.Save("output_flip.jpg");
}

using SixLabors.ImageSharp;
using SixLabors.ImageSharp.Processing;
using SixLabors.Fonts;
using SixLabors.ImageSharp.Drawing.Processing;

// Установите пакет: dotnet add package SixLabors.Fonts
using (Image image = Image.Load("input.jpg"))
{
    FontFamily fontFamily = SystemFonts.Get("Arial");
    Font font = new Font(fontFamily, 48, FontStyle.Bold);

    image.Mutate(ctx => ctx.DrawText(
        "Hello, ImageSharp!",
        font,
        Color.Red,
        new PointF(50, 50)));
    image.Save("output_text.jpg");
}

using SixLabors.ImageSharp;
using SixLabors.ImageSharp.Processing;

using (Image original = Image.Load("input.jpg"))
{
    // Создаём миниатюру, не изменяя оригинал
    using (Image thumbnail = original.Clone(ctx => ctx.Resize(150, 150)))
    {
        thumbnail.Save("thumbnail.jpg");                    

Также в библиотеке

Интернационализация (i18n) в TypeScript: полное руководство Работа с изображениями в Java: от чтения до обработки nlohmann/json для C++: полное руководство с примерами Spectre.Console для C# (.NET): полное руководство с примерами gRPC для TypeScript: библиотеки, настройка и примеры кода