Устройства рендеринга – рендеринг HTML в PDF, XPS, DOCX и изображения

В этой статье мы опишем, как использовать устройства рендеринга – PdfDevice, XpsDevice, DocDevice и ImageDevice – для рендеринга HTML в PDF, XPS, DOCX и изображения. В примерах на Python процесс рендеринга рассматривается с параметрами рендеринга по умолчанию. Чтобы узнать больше о настройке вывода, прочитайте статью Rendering Options.

Понимание устройств рендеринга (Rendering Device) в Aspose.HTML

В Aspose.HTML for Python via .NET устройство рендеринга представляет собой двумерную поверхность для рисования, реализованную через интерфейс IDevice. Его основное назначение – преобразование содержимого HTML и поддерживаемых веб-форматов (MHTML, SVG и EPUB) в различные выходные форматы.

API Python предоставляет следующие устройства рендеринга:

• PdfDevice – рендерит HTML, MHTML, SVG и EPUB в PDF.
• XpsDevice – рендерит HTML, MHTML, SVG и EPUB в формат XPS.
• DocDevice – рендерит HTML, MHTML, SVG и EPUB в DOCX.
• ImageDevice – рендерит HTML, MHTML, SVG и EPUB в форматы изображений.

Каждое устройство имеет определенные параметры рендеринга: PdfRenderingOptions, XpsRenderingOptions, DocRenderingOptions и ImageRenderingOptions. Они позволяют точно контролировать качество вывода, макет и форматирование.

PdfDevice

Пространство имен Aspose.Html.Rendering.Pdf в библиотеке Aspose.HTML for Python via .NET предоставляет функциональность для рендеринга HTML и связанных форматов непосредственно в документы PDF. Оно включает классы и параметры, предназначенные для вывода PDF. Ключевые компоненты:

• PdfDevice – это базовый класс устройства рендеринга. Он используется для преобразования HTML (или MHTML, SVG, EPUB и т.д.) в PDF-файл.
• PdfRenderingOptions – это класс, определяющий настраиваемые параметры вывода PDF, такие как размер страницы, поля, сжатие изображений, метаданные, шифрование и другие параметры компоновки/форматирования.

Следующий пример на Python показывает, как использовать PdfDevice для рендеринга HTML в PDF. Процесс рассматривается с параметрами рендеринга по умолчанию:

# Render HTML to PDF in Python

import os
import aspose.html as ah
import aspose.html.rendering.pdf as rp

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

input_path = os.path.join(data_dir, "document.html")
output_path = os.path.join(output_dir, "document.pdf")

# Render HTML to PDF
with ah.HTMLDocument(input_path) as document:
    with rp.PdfDevice(output_path) as device:
        document.render_to(device)

Опции рендеринга дают вам дополнительный контроль над процессом. Чтобы узнать о них больше, прочитайте статью Опции рендеринга.

ImageDevice

Пространство имен Aspose.Html.Rendering.Image предоставляет специальный класс ImageDevice, а также класс ImageRenderingOptions, отвечающий за рендеринг HTML-файлов в растровые форматы: JPG, PNG, BMP, GIF и TIFF.

Этот пример демонстрирует, как преобразовать HTML-файл в изображение JPEG с помощью Aspose.HTML for Python via .NET. Код загружает HTML-документ с диска, настраивает ImageRenderingOptions для формата JPEG, а затем использует ImageDevice для рендеринга документа в выходной файл изображения.

# Render HTML to JPG in Python

import os
import aspose.html as ah
import aspose.html.rendering.image as ri

# 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, "drawing.html")
save_path = os.path.join(output_dir, "drawing-output.jpg")

# Load the HTML document
with ah.HTMLDocument(document_path) as document:
    # Configure JPG output
    options = ri.ImageRenderingOptions(ri.ImageFormat.JPEG)

    # Render HTML to JPG
    with ri.ImageDevice(options, save_path) as device:
        document.render_to(device)

XpsDevice

Пространство имен Aspose.Html.Rendering.Xps предоставляет класс XpsDevice, который используется для рендеринга HTML-контента (или MHTML, SVG, EPUB и т.д.) в документы XPS. Следующий пример на языке Python демонстрирует этот процесс с параметрами рендеринга по умолчанию:

# Render HTML to XPS in Python

import os
import aspose.html as ah
import aspose.html.rendering.xps as rx

# 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, "drawing.html")
save_path = os.path.join(output_dir, "drawing-output.xps")

# Load the HTML document
with ah.HTMLDocument(document_path) as document:
    # Configure XPS output
    options = rx.XpsRenderingOptions()

    # Render HTML to XPS
    with rx.XpsDevice(options, save_path) as device:
        document.render_to(device)

DocDevice

Пространство имен Aspose.Html.Rendering.Doc включает класс DocDevice, который обеспечивает рендеринг файлов HTML, MHTML, SVG и EPUB в формат DOCX. Следующий пример на Python демонстрирует этот процесс с использованием опций рендеринга по умолчанию:

# Render HTML to DOCX in Python

import os
import aspose.html as ah
import aspose.html.rendering.doc as rd

# Prepare the output path
output_dir = "output"
os.makedirs(output_dir, exist_ok=True)
save_path = os.path.join(output_dir, "document.docx")

# Render the webpage to DOCX
with ah.HTMLDocument("https://docs.aspose.com/html/files/document.html") as document:
    with rd.DocDevice(save_path) as device:
        document.render_to(device)

Aspose.HTML предлагает бесплатные онлайн Конверторы, которые позволяют преобразовать файлы HTML, XHTML, MHTML, EPUB, XML и Markdown в различные популярные форматы. Вы можете легко конвертировать HTML-документы в PDF, XPS, DOCX, JPG, PNG, GIF, TIFF и другие. Просто выберите файл, выберите формат для преобразования, и все готово. И что самое приятное, это совершенно бесплатно!