Конвертировать SVG в изображение в Python

Quick Answer: Загрузите SVG через SVGDocument, создайте ImageSaveOptions, задайте формат изображения и вызовите Converter.convert_svg(document, options, output_path). Используйте ImageSaveOptions, чтобы управлять цветом фона, размером страницы, полями и разрешением.

Конвертация SVG в изображение в Python

Aspose.SVG for Python via .NET может конвертировать SVG-документы в растровые форматы, такие как JPG, BMP, TIFF, GIF и PNG. Используйте JPG, когда прозрачность не нужна, PNG – для прозрачного растрового вывода, TIFF – для издательских задач и обработки изображений, BMP – для простого растрового вывода, GIF – для легковесного растрового вывода.

Для отдельных руководств см. Конвертировать SVG в PNG в Python и Конвертировать SVG в JPG в Python. Эта статья фокусируется на общем сценарии SVG-to-image и выборе формата.

Перед запуском примеров установите Aspose.SVG for Python via .NET в вашей Python-среде.

Пример: конвертация SVG в JPG с помощью Converter.convert_svg()

Следующий пример использует SVGDocument, ImageSaveOptions и Converter.convert_svg(), чтобы конвертировать SVG-файл в JPG и задать пользовательский фон, размер страницы, поля и разрешение. JPG не поддерживает прозрачность, поэтому цвет фона обычно важно задавать явно.

import os
from aspose.svg import SVGDocument
from aspose.svg.converters import Converter
from aspose.svg.drawing import Margin, Page, Resolution, Size
from aspose.svg.rendering.image import ImageFormat
from aspose.svg.saving import ImageSaveOptions
from aspose.pydrawing import Color

# Convert SVG to JPG with custom background, page size, and resolution
input_folder = "data/"
output_folder = "output/"
input_path = os.path.join(input_folder, "christmas-tree.svg")
output_path = os.path.join(output_folder, "christmas-tree.jpg")
os.makedirs(output_folder, exist_ok=True)

options = ImageSaveOptions()
options.format = ImageFormat.JPEG
options.background_color = Color.from_argb(233, 255, 241)
options.page_setup.any_page = Page(Size(450, 450), Margin(20, 20, 20, 20))
options.horizontal_resolution = Resolution.from_dots_per_inch(96.0)
options.vertical_resolution = Resolution.from_dots_per_inch(96.0)

with SVGDocument(input_path) as document:
    Converter.convert_svg(document, options, output_path)

На изображении ниже показан исходный SVG и результат JPG с пользовательским фоном.

Изменение выходного формата изображения

Чтобы сохранить SVG в другом формате изображения, задайте ImageSaveOptions.format и используйте соответствующее расширение файла. Например, используйте значения ImageFormat: ImageFormat.GIF с .gif, ImageFormat.BMP с .bmp или ImageFormat.TIFF с .tiff.

options.format = ImageFormat.GIF
output_path = os.path.join(output_folder, "image.gif")

Основные свойства ImageSaveOptions

Свойство	Что контролирует
format	Целевой формат изображения: JPG, PNG, BMP, TIFF или GIF
background_color	Цвет фона для прозрачных областей SVG
page_setup	Размер выходного изображения, поля и layout страницы
horizontal_resolution	Горизонтальное разрешение вывода в пикселях на дюйм
vertical_resolution	Вертикальное разрешение вывода в пикселях на дюйм
smoothing_mode	Качество рендеринга фигур и краев
compression	Настройки сжатия TIFF

ImageSaveOptions наследует настройки рендеринга изображений от ImageRenderingOptions, поэтому многие свойства совпадают для сценариев через converter и через устройство рендеринга.

Конвертация SVG в изображение с помощью render_to()

Метод render_to() отправляет SVG-контент на ImageDevice. Такой подход полезен, если приложение уже использует устройства рендеринга или должно явно выбирать целевое устройство.

import os
from aspose.svg import SVGDocument
from aspose.svg.drawing import Margin, Page, Resolution, Size
from aspose.svg.rendering.image import ImageDevice, ImageFormat, ImageRenderingOptions

# Render SVG to JPG through an ImageDevice
input_folder = "data/"
output_folder = "output/"
input_path = os.path.join(input_folder, "image.svg")
output_path = os.path.join(output_folder, "image.jpg")
os.makedirs(output_folder, exist_ok=True)

options = ImageRenderingOptions()
options.format = ImageFormat.JPEG
options.horizontal_resolution = Resolution.from_dots_per_inch(96.0)
options.vertical_resolution = Resolution.from_dots_per_inch(96.0)
options.page_setup.any_page = Page(Size(600, 600), Margin(10, 10, 10, 10))

with SVGDocument(input_path) as document:
    with ImageDevice(options, output_path) as device:
        document.render_to(device)

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

Проблема	Возможная причина	Решение
У JPG черный или неожиданный фон	JPG не поддерживает прозрачность	Задайте options.background_color перед конвертацией
Выходное изображение обрезано или слишком большое	Настройка страницы не соответствует viewport SVG или желаемому размеру вывода	Настройте page_setup.any_page с помощью Page, Size и Margin
Изображение размыто	Разрешение или размер страницы слишком малы	Увеличьте horizontal_resolution, vertical_resolution или размеры вывода
Создан не тот формат	Формат изображения и расширение файла не совпадают	Задавайте и options.format, и расширение выходного файла осознанно
Внешние изображения или CSS отсутствуют	Относительные ресурсы не могут быть разрешены при конвертации	Держите ресурсы рядом с SVG-файлом или используйте корректные абсолютные пути

Онлайн-конвертер SVG в изображение

Используйте бесплатный онлайн SVG to JPG Converter или общий SVG Converter, чтобы проверить SVG-to-image конвертацию перед реализацией в Python.

FAQ

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

Загрузите SVG через SVGDocument, задайте ImageSaveOptions.format = ImageFormat.JPEG и вызовите Converter.convert_svg(document, options, output_path).

Можно ли конвертировать SVG в BMP, TIFF или GIF тем же кодом?

Да. Измените options.format на нужное значение ImageFormat и используйте соответствующее расширение выходного файла.

Почему для JPG-вывода нужно задавать цвет фона?

JPG не поддерживает прозрачность. Цвет фона делает прозрачные области SVG предсказуемыми в конвертированном изображении.

Можно ли управлять размером выходного изображения?

Да. Настройте options.page_setup.any_page с помощью Page, Size и Margin, а при необходимости задайте разрешение.

Что выбрать: Converter.convert_svg() или render_to()?

Используйте Converter.convert_svg() для обычной конвертации файлов. Используйте render_to(), когда нужен сценарий с устройством рендеринга, например ImageDevice.

Связанные статьи

• Конвертировать SVG в PNG в Python посвящена PNG-выводу и прозрачности.
• Конвертировать SVG в JPG в Python посвящена JPG-выводу и настройкам фона.
• Пакетная конвертация SVG-файлов в Python показывает сценарии конвертации на основе папок.
• Конвертировать SVG в PDF в Python объясняет параметры PDF-конвертации.
• Конвертировать SVG-файлы в Python дает обзор всех поддерживаемых сценариев конвертации SVG.
• Создать SVG-файл показывает, как создать или загрузить SVG перед конвертацией.
• Редактировать SVG-файл объясняет, как изменить SVG перед сохранением в изображение.