Rendering-Optionen – HTML-Rendering anpassen

Die Rendering-Optionen bieten eine detaillierte Kontrolle darüber, wie das Rendering-Gerät Inhalte verarbeitet. Jedes Gerät – PdfDevice, XpsDevice, DocDevice und ImageDevice – hat seine eigene Klasse von Optionen: PdfRenderingOptions, XpsRenderingOptions, DocRenderingOptions, und ImageRenderingOptions. Mit diesen Optionen können Sie Seitengröße, Ränder und Farben anpassen sowie gerätespezifische Einstellungen vornehmen, z. B. das Hinzufügen eines Sicherheitskennworts zu PDF-Dateien. Die Anpassung ist entscheidend, um die gewünschten Ergebnisse zu erzielen, sei es die Reduzierung der Dateigröße durch Anpassung der Bildqualität und -auflösung oder die Verbesserung der Lesbarkeit durch optimiertes Seitenlayout und Textformatierung.

In diesem Artikel werden die Rendering-Optionen in Aspose.HTML for Python via .NET untersucht. Es wird gezeigt, wie die Konvertierung von HTML-Inhalten in Ausgabeformate wie PDF, XPS, DOCX und Bilder angepasst werden kann. Diese Optionen umfassen allgemeine Einstellungen wie Seitengröße, Hintergrundfarbe und Auflösung sowie gerätespezifische Einstellungen wie Bildkomprimierung, PDF-Sicherheit und Schrifteinbettung, die eine vollständige Kontrolle über die endgültige Ausgabe ermöglichen.

Hier finden Sie Python-Code-Beispiele, die die Verwendung von gerätspezifischen Parametern demonstrieren. Die Verwendung allgemeiner Optionen wird im Kapitel “How-to-Artikel” (in Vorbereitung) behandelt.

Um mehr über den Rendering-Prozess zu erfahren, lesen Sie bitte den Artikel Rendering Device.

PdfRenderingOptions

Die Klasse PdfRenderingOptions unterstützt neben allgemeinen Optionen mehrere spezifische Parameter, wie jpeg_quality, document_info, encryption, form_field_behaviour und is_tagged_pdf.

Property	Description
jpeg_quality	Specifies the quality of JPEG compression for images. The default value is 95.
document_info	This property contains information about the output PDF document.
encryption	This property gets or sets encryption details. If it is not set, then no encryption will be performed.
form_field_behaviour	This property specifies the behavior of form fields in the output PDF document.
is_tagged_pdf	If is_tagged_pdf = true, a tag structure will be added to the PDF document during rendering.

Die Eigenschaft form_field_behaviour wird verwendet, um das Verhalten von Formularfeldern in einem PDF-Dokument festzulegen. Was es bedeutet, eine PDF-Datei zu reduzieren, und wie man dies mit der Aspose.HTML for Python via .NET-Bibliothek macht, erfahren Sie im Abschnitt HTML-zu-PDF-Konvertierung und PDF-Flattening.

Der folgende Python-Code zeigt, wie eine PDF-Ausgabedatei mit Hilfe der Klasse PdfRenderingOptions verschlüsselt werden kann:

# Render HTML to password-protected PDF in Python

import os
import aspose.html as ah
import aspose.html.rendering as rn
import aspose.html.rendering.pdf as rp
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, "convert-html-to-pdf-with-encryption.pdf")

# Load the HTML document
with ah.HTMLDocument(document_path) as document:
    with rn.HtmlRenderer() as renderer:
        # Configure password-protected PDF output
        options = rp.PdfRenderingOptions()
        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)

Das obige Beispiel zeigt, wie Sie eine neue PdfRenderingOptions-Instanz erstellen und Verschlüsselungsoptionen für eine PDF-Ausgabedatei festlegen. Zu diesem Zweck müssen Sie ein PdfEncryptionInfo-Objekt erstellen, das die Verschlüsselungseinstellungen für die PDF-Datei definiert. Der Konstruktor benötigt vier Parameter:

• user_password und owner_password, die zum Öffnen und Arbeiten mit der PDF-Datei erforderlich sind;
• permissions – eine Reihe von erlaubten Berechtigungen für eine PDF-Datei. In diesem Fall ist PdfPermissions.PRINT_DOCUMENT angegeben, wodurch der Benutzer das Dokument drucken kann;
• encryption_algorithm – der Verschlüsselungsalgorithmus, der zum Schutz der PDF-Datei verwendet wird. In diesem Fall wird PdfEncryptionAlgorithm.RC4_128 verwendet, ein 128-Bit-RC4-Verschlüsselungsalgorithmus.

ImageRenderingOptions

Die Klasse ImageRenderingOptions unterstützt alle allgemeinen Optionen und ermöglicht die Konfiguration spezifischer Optionen wie Anti-Aliasing, Text-Rendering-Konfiguration, Bildformatauswahl und Bildkomprimierung.

Property	Description
compression	Sets Tagged Image File Format (TIFF) compression. By default, this property is LZW.
format	Sets the ImageFormat (JPG, PNG, BMP, TIFF, or GIF). By default, this property is PNG.
use_antialiasing	This property defines the rendering quality of the image by controlling the use of antialiasing. Antialiasing is enabled by default.
text	Gets a TextOptions object which is used for configuration of text rendering.

Betrachten wir, wie man ein spezielles ImageRenderingOptions-Objekt verwendet, um das TIFF-Format und die Komprimierung für das Bild festzulegen:

# Render HTML to TIFF in Python with custom settings

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, "html_file.html")
save_path = os.path.join(output_dir, "document.tiff")

# Load the HTML document
with ah.HTMLDocument(document_path) as document:
    # Configure TIFF output
    options = ri.ImageRenderingOptions(ri.ImageFormat.TIFF)
    options.compression = ri.Compression.NONE

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

XPS-Rendering-Optionen

XpsRenderingOptions erben alle Einstellungen von der Basisklasse RenderingOptions. Sie können Seitengröße, Ränder, Hintergrundfarbe und andere gängige Optionen für die Erzeugung von XPS-Dateien konfigurieren.

# Render HTML to XPS in Python with custom page settings

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

# 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, "document-options.xps")

# Load the HTML document
with ah.HTMLDocument(document_path) as document:
    # Configure XPS output
    options = rx.XpsRenderingOptions()
    options.page_setup.any_page = dr.Page(
        dr.Size(dr.Length.from_inches(5.0), dr.Length.from_inches(2.0))
    )

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

DOC-Rendering-Optionen

Die Klasse DocRenderingOptions unterstützt alle allgemeinen Optionen und ermöglicht es Ihnen, die Eigenschaften font_embedding_rule und document_format für die Ausgabedatei anzupassen.

Property	Description
font_embedding_rule	This property gets or sets the font embedding rule. Available values are Full and None. The default value is None.
document_format	This property gets or sets the file format of the output document. The default value is DOCX.

Das folgende Beispiel zeigt, wie Sie die Rendering-Optionen für ein DOCX-Ausgabedokument anpassen können, indem Sie die Regel für die Seitengröße und die Schrifteinbettung festlegen:

# Render HTML to DOCX in Python with custom settings

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

# 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, "nature.html")
save_path = os.path.join(output_dir, "nature-options.docx")

# Load the HTML document
with ah.HTMLDocument(document_path) as document:
    # Configure DOCX output
    options = rd.DocRenderingOptions()
    options.page_setup.any_page = dr.Page(
        dr.Size(dr.Length.from_inches(8.0), dr.Length.from_inches(10.0))
    )
    options.font_embedding_rule = rd.FontEmbeddingRule.FULL

    # Render HTML to DOCX
    with rd.DocDevice(options, save_path) as device:
        document.render_to(device)

Aspose.HTML bietet kostenlose Online- Konverter, die HTML-, XHTML-, MHTML-, EPUB-, XML- und Markdown-Dateien in eine Reihe von gängigen Formaten konvertieren können. Sie können Ihre HTML-basierten Dokumente ganz einfach in PDF, XPS, DOCX, JPG, PNG, GIF, TIFF und andere konvertieren. Wählen Sie einfach eine Datei und das zu konvertierende Format aus, und schon sind Sie fertig.