Рендеры – Рендеринг HTML, MHTML, EPUB и SVG на Python

Рендеры – Renderers

Пространство имен aspose.html.rendering состоит из множества объектов рендереров и соответствующих низкоуровневых классов опций, которые отвечают за рендеринг документов в реализации IDevice. Aspose.HTML for Python via .NET API предоставляет следующую реализацию рендереров: HtmlRenderer, SvgRenderer, MhtmlRenderer и EpubRenderer, которые используются для рендеринга HTML, SVG, MHTML и EPUB документов, соответственно.

В данной статье описываются поддерживаемые сценарии преобразования HTML-файлов в другие популярные форматы с помощью методов render() из пространства имен aspose.html.rendering.

HtmlRenderer

Класс HtmlRenderer можно использовать для рендеринга HTML-файлов в различные популярные форматы, позволяя настраивать параметры и контролировать результаты процесса. Давайте рассмотрим использование класса HtmlRenderer для рендеринга HTML в PDF с пользовательскими настройками результата:

1. Инициализируйте HTML-документ, используя класс HTMLDocument.
2. Создайте новый объект HtmlRenderer.
3. Создайте экземпляр класса PdfRenderingOptions и настройте параметры для выходного PDF-документа. Например, вы можете установить свойство any_page класса PageSetup для создания нового объекта Page с размерами 600 пикселей на 200 пикселей. Кроме того, можно настроить свойство encryption, указав пароли пользователя и владельца, разрешенные действия и алгоритм шифрования для выходного PDF-файла.
4. Используйте конструктор PdfDevice(options, savePath), чтобы создать объект класса PdfDevice.
5. Вызовите метод render(device, document) для рендеринга HTML в PDF с указанными параметрами рендеринга.

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, которое устанавливает новый объект Page с размером страницы 400x300 пикселей.
4. Используйте конструктор ImageDevice(options, savePath), чтобы создать объект класса ImageDevice.
5. Вызовите метод render(device, document) для рендеринга SVG в PNG с указанными ImageRenderingOptions.

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

В этом примере показано, как преобразовать MHTML-документ в PDF с помощью класса MhtmlRenderer с заданными параметрами рендеринга:

1. Откройте существующий документ MHTML.
2. Создайте экземпляр класса MhtmlRenderer с помощью конструктора MhtmlRenderer().
3. Инициализируйте класс PdfRenderingOptions и установите параметры рендеринга.
4. Создайте экземпляр класса PdfDevice.
5. Вызовите метод render(device, stream) для рендеринга MHTML в PDF.

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
    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.

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 и другие. Просто выберите файл, выберите формат для преобразования, и все готово.