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

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

Конвертация SVG в PDF программно

PDF – распространенный выходной формат, когда SVG-графику нужно напечатать, архивировать, вложить в документы или передать в формате, который сохраняет макет в разных просмотрщиках. Aspose.SVG for Python via .NET позволяет конвертировать SVG в PDF через высокоуровневый converter API или через устройство рендеринга, если нужен явный контроль над пайплайном.

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

Конвертация SVG в PDF с помощью Converter.convert_svg()

Самый простой способ конвертировать SVG в PDF – загрузить SVG-документ через SVGDocument, создать PdfSaveOptions и вызвать Converter.convert_svg().

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

# Convert an SVG file to PDF using the default save options
options = PdfSaveOptions()

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

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

Используйте PdfSaveOptions, когда нужно управлять PDF-выводом. Следующий пример задает прозрачный фон, подгоняет страницу под содержимое SVG, изменяет разрешение растровых изображений и настраивает качество JPEG.

import os
from aspose.svg import SVGDocument
from aspose.svg.converters import Converter
from aspose.svg.drawing import Resolution
from aspose.svg.rendering import SizingType
from aspose.svg.saving import PdfSaveOptions
from aspose.pydrawing import Color

# Convert SVG to PDF and customize page sizing and image quality
input_folder = "data/"
output_folder = "output/"
input_path = os.path.join(input_folder, "document.svg")
output_path = os.path.join(output_folder, "document.pdf")
os.makedirs(output_folder, exist_ok=True)

options = PdfSaveOptions()
options.background_color = Color.from_argb(0, 255, 255, 255)
options.page_setup.sizing = SizingType.FIT_CONTENT
options.horizontal_resolution = Resolution.from_dots_per_inch(96.0)
options.vertical_resolution = Resolution.from_dots_per_inch(96.0)
options.jpeg_quality = 80

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

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

Свойство	Что контролирует
background_color	Цвет фона страницы, если в SVG есть прозрачные области
page_setup	Размер страницы, поля и режим подгонки
horizontal_resolution	Горизонтальное разрешение для растровых ресурсов внутри PDF
vertical_resolution	Вертикальное разрешение для растровых ресурсов внутри PDF
jpeg_quality	Качество JPEG-сжатия для встроенных растровых изображений
document_info	Метаданные PDF: title, author, subject, keywords
encryption	Шифрование PDF и настройки разрешений

PdfSaveOptions наследует настройки PDF-рендеринга от PdfRenderingOptions, поэтому многие свойства совпадают для сценариев через converter и через устройство рендеринга.

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

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

import os
from aspose.svg import SVGDocument
from aspose.svg.rendering import SizingType
from aspose.svg.rendering.pdf import PdfDevice, PdfRenderingOptions

# Render SVG to PDF through a PdfDevice
input_folder = "data/"
output_folder = "output/"
input_path = os.path.join(input_folder, "document.svg")
output_path = os.path.join(output_folder, "document.pdf")
os.makedirs(output_folder, exist_ok=True)

options = PdfRenderingOptions()
options.jpeg_quality = 80
options.page_setup.sizing = SizingType.FIT_CONTENT

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

Converter.convert_svg() или render_to()

Метод	Когда использовать
Converter.convert_svg()	Прямая конвертация SVG в PDF с коротким кодом и параметрами сохранения
SVGDocument.render_to()	Сценарии с устройствами вывода, например PdfDevice

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

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

Проблема	Возможная причина	Решение
Размер страницы PDF не тот, что ожидался	Настройки страницы по умолчанию не соответствуют viewport SVG или границам содержимого	Задайте options.page_setup.sizing и явно настройте размер страницы или поля
Прозрачные области SVG отображаются с нежелательным фоном	PDF-просмотрщик или последующий процесс применяет собственный фон	Задайте options.background_color перед конвертацией
Встроенные изображения выглядят размытыми или слишком большими	Разрешение и качество JPEG не соответствуют целевому выводу	Настройте horizontal_resolution, vertical_resolution и jpeg_quality
PDF не создается	Папка вывода не существует или скрипт сохраняет файл в другой рабочей директории	Создайте папку через os.makedirs() и собирайте пути через os.path.join()
Текст или внешние ресурсы отсутствуют	SVG ссылается на шрифты, изображения или CSS, которые не удается разрешить	Используйте корректные пути и держите внешние ресурсы рядом с SVG-документом

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

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

FAQ

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

Загрузите SVG через SVGDocument, создайте PdfSaveOptions и вызовите Converter.convert_svg(document, options, output_path).

Можно ли задать размер страницы PDF при конвертации SVG?

Да. Используйте свойство page_setup у PdfSaveOptions или PdfRenderingOptions, чтобы настроить размер страницы, поля и режим подгонки.

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

Да. Создайте PdfRenderingOptions, откройте PdfDevice и вызовите document.render_to(device).

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

Прозрачный SVG-контент может сохраняться, но видимый результат зависит от PDF-просмотрщика и последующего процесса. Укажите background_color, если нужен предсказуемый фон страницы.

Как уменьшить размер созданного PDF?

Снизьте jpeg_quality, уменьшите разрешение встроенных растровых изображений и упростите крупный или сложный SVG перед конвертацией.

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

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