渲染器 – 用 Python 渲染 HTML、MHTML、EPUB 和 SVG

渲染器

Aspose.html.rendering 名称空间由许多呈现器对象和相应的底层选项类组成，它们负责将文档呈现到 IDevice 实现中。Aspose.HTML for Python 通过 .NET API 提供了以下呈现器实现： HtmlRenderer、 SvgRenderer、 MhtmlRenderer 和 EpubRenderer，它们分别用于呈现 HTML、SVG、MHTML 和 EPUB 文档。

本文介绍了使用 aspose.html.rendering 名称空间中的 render() 方法将基于 HTML 的文件转换为其他流行格式的支持场景。

HtmlRenderer

HtmlRenderer 类可用于将 HTML 文件渲染为各种流行格式，允许自定义渲染选项并控制过程的输出。让我们来看看如何使用 HtmlRenderer 类将 HTML 渲染成 PDF，并自定义输出设置：

1. 使用 HTMLDocument 类初始化 HTML 文档。
2. 创建一个新的 HtmlRenderer 对象。
3. 创建 PdfRenderingOptions的实例，并自定义输出 PDF 文档的选项。例如，你可以设置 PageSetup 类的 any_page属性，创建一个尺寸为 600 像素乘 200 像素的新页面对象。此外，您还可以配置 encryption 属性，为输出 PDF 文件指定用户和所有者密码、允许的操作和加密算法。
4. 使用 PdfDevice(options, savePath) 构造函数创建一个 PdfDevice 类对象。
5. 调用 render(device, document) 方法，使用指定的呈现选项将 HTML 呈现为 PDF。

# Render HTML to PDF in Python with custom page settings

import os
import aspose.html as ah
import aspose.html.rendering as rn
import aspose.html.rendering.pdf as rp
import aspose.html.drawing as dr
import aspose.html.rendering.pdf.encryption as rpe

# Prepare input and output paths
data_dir = "data"
output_dir = "output"
os.makedirs(output_dir, exist_ok=True)

document_path = os.path.join(data_dir, "document.html")
save_path = os.path.join(output_dir, "render-html-with-options.pdf")

# Load the HTML document
with ah.HTMLDocument(document_path) as document:
    with rn.HtmlRenderer() as renderer:
        # Configure PDF output
        options = rp.PdfRenderingOptions()
        options.page_setup.any_page = dr.Page(dr.Size(600, 200))
        options.encryption = rpe.PdfEncryptionInfo(
            user_password="user_pwd",
            owner_password="owner_pwd",
            permissions=rpe.PdfPermissions.PRINT_DOCUMENT,
            encryption_algorithm=rpe.PdfEncryptionAlgorithm.RC4_128
        )

        # Render HTML to PDF
        with rp.PdfDevice(options, save_path) as device:
            renderer.render(device, document)

渲染选项可让你对渲染过程进行额外控制。如需了解更多信息，请阅读 渲染选项 一文。

要了解有关渲染过程的更多信息，请参阅文章 渲染设备。

SvgRenderer

通过 SvgRenderer，您可以将 SVG 文件渲染为其他文件格式，如 PDF、XPS、DOCX 和图像格式。下面的示例演示了如何使用 SvgRenderer 类将 SVG 渲染成指定了自定义页面大小的 PNG：

1. 初始化 SVG 文档。使用 SVGDocument() 构造函数之一创建 SVGDocument 实例。
2. 创建一个新的 SvgRenderer 对象。
3. 创建 ImageRenderingOptions 实例，并为输出的 PNG 图像设置自定义选项。在示例中，我们指定了 any_page 属性，该属性设置了一个页面大小为 400x300 像素的新页面对象。
4. 使用 ImageDevice(options, savePath) 构造函数创建 ImageDevice 类对象。
5. 调用 render(device, document) 方法，使用指定的呈现选项将 SVG 呈现为 PNG。

# Render SVG to PNG in Python with custom page settings

import os
import aspose.html as ah
import aspose.html.rendering.image as ri
import aspose.html.rendering as rn
import aspose.html.drawing as dr

# Prepare input and output paths
data_dir = "data"
output_dir = "output"
os.makedirs(output_dir, exist_ok=True)

doc_path = os.path.join(data_dir, "flower.svg")
save_path = os.path.join(output_dir, "render-svg-with-options.png")

# Load the SVG document
with ah.dom.svg.SVGDocument(doc_path) as document:
    with rn.SvgRenderer() as renderer:
        # Configure PNG output
        options = ri.ImageRenderingOptions()
        options.page_setup.any_page = dr.Page(dr.Size(400, 300))

        # Render SVG to PNG
        with ri.ImageDevice(options, save_path) as device:
            renderer.render(device, document)

MhtmlRenderer

本例说明了如何使用带有指定呈现选项的 MhtmlRenderer 类将 MHTML 文档转换为 PDF：

1. 打开现有的 MHTML 文档。
2. 使用 MhtmlRenderer() 构造函数创建一个 MhtmlRenderer 类实例。
3. 初始化 PdfRenderingOptions 类并设置渲染选项。
4. 创建 PdfDevice 类的实例。
5. 调用 render(device, stream) 方法将 MHTML 转换为 PDF。

# Render MHTML to PDF in Python with custom page settings

import os
import aspose.html.rendering.pdf as rp
import aspose.html.rendering as rn
import aspose.html.drawing as dr
import aspose.pydrawing as pd

# Prepare input and output paths
data_dir = "data"
output_dir = "output"
os.makedirs(output_dir, exist_ok=True)

mhtml_path = os.path.join(data_dir, "document.mht")
save_path = os.path.join(output_dir, "render-mhtml-with-options.pdf")

# Open the MHTML file
with open(mhtml_path, "rb") as stream:
    with rn.MhtmlRenderer() as renderer:
        # Configure PDF output
        options = rp.PdfRenderingOptions()
        options.page_setup.any_page = dr.Page(dr.Size(800, 400))
        options.background_color = pd.Color.bisque

        # Render MHTML to PDF
        with rp.PdfDevice(options, save_path) as device:
            renderer.render(device, stream)

EpubRenderer

通过 EpubRenderer 类，您可以将 EPUB 文件转换为其他格式，如 PDF、XPS、DOCX 和图像。下面的 Python 示例展示了如何通过自定义页面大小设置将 EPUB 转换为 DOCX：

1. 打开现有 EPUB 文件
2. 创建 EpubRenderer 类的实例。
3. 初始化 DocRenderingOptions 类并设置渲染选项。
4. 创建 DocDevice 类的实例。
5. 调用 render(device, stream) 方法将 EPUB 渲染为 DOCX。

# Render EPUB to DOCX in Python with custom page settings

import os
import aspose.html.rendering.doc as rd
import aspose.html.rendering as rn
import aspose.html.drawing as dr

# Prepare input and output paths
data_dir = "data"
output_dir = "output"
os.makedirs(output_dir, exist_ok=True)

epub_path = os.path.join(data_dir, "input.epub")
save_path = os.path.join(output_dir, "render-epub-with-options.docx")

# Open the EPUB file
with open(epub_path, "rb") as stream:
    with rn.EpubRenderer() as renderer:
        # Configure DOCX output
        options = rd.DocRenderingOptions()
        options.page_setup.any_page = dr.Page(dr.Size(800, 400))

        # Render EPUB to DOCX
        with rd.DocDevice(options, save_path) as device:
            renderer.render(device, stream)

Aspose.HTML 提供免费的在线 转换器，可将 HTML、XHTML、MHTML、EPUB、XML 和 Markdown 文件转换为各种流行格式。你可以轻松地将 HTML 文档转换为 PDF、XPS、DOCX、JPG、PNG、GIF、TIFF 等格式。只需选择文件，选择要转换的格式，就大功告成了。