在 Python 中将 SVG 转换为 PDF

Quick Answer: 使用 SVGDocument 加载 SVG 文件，创建 PdfSaveOptions，然后调用 Converter.convert_svg(document, options, output_path) 将 SVG 保存为 PDF。当默认输出不够时，可用 PdfSaveOptions 设置页面尺寸、背景颜色、分辨率、JPEG 质量、元数据或加密。

以编程方式将 SVG 转换为 PDF

当 SVG 图形需要打印、归档、附加到文档，或以跨查看器保持版式的格式共享时，PDF 是常用输出格式。Aspose.SVG for Python via .NET 既支持高级转换 API，也支持在需要明确控制渲染流程时使用渲染设备。

大多数文件转换任务使用 Converter.convert_svg()。当工作流已经使用渲染设备，或需要基于设备的渲染模式时，可使用 SVGDocument.render_to() 和 PdfDevice。

运行示例前，请在 Python 环境中 安装 Aspose.SVG for Python via .NET。

使用 Converter.convert_svg() 将 SVG 转换为 PDF

最简单的方式是用 SVGDocument 加载 SVG 文档，创建 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

需要控制 PDF 输出时使用 PdfSaveOptions。下面的示例设置透明背景，使页面适合 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 元数据
encryption	PDF 加密和权限设置

PdfSaveOptions 从 PdfRenderingOptions 继承 PDF 渲染设置，因此转换器工作流和设备工作流共享许多输出属性。

使用 render_to() 将 SVG 转换为 PDF

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 页面大小不符合预期	默认页面设置与 SVG viewport 或内容边界不匹配	设置 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 to PDF Converter 测试 SVG 到 PDF 转换。上传 SVG 文件，运行转换，并在 Python 中实现相同工作流前比较结果。

FAQ

如何在 Python 中将 SVG 转换为 PDF？

使用 SVGDocument 加载 SVG，创建 PdfSaveOptions，然后调用 Converter.convert_svg(document, options, output_path)。

可以在 SVG 转换期间设置 PDF 页面大小吗？

可以。使用 PdfSaveOptions 或 PdfRenderingOptions 的 page_setup 属性配置页面大小、边距和尺寸模式。

可以不使用 Converter 类将 SVG 转换为 PDF 吗？

可以。创建 PdfRenderingOptions，打开 PdfDevice，然后调用 document.render_to(device)。

SVG 转 PDF 会保留透明度吗？

透明 SVG 内容可以保留，但可见结果取决于 PDF 查看器和工作流。如果需要可预测的页面背景，请设置 background_color。

如何减小生成的 PDF 大小？

降低 jpeg_quality，减少嵌入式栅格图像分辨率，并在转换前简化大型或复杂 SVG 内容。

相关文章

• 在 Python 中将 SVG 转换为 PNG 说明栅格转换和图像保存选项。
• 在 Python 中将 SVG 转换为 JPG 说明带背景设置的 JPG 栅格转换。
• 在 Python 中批量转换 SVG 文件 展示如何将多个 SVG 文件转换为 PDF、PNG 或 JPG。
• 在 Python 中将 SVG 转换为图像 涵盖 SVG 到 JPG、BMP、TIFF、GIF 和其他栅格格式的转换。
• 在 Python 中转换 SVG 文件 概述所有支持的 SVG 转换格式。
• 创建 SVG 文件 展示转换前如何创建 SVG 文档，或从文件、字符串和 URL 加载 SVG。
• 编辑 SVG 文件 说明保存或转换前如何修改 SVG 元素。
• 保存 SVG 文件 说明创建或编辑 SVG 文档后如何保存。
• 导航 SVG 展示转换前如何使用 CSS 选择器和 XPath 检查 SVG 元素。
• 支持的文件格式 列出 Aspose.SVG for Python via .NET 支持的输入和输出格式。
• 许可 说明如何应用许可证或申请临时许可证以获得完整转换结果。