Analyzing your prompt, please hold on...
An error occurred while retrieving the results. Please refresh the page and try again.
Чтобы конвертировать 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# и Поддерживаемые форматы файлов.
Aspose.SVG for .NET поддерживает прямую конвертацию и workflow на основе rendering device. Оба подхода могут создавать растровый вывод, но подходят для разных архитектур приложений.
| Сценарий | Рекомендуемый API | Когда использовать |
|---|---|---|
| Конвертировать SVG-файл, поток, URL или документ в изображение | Converter.ConvertSVG() с ImageSaveOptions | Лучший вариант по умолчанию для обычной конвертации SVG в PNG, JPG, WebP, BMP, TIFF или GIF. |
| Рендерить существующий документ через image device | SVGDocument.RenderTo() с ImageDevice и ImageRenderingOptions | Полезно, когда приложение уже управляет устройствами рендеринга или требует явной настройки рендеринга. |
| Задать формат изображения, фон, размер страницы, разрешение, antialiasing или TIFF compression | ImageSaveOptions или ImageRenderingOptions | Эти параметры управляют растровым выводом без изменения исходного SVG. |
| Конвертировать SVG в web-, batch- или cloud-workflows | SVGDocument плюс потоковый ввод и вывод | Помогает избегать лишних временных файлов и упрощает обработку ошибок. |
| Формат вывода | Лучше всего подходит для | Примечания |
|---|---|---|
| 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 в изображения и другие популярные форматы онлайн или программно. Проверьте работу Aspose.SVG API и конвертируйте SVG в режиме реального времени: загрузите SVG из локальной файловой системы, выберите выходной формат и запустите пример. В примере используются параметры сохранения по умолчанию. Вы сразу получите результат как отдельный файл.
Если вы хотите программно конвертировать SVG в форматы изображений, посмотрите следующие сценарии и примеры C#.
JPG – один из самых распространенных форматов изображений. Его особенность – управляемая потеря качества при сжатии. Поэтому он широко используется для хранения и передачи графического цифрового контента в вебе: фотографий, сканов и оцифрованных изображений. С Aspose.SVG можно программно конвертировать SVG в JPG, SVG в PNG, SVG в BMP, SVG в GIF или SVG в TIFF с полным контролем над широким набором параметров.
Методы 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.

В статье Редактирование SVG с помощью CSS-селекторов вы можете увидеть C#-примеры того, как исходный файл owl.svg был изменен с помощью CSS-селекторов.
Рассмотрим конвертацию документа из 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.
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.
Формат PNG использует алгоритм сжатия без потерь для хранения растровых изображений. Он поддерживает цветовую модель RGB и не предназначен для полиграфической печати. PNG широко применяется для передачи изображений по сети и отображения фотографий и графики на веб-страницах и в облачных хранилищах.
Следующий фрагмент кода показывает, как подготовить 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 как формат изображения по умолчанию.
Рассмотрим, как конвертировать SVG в PNG с помощью метода RenderTo():
device).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.

BMP-файлы сохраняют качество изображения и хранят цветовые данные для каждого пикселя без сжатия, но из-за большого размера плохо подходят для веба. Этот формат также не подходит для prepress, так как ограничен RGB.
Aspose.SVG API может конвертировать документ из SVG в BMP за несколько шагов:
Format.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.
TIFF – формат для хранения растровых изображений с широкой палитрой цветов. TIFF поддерживается сканерами, fax-приложениями, текстовыми процессорами, OCR, инструментами обработки изображений и page-layout приложениями. Он широко используется в полиграфии и журнальной офсетной печати.
Aspose.SVG API может конвертировать документ из SVG в TIFF за несколько шагов:
Format и другие свойства документа.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.
GIF – популярный формат изображений, который поддерживает анимированные изображения и часто используется в веб-публикации. Следующий фрагмент кода показывает, как конвертировать SVG в GIF с помощью Aspose.SVG for .NET API:
Format и другие параметры сохранения.Следующий пример показывает, как использовать 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 – это сжатый 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 становится черным, белым или неожиданным в JPG | JPG не поддерживает прозрачность | Используйте 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. |
Можно ли конвертировать 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, который работает качественно, просто и быстро. Загрузите файл, выполните конвертацию и получите результат за несколько секунд!
Analyzing your prompt, please hold on...
An error occurred while retrieving the results. Please refresh the page and try again.