渲染器 – 用 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 with custom page settings using Python

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

# Setup input and output directories
data_dir = "data/"
output_dir = "output/"
os.makedirs(output_dir, exist_ok=True)

# Prepare path to the source HTML file
document_path = os.path.join(data_dir, "document.html")

# Initialize an HTML document from the file
doc = ah.HTMLDocument(document_path)

# Create an instance of the HTML Renderer
renderer = rn.HtmlRenderer()

# Prepare path to save the converted PDF
save_path = os.path.join(output_dir, "render-html-with-options.pdf")

# Create PDF rendering options and set custom page size
options = rp.PdfRenderingOptions()
options.page_setup.any_page = dr.Page(dr.Size(600, 200))

# Setup PDF encryption
options.encryption = rpe.PdfEncryptionInfo(
    user_password="user_pwd",
    owner_password="owner_pwd",
    permissions=rpe.PdfPermissions.PRINT_DOCUMENT,
    encryption_algorithm=rpe.PdfEncryptionAlgorithm.RC4_128
)

# Create the PDF device with options and output path
device = rp.PdfDevice(options, save_path)

# Render HTML to PDF
renderer.render(device, doc)

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

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

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 with custom page settings using Python

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

# Setup input and output directories
data_dir = "data/"
output_dir = "output/"
os.makedirs(output_dir, exist_ok=True)

# Prepare path to the source SVG file
doc_path = os.path.join(data_dir, "flower.svg")
save_path = os.path.join(output_dir, "render-svg-with-options.png")

# Initialize an SVG document from the file
doc = ah.dom.svg.SVGDocument(doc_path)

# Create an instance of the SVG Renderer
renderer = rn.SvgRenderer()

# Create the instance of Rendering Options and set a custom page-size
options = ri.ImageRenderingOptions()
options.page_setup.any_page = dr.Page(dr.Size(400, 300))

# Create the PNG device with options and output path
device = ri.ImageDevice(options, save_path)

# Render SVG to PNG
renderer.render(device, doc)

MhtmlRenderer

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

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

# Render MHTML to PDF with custom page settings using Python

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

# Setup input and output directories
data_dir = "data/"
output_dir = "output/"
os.makedirs(output_dir, exist_ok=True)

# Prepare path to the source MHTML file
epub_path = os.path.join(data_dir, "document.mht")
save_path = os.path.join(output_dir, "render-mhtml-with-options.pdf")

# Open the MHTML file in binary mode
with open("document.mht", 'rb') as stream:

    # Create an instance of MHTML Renderer
    renderer = rn.MhtmlRenderer()

    # Create PDF rendering options and set a custom page size and background color
    options = rp.PdfRenderingOptions()
    options.page_setup.any_page = dr.Page(dr.Size(800, 400))
    options.background_color = pd.Color.bisque

    # Create an instance of PdfDevice for output
    device = rp.PdfDevice(options, save_path)

    # Render MHTML to PDF
    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 with custom page settings using Python

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

# Setup input and output directories
data_dir = "data/"
output_dir = "output/"
os.makedirs(output_dir, exist_ok=True)

# Prepare path to the source EPUB file
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 in binary mode
with open(epub_path, "rb") as stream:

    # Create an instance of EPUB Renderer
    renderer = rn.EpubRenderer()

    # Create DOC rendering options and set a custom page size
    options = rd.DocRenderingOptions()
    options.page_setup.any_page = dr.Page(dr.Size(800, 400))

    # Create an instance of DocDevice for output
    device = rd.DocDevice(options, save_path)

    # Render EPUB to DOCX
    renderer.render(device, stream)

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