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

Quick Answer: Чтобы конвертировать SVG в PNG в Python, загрузите исходный файл через SVGDocument, создайте ImageSaveOptions и передайте оба объекта в Converter.convert_svg(). PNG является форматом изображения по умолчанию, а ImageSaveOptions позволяет настроить фон, размер страницы, поля и разрешение.

Конвертация SVG в PNG в Python

PNG – растровый формат без потерь, который поддерживает прозрачность. Он удобен для веб-графики, превью, миниатюр и приложений, которые не умеют напрямую отображать SVG.

Следующий пример конвертирует document.svg в result.png с настройками PNG по умолчанию:

from aspose.svg import SVGDocument
from aspose.svg.converters import Converter
from aspose.svg.saving import ImageSaveOptions

# Convert an SVG file to PNG using the default save options
options = ImageSaveOptions()

with SVGDocument("document.svg") as document:
    Converter.convert_svg(document, options, "result.png")

Код выполняет три действия:

1. SVGDocument загружает SVG-файл и разрешает его содержимое и связанные ресурсы.
2. ImageSaveOptions выбирает вывод в изображение; формат по умолчанию – PNG.
3. Converter.convert_svg() рендерит документ и записывает result.png.

Конвертация SVG в PNG с пользовательскими параметрами

Используйте ImageSaveOptions, если PNG должен иметь конкретный canvas, фон или разрешение. Следующий пример конвертирует winter.svg, добавляет сплошной фон, создает страницу 600 x 550 с полями 10 пикселей и рендерит при 96 dpi:

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

# Convert SVG to PNG with a custom background, page, and resolution
input_folder = "data/"
output_folder = "output/"
input_path = os.path.join(input_folder, "winter.svg")
output_path = os.path.join(output_folder, "winter.png")
os.makedirs(output_folder, exist_ok=True)

options = ImageSaveOptions()
options.background_color = Color.from_argb(231, 217, 230)
options.page_setup.any_page = Page(Size(600, 550), Margin(10, 10, 10, 10))
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)

Полученный PNG использует заданные параметры страницы, а не только viewport SVG. Иллюстрация сравнивает исходный SVG и PNG, отрисованный на новом фоне.

Важные свойства ImageSaveOptions

Свойство	Когда использовать
background_color	Заполнить прозрачные области выбранным цветом
page_setup	Задать размеры страницы и поля
horizontal_resolution	Задать горизонтальное разрешение вывода в dpi
vertical_resolution	Задать вертикальное разрешение вывода в dpi
smoothing_mode	Управлять качеством растеризации
text	Настроить рендеринг текста через TextOptions

Если background_color не задан, прозрачные области SVG остаются прозрачными в PNG. Разрешение влияет на плотность растра, а page_setup управляет canvas вывода. Если размеры страницы заданы в пикселях, размеры в пикселях обычно важнее, чем простое увеличение dpi.

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

Проблема	Возможная причина	Решение
PNG пустой или обрезан	В SVG нет корректного viewport или выходная страница слишком мала	Задайте SVG width, height или viewBox, либо настройте options.page_setup.any_page
Прозрачные области выглядят неожиданно	Не указан выходной фон	Задайте options.background_color, если нужен сплошной canvas
Текст выглядит иначе	Нужный шрифт недоступен	Установите шрифт или векторизуйте текст перед конвертацией, если важна точная форма глифов
Связанные изображения или CSS отсутствуют	Относительные ресурсы не могут быть разрешены	Загружайте SVG из его файлового пути или задавайте корректный base URI
Размеры вывода не соответствуют ожиданиям	Размер страницы и разрешение воспринимаются как одна настройка	Используйте page_setup для размеров и horizontal_resolution/vertical_resolution для dpi

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

Вы также можете проверить конвертацию SVG в PNG в браузере. Загрузите SVG-файл, выберите PNG и сравните результат с программным выводом.

Попробуйте бесплатный онлайн SVG to PNG Converter, чтобы конвертировать SVG без написания кода.

FAQ

Как быстрее всего конвертировать SVG в PNG в Python?

Создайте ImageSaveOptions, откройте исходный SVG через SVGDocument и вызовите Converter.convert_svg(document, options, output_path).

Сохраняет ли конвертация SVG в PNG прозрачность?

Да. PNG поддерживает прозрачность, и прозрачные области SVG остаются прозрачными, если вы не зададите ImageSaveOptions.background_color.

Как задать размер PNG?

Настройте ImageSaveOptions.page_setup с помощью Page, Size и Margin. Свойства разрешения используйте отдельно, если нужен определенный dpi.

Можно ли конвертировать SVG-контент из строки?

Да. Создайте SVGDocument из SVG-строки и base URI, а затем передайте документ в Converter.convert_svg().

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

• Конвертировать SVG-файлы в Python объясняет доступные сценарии конвертации и выходные форматы.
• Конвертировать SVG в PDF в Python показывает параметры сохранения PDF и рендеринг через PdfDevice.
• Конвертировать SVG в JPG в Python объясняет JPG-вывод, когда прозрачность не нужна.
• Пакетная конвертация SVG-файлов в Python показывает, как конвертировать папки SVG-файлов.
• Конвертировать SVG в изображение охватывает JPG, BMP, TIFF, GIF и другие растровые форматы.
• Создать SVG-файл показывает, как создать или загрузить SVG перед конвертацией.
• Редактировать SVG-файл объясняет, как изменить SVG-элементы перед сохранением или конвертацией.
• Сохранить SVG-файл объясняет, как сохранять SVG-документы после создания или редактирования.
• Навигация по SVG показывает, как инспектировать SVG-элементы с помощью CSS-селекторов и XPath перед конвертацией.
• Поддерживаемые форматы файлов перечисляет входные и выходные форматы Aspose.SVG for Python via .NET.
• Лицензирование объясняет, как применить лицензию или запросить временную лицензию для полного результата конвертации.