Конвертировать SVG в изображения в C# – JPG, PNG, WebP, BMP, TIFF и GIF

Чтобы конвертировать SVG в PNG, JPG, WebP, BMP, TIFF или GIF в C#, загрузите SVG с помощью SVGDocument, настройте ImageSaveOptions, при необходимости задайте выходной Format и вызовите Converter.ConvertSVG(). Используйте RenderTo() с ImageDevice, когда нужен явный контроль рендеринга.

В этой статье вы узнаете, как конвертировать SVG в форматы изображений: JPG, PNG, WebP, BMP, TIFF и GIF. Конвертация в изображения нужна для веб-разработки, дизайна, фотографии и других задач. Выбор формата зависит от того, будете ли вы печатать изображение, отправлять его по e-mail или размещать на веб-странице.

Статья дает общее описание возможностей конвертации в Aspose.SVG for .NET и описывает поддерживаемые сценарии SVG to Image с использованием классов Converter и SVGDocument. Полную карту конвертации см. в статьях Конвертировать SVG-файлы в C# и Поддерживаемые форматы файлов.

Способы конвертации SVG в изображения

Aspose.SVG for .NET поддерживает прямую конвертацию и workflow на основе rendering device. Оба подхода могут создавать растровый вывод, но подходят для разных архитектур приложений.

СценарийРекомендуемый APIКогда использовать
Конвертировать SVG-файл, поток, URL или документ в изображениеConverter.ConvertSVG() с ImageSaveOptionsЛучший вариант по умолчанию для обычной конвертации SVG в PNG, JPG, WebP, BMP, TIFF или GIF.
Рендерить существующий документ через image deviceSVGDocument.RenderTo() с ImageDevice и ImageRenderingOptionsПолезно, когда приложение уже управляет устройствами рендеринга или требует явной настройки рендеринга.
Задать формат изображения, фон, размер страницы, разрешение, antialiasing или TIFF compressionImageSaveOptions или ImageRenderingOptionsЭти параметры управляют растровым выводом без изменения исходного SVG.
Конвертировать SVG в web-, batch- или cloud-workflowsSVGDocument плюс потоковый ввод и выводПомогает избегать лишних временных файлов и упрощает обработку ошибок.

Какой формат изображения выбрать?

Формат выводаЛучше всего подходит дляПримечания
PNGИконки, UI-графика, screenshots, графика с прозрачностьюLossless-вывод и прозрачный фон – частые причины выбрать PNG.
JPG/JPEGФотографии или SVG-содержимое со встроенными фотографическими изображениямиНе сохраняет прозрачность; задайте BackgroundColor при конвертации прозрачного SVG. См. Изменение цвета фона SVG.
WebPВеб-доставка, когда нужны меньшие растровые файлыХорош для web-oriented вывода, если принимающая среда поддерживает WebP.
BMPПростой несжатый растровый выводОбычно создает большие файлы; редко лучший выбор для веб-доставки.
TIFFПечать, сканирование, архивирование и publishing workflowsИспользуйте параметры сжатия, если важен размер файла.
GIFПростой indexed-color вывод и legacy web workflowsНе заменяет рендеринг SVG-анимации; используйте, когда GIF требуется downstream-системой.

Онлайн-конвертер SVG

Вы можете конвертировать SVG в изображения и другие популярные форматы онлайн или программно. Проверьте работу Aspose.SVG API и конвертируйте SVG в режиме реального времени: загрузите SVG из локальной файловой системы, выберите выходной формат и запустите пример. В примере используются параметры сохранения по умолчанию. Вы сразу получите результат как отдельный файл.

                
            

Если вы хотите программно конвертировать SVG в форматы изображений, посмотрите следующие сценарии и примеры C#.

Конвертировать SVG в JPG

JPG – один из самых распространенных форматов изображений. Его особенность – управляемая потеря качества при сжатии. Поэтому он широко используется для хранения и передачи графического цифрового контента в вебе: фотографий, сканов и оцифрованных изображений. С Aspose.SVG можно программно конвертировать SVG в JPG, SVG в PNG, SVG в BMP, SVG в GIF или SVG в TIFF с полным контролем над широким набором параметров.

Использование метода ConvertSVG()

Методы ConvertSVG() – самый распространенный способ конвертировать SVG в разные популярные форматы. Следующий фрагмент кода показывает, как конвертировать SVG в JPG:

1using System.IO;
2using Aspose.Svg.Saving;
3using Aspose.Svg.Converters;
4using Aspose.Svg.Rendering.Image;
 1// Convert SVG to JPG in C# using ImageSaveOptions
 2
 3// Initialize an SVG document from a file
 4using (SVGDocument document = new SVGDocument(Path.Combine(DataDir, "owl-edited.svg")))
 5{
 6    // Initialize ImageSaveOptions
 7    ImageSaveOptions saveOptions = new ImageSaveOptions(ImageFormat.Jpeg);
 8
 9    // Convert SVG to JPG
10    Converter.ConvertSVG(document, saveOptions, Path.Combine(OutputDir, "owl-edited.jpg"));
11}

На рисунке показан файл owl-edited.jpg.

Файл owl-edited.svg, преобразованный в JPG

В статье Редактирование SVG с помощью CSS-селекторов вы можете увидеть C#-примеры того, как исходный файл owl.svg был изменен с помощью CSS-селекторов.

Использование метода RenderTo()

Рассмотрим конвертацию документа из SVG в JPG с помощью метода RenderTo():

Следующий пример показывает, как применить свойства Format и UseAntialiasing при конвертации SVG в JPG:

1using Aspose.Svg;
2using System.IO;
3using Aspose.Svg.Rendering;
4using Aspose.Svg.Rendering.Image;
 1// Render SVG to JPEG in C# with and without antialiasing
 2
 3// Initialize an SVG document from a file
 4using (SVGDocument document = new SVGDocument(Path.Combine(DataDir, "owl.svg")))
 5{
 6    // Set Format and UseAntialiasing for jpgOptions1
 7    ImageRenderingOptions jpegOptions1 = new ImageRenderingOptions(ImageFormat.Jpeg);
 8    jpegOptions1.UseAntialiasing = true;
 9
10    // Set Format and UseAntialiasing for jpgOptions2
11    ImageRenderingOptions jpegOptions2 = new ImageRenderingOptions(ImageFormat.Jpeg);
12    jpegOptions2.UseAntialiasing = false;
13
14    // Initialize an instance of the ImageDevice class
15    using (IDevice device = new ImageDevice(jpegOptions1, Path.Combine(OutputDir, "owl_out1.jpg")))
16    {
17        // Render SVG to JPG
18        document.RenderTo(device);
19    }
20    using (IDevice device = new ImageDevice(jpegOptions2, Path.Combine(OutputDir, "owl_out2.jpg")))
21    {
22        document.RenderTo(device);
23    }
24}

Конструктор ImageRenderingOptions() инициализирует экземпляр класса ImageRenderingOptions, который передается в конструктор ImageDevice(). Конструктор ImageDevice(options, file) принимает options, file и создает экземпляр класса ImageDevice. Метод RenderTo(device) принимает экземпляр ImageDevice и рендерит SVG в JPG.

Класс ImageRenderingOptions предоставляет множество свойств, которые дают полный контроль над параметрами и улучшают процесс конвертации SVG в JPG. Свойство Format задает формат изображения. По умолчанию это свойство равно Png. Чтобы конвертировать SVG в JPG, используйте ImageFormat.Jpeg.

Фрагменты изображений после рендеринга с разными настройками сглаживания

В примере выше файл owl.svg конвертируется в JPG с разными значениями UseAntialiasing. На рисунке показаны увеличенные на 250% фрагменты JPG: a) UseAntialiasing равно true; b) UseAntialiasing равно false.

Используйте UseAntialiasing = true, когда нужно повысить визуальное качество отрендеренных фигур, текста и изображений, особенно если важны четкость и гладкие края. Antialiasing сглаживает неровные края, смешивая цвета пикселей вокруг границ, поэтому результат выглядит мягче и аккуратнее.

Хотя UseAntialiasing = true улучшает визуальное качество, он может увеличить время обработки. Для приложений, где скорость рендеринга важнее, может быть оптимально использовать UseAntialiasing = false.

Класс ImageSaveOptions

Aspose.SVG позволяет конвертировать SVG в форматы изображений с параметрами сохранения по умолчанию или с пользовательскими настройками. Использование ImageSaveOptions позволяет настроить процесс рендеринга: формат изображения, размер страницы, поля, цвет фона и т. д.

СвойствоОписание
CompressionЗадает сжатие Tagged Image File Format (TIFF). По умолчанию используется LZW.
CSSВозвращает объект CssOptions, который используется для настройки обработки CSS-свойств.
FormatЗадает ImageFormat: JPG, PNG, WebP, BMP, TIFF или GIF. По умолчанию используется PNG.
BackgroundColorЗадает цвет, которым будет заполнен фон. По умолчанию значение Transparent.
PageSetupВозвращает объект настройки страницы и использует его для конфигурации набора выходных страниц.
HorizontalResolutionЗадает горизонтальное разрешение выходных изображений в пикселях на дюйм. Значение по умолчанию – 300 dpi.
VerticalResolutionЗадает вертикальное разрешение выходных изображений в пикселях на дюйм. Значение по умолчанию – 300 dpi.
UseAntialiasingУказывает, использовать ли antialiasing. По умолчанию antialiasing включен.
TextВозвращает объект TextOptions, который используется для настройки рендеринга текста.

Примечание: параметры, реализованные в классе ImageSaveOptions, наследуются от класса ImageRenderingOptions.

Конвертировать SVG в PNG

Формат PNG использует алгоритм сжатия без потерь для хранения растровых изображений. Он поддерживает цветовую модель RGB и не предназначен для полиграфической печати. PNG широко применяется для передачи изображений по сети и отображения фотографий и графики на веб-страницах и в облачных хранилищах.

Использование метода ConvertSVG()

Следующий фрагмент кода показывает, как подготовить SVG-файл с нуля и конвертировать его в PNG:

Следующий пример показывает, как использовать ImageSaveOptions и конвертировать SVG в PNG с пользовательскими параметрами сохранения:

1using Aspose.Svg;
2using System.IO;
3using Aspose.Svg.Saving;
4using Aspose.Svg.Converters;
 1// Convert SVG to PNG in C# with a custom background color
 2
 3// Prepare SVG code and save it to a file
 4string code = "<svg xmlns='http://www.w3.org/2000/svg'>" +
 5              "<circle cx='100' cy='150' r='50' stroke='#2F4F4F' stroke-width='4' fill='#FF7F50' />" +
 6              "<circle cx='180' cy='200' r='60' stroke='#2F4F4F' stroke-width='4' fill='#008B8B' />" +
 7              "</svg>";
 8File.WriteAllText("example.svg", code);
 9
10// Initialize an SVG document from the file
11using (SVGDocument document = new SVGDocument("example.svg"))
12{
13    // Initialize an instance of the ImageSaveOptions class and set the BackgroundColor property
14    ImageSaveOptions saveOptions = new ImageSaveOptions();
15    saveOptions.BackgroundColor = System.Drawing.Color.Gainsboro;
16
17    // Convert SVG to PNG
18    Converter.ConvertSVG(document, saveOptions, Path.Combine(OutputDir, "output.png"));
19}

В примере конструктор ImageSaveOptions() инициализирует экземпляр класса ImageSaveOptions, который передается методу ConvertSVG(). Метод ConvertSVG() принимает document, saveOptions, путь к выходному файлу и выполняет конвертацию SVG в PNG.

Примечание: для конвертации в PNG мы не задаем свойство Format. Конструктор ImageSaveOptions() использует Png как формат изображения по умолчанию.

Использование метода RenderTo()

Рассмотрим, как конвертировать SVG в PNG с помощью метода RenderTo():

1using Aspose.Svg;
2using System.IO;
3using Aspose.Svg.Rendering;
4using Aspose.Svg.Rendering.Image;
 1// Render SVG to PNG in C# using ImageDevice
 2
 3// Prepare a path to a source SVG file
 4string documentPath = Path.Combine(DataDir, "snowflake.svg");
 5
 6// Initialize an SVG document from the file
 7using (SVGDocument document = new SVGDocument(documentPath))
 8{
 9    // Create the ImageDevice, set image Format and specify an output file to render
10    using (IDevice device = new ImageDevice(new ImageRenderingOptions(), Path.Combine(OutputDir, "snowflake.png")))
11    {
12        // Render SVG to PNG
13        document.RenderTo(device);
14    }
15}

Конструктор ImageRenderingOptions() инициализирует экземпляр класса ImageRenderingOptions, который передается в конструктор ImageDevice(). Конструктор ImageDevice(options, file) принимает options, file и создает экземпляр ImageDevice. Метод RenderTo(device) принимает экземпляр ImageDevice и рендерит SVG в PNG.

На рисунке показан файл snowflake.png.

Файл snowflake.svg, преобразованный в PNG

Конвертировать SVG в BMP

BMP-файлы сохраняют качество изображения и хранят цветовые данные для каждого пикселя без сжатия, но из-за большого размера плохо подходят для веба. Этот формат также не подходит для prepress, так как ограничен RGB.

Aspose.SVG API может конвертировать документ из SVG в BMP за несколько шагов:

1using Aspose.Svg;
2using System.IO;
3using Aspose.Svg.Rendering;
4using Aspose.Svg.Rendering.Image;
 1// Convert SVG to BMP in C# using ImageDevice
 2
 3// Open a source SVG document
 4using (SVGDocument document = new SVGDocument(documentPath))
 5{
 6    // Create ImageDevice, set image Format and specify an output file to render
 7    using (IDevice device = new ImageDevice(new ImageRenderingOptions(ImageFormat.Bmp), Path.Combine(OutputDir, "conclusion_out.bmp")))
 8    {
 9        // Render SVG to BMP
10        document.RenderTo(device);
11    }
12}

Конструктор ImageRenderingOptions() инициализирует экземпляр ImageRenderingOptions, который передается в конструктор ImageDevice(). Конструктор ImageDevice(options, file) принимает options, file и создает экземпляр ImageDevice. Метод RenderTo(device) принимает экземпляр ImageDevice и рендерит SVG в BMP.

Конвертировать SVG в TIFF

TIFF – формат для хранения растровых изображений с широкой палитрой цветов. TIFF поддерживается сканерами, fax-приложениями, текстовыми процессорами, OCR, инструментами обработки изображений и page-layout приложениями. Он широко используется в полиграфии и журнальной офсетной печати.

Aspose.SVG API может конвертировать документ из SVG в TIFF за несколько шагов:

1using Aspose.Svg;
2using System.IO;
3using Aspose.Svg.Rendering;
4using Aspose.Svg.Rendering.Image;
 1// Convert SVG to TIFF in C# with custom settings
 2
 3// Open a source SVG document
 4using (SVGDocument document = new SVGDocument(Path.Combine(DataDir, "conclusion.svg")))
 5{
 6    // Initialize an instance of the ImageRenderingOptions class and set the Format and Compression properties
 7    ImageRenderingOptions tiffOptions = new ImageRenderingOptions(ImageFormat.Tiff);
 8    tiffOptions.Compression = Compression.None;
 9
10    // Initialize an instance of the ImageDevice class and specify an output file to render
11    using (IDevice device = new ImageDevice(tiffOptions, Path.Combine(OutputDir, "conclusion.tiff")))
12    {
13        // Render SVG to TIFF
14        document.RenderTo(device);
15    }
16}

Конструктор ImageRenderingOptions() инициализирует экземпляр ImageRenderingOptions, который передается в конструктор ImageDevice(). Конструктор ImageDevice(options, file) принимает options, file и создает экземпляр ImageDevice. Метод RenderTo(device) принимает экземпляр ImageDevice и рендерит SVG в TIFF.

Класс ImageRenderingOptions предоставляет множество свойств для контроля параметров и улучшения процесса конвертации SVG в TIFF. Например, свойство Compression позволяет задать сжатие для TIFF. В примере выше используется Compression.None.

Конвертировать SVG в GIF

GIF – популярный формат изображений, который поддерживает анимированные изображения и часто используется в веб-публикации. Следующий фрагмент кода показывает, как конвертировать SVG в GIF с помощью Aspose.SVG for .NET API:

Следующий пример показывает, как использовать ImageSaveOptions и создать выходное изображение с пользовательскими характеристиками PageSetup:

1using Aspose.Svg;
2using System.IO;
3using Aspose.Svg.Drawing;
4using Aspose.Svg.Saving;
5using Aspose.Svg.Converters;
6using Aspose.Svg.Rendering.Image;
 1// Convert SVG to GIF in C# with custom settings
 2
 3// Initialize an SVG document from a file
 4using (SVGDocument document = new SVGDocument(Path.Combine(DataDir, "owl.svg")))
 5{
 6    // Initialize an instance of the ImageSaveOptions class and set the PageSetup property
 7    ImageSaveOptions saveOptions = new ImageSaveOptions(ImageFormat.Gif);
 8    saveOptions.PageSetup.AnyPage = new Page(new Drawing.Size(400, 600), new Margin(20, 20, 20, 20));
 9
10    // Convert SVG to GIF
11    Converter.ConvertSVG(document, saveOptions, Path.Combine(OutputDir, "owl.gif"));
12}

Конвертировать SVGZ в PNG в C#

SVGZ – это сжатый SVG-файл, а не отдельная модель рисования. Aspose.SVG for .NET может загружать .svgz файлы через SVGDocument; после этого документ можно рендерить в PNG с тем же workflow ImageSaveOptions и Converter.ConvertSVG(), который используется для SVG:

1using Aspose.Svg;
2using Aspose.Svg.Converters;
3using Aspose.Svg.Saving;
4
5using (var document = new SVGDocument("input.svgz"))
6{
7    var options = new ImageSaveOptions();
8    Converter.ConvertSVG(document, options, "output.png");
9}

PNG – формат изображения по умолчанию для ImageSaveOptions, поэтому свойство Format не требуется для конвертации SVGZ в PNG. Используйте этот workflow, когда нужны миниатюры, растровые превью или веб-изображения из сжатых SVG-assets. Если перед рендерингом нужна редактируемая разметка, см. Конвертировать SVGZ в SVG в C#.

Практические рекомендации

При конвертации SVG в растровые изображения в production-приложении .NET явно задавайте формат вывода, размеры, разрешение, фон и доступ к ресурсам. Это помогает сохранять стабильность миниатюр, превью, отчетов и веб-изображений в локальной разработке, на серверах и в контейнерах.

Production-задачаРекомендация
Генерировать web thumbnailsИспользуйте PNG или WebP, задайте PageSetup и выберите предсказуемый фон для прозрачного SVG. См. Изменение размера документа при конвертации из SVG.
Конвертировать загруженные SVG-файлыЗагружайте из потока или контролируемого хранилища, проверяйте SVG и записывайте выходное изображение в управляемое приложением хранилище. См. Создание, загрузка и чтение SVG-файлов в C#.
Сохранить прозрачностьВыбирайте PNG или WebP и оставляйте BackgroundColor прозрачным. Избегайте JPG, если прозрачность обязательна. Про фон см. Фон SVG.
Создать JPG из прозрачного SVGЗадайте BackgroundColor, потому что JPG не поддерживает alpha transparency.
Обрабатывать много SVG-файловОсвобождайте экземпляры SVGDocument, обрабатывайте ошибки по файлам и не держите большие SVG или растровые результаты в памяти дольше, чем нужно.
Стабилизировать текстовый выводУбедитесь, что нужные шрифты доступны или встроены. Отсутствующие шрифты могут изменить метрики текста и итоговый макет изображения. См. Работа со SVG-шрифтами и текстом в C#.

Типичные ошибки и решения

ПроблемаЧастая причинаРешение
Выходное изображение имеет неправильный размерВ SVG нет явных width, height или viewBox, либо не задан output page setupЗадайте размеры SVG или PageSetup в ImageSaveOptions или ImageRenderingOptions. См. SVG viewBox и Изменение размера документа.
Прозрачный SVG становится черным, белым или неожиданным в JPGJPG не поддерживает прозрачностьИспользуйте PNG/WebP для прозрачности или задайте BackgroundColor перед сохранением в JPG. См. Изменение цвета фона SVG.
Линии или текст выглядят зубчатымиAntialiasing отключен или разрешение вывода слишком низкоеИспользуйте UseAntialiasing = true и подходящее горизонтальное и вертикальное разрешение. См. Качество рендеринга SVG и согласованность результата.
Внешние изображения, шрифты или CSS отсутствуютСвязанные ресурсы недоступны во время конвертацииИспользуйте доступные пути к ресурсам, встраивайте assets или настройте runtime environment для разрешения зависимостей. См. Исправление проблем со стилями и шрифтами SVG в C#.
TIFF-файлы слишком большиеНесжатый TIFF-вывод или растровое содержимое с высоким разрешениемНастройте TIFF Compression, проверьте нужное разрешение вывода и по возможности оптимизируйте исходный SVG. См. Оптимизация SVG-файлов для веба и производительности.
Результат отличается между developer machine и serverШрифты, пути к файлам или доступ к ресурсам различаются по средамНастройте шрифты и расположение ресурсов одинаково для Windows, Linux, Docker и cloud deployments. См. Environment Configuration.

FAQ

Можно ли конвертировать SVG, созданный или измененный в памяти?
Да. Создайте или обновите SVGDocument, настройте ImageSaveOptions и передайте экземпляр документа в Converter.ConvertSVG(). Это полезно, когда вы редактируете SVG-элементы, стили или цвета перед финальным рендерингом.

Можно ли изменить SVG перед рендерингом в изображение?
Да. Сначала можно обновить SVG DOM, например с помощью CSS-селекторов, а затем отрендерить измененный документ. См. Редактирование SVG с помощью CSS-селекторов в C#.

Сохраняет ли SVG to image conversion векторные данные?
Нет. PNG, JPG, WebP, BMP, TIFF и GIF – растровые форматы вывода. Результат содержит пиксельные данные. Если нужно сохранить редактируемую векторную разметку, сохраняйте документ как SVG или используйте SVGZ-сжатие.

Можно ли использовать тот же код в серверном приложении?
Да. Серверные приложения обычно загружают SVG из файла, потока, URL или сгенерированной строки, а затем записывают отрендеренное изображение в управляемое приложением хранилище. Для стабильного результата явно настройте шрифты, пути к ресурсам и размеры вывода.

С чего начать, если отрендеренное изображение отличается от исходного SVG?
Проверьте размеры, viewBox, шрифты, связанные ресурсы, CSS, цвет фона и antialiasing. Таблица Типичные ошибки и решения выше ведет к наиболее полезным troubleshooting-статьям.

Связанные материалы

Вы можете попробовать наш бесплатный онлайн SVG to JPG Converter, который работает качественно, просто и быстро. Загрузите файл, выполните конвертацию и получите результат за несколько секунд!

Онлайн-конвертер SVG в JPG