Opciones de renderizado – Personalizar el renderizado HTML

Las opciones de renderizado proporcionan un control detallado sobre cómo el dispositivo de renderizado procesa el contenido. Cada dispositivo – PdfDevice, XpsDevice, DocDevice, y ImageDevice – tiene su propia clase de opciones: PdfRenderingOptions, XpsRenderingOptions, DocRenderingOptions, e ImageRenderingOptions. Con estas opciones, puede ajustar el tamaño de página, los márgenes y los colores, así como aplicar configuraciones específicas del dispositivo, como añadir una contraseña de seguridad a los archivos PDF. La personalización es crucial para lograr los resultados deseados, ya se trate de reducir el tamaño del archivo ajustando la calidad y la resolución de la imagen o de mejorar la legibilidad mediante un diseño de página y un formato de texto optimizados.

En este artículo, se exploran las opciones de renderizado en Aspose.HTML for Python via .NET, mostrando cómo personalizar la conversión de contenido HTML en formatos de salida como PDF, XPS, DOCX e imágenes. Estas opciones incluyen ajustes generales como el tamaño de página, el color de fondo y la resolución, así como ajustes específicos del dispositivo, como la compresión de imágenes, la seguridad de PDF y la incrustación de fuentes, que permiten un control total sobre el resultado final.

Aquí encontrarás ejemplos de código Python que demuestran el uso de parámetros específicos de dispositivo. El uso de opciones generales se tratará en el capítulo “Artículos prácticos” (en preparación).

Para saber más sobre el proceso de renderizado, lea el artículo Dispositivo de renderizado.

PdfRenderingOptions

La clase PdfRenderingOptions, junto con las opciones generales, soporta varios parámetros específicos, como jpeg_quality, document_info, encryption, form_field_behaviour, y 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.

La propiedad form_field_behaviour se utiliza para especificar el comportamiento de los campos de formulario en un documento PDF. Para saber qué significa aplanar un archivo PDF y cómo hacerlo utilizando la biblioteca Aspose.HTML for Python via .NET, consulte la sección Conversión de HTML a PDF y PDF flattening.

El siguiente código de Python muestra cómo añadir encriptación a un archivo PDF utilizando la clase PdfRenderingOptions:

# 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)

El ejemplo anterior muestra cómo crear una nueva instancia de PdfRenderingOptions y establecer las opciones de cifrado para un archivo de salida PDF. Para ello, es necesario crear un objeto PdfEncryptionInfo, que define la configuración de cifrado para el archivo PDF. El constructor recibe cuatro parámetros:

• user_password y owner_password, que son necesarias para abrir y trabajar con el archivo PDF;
• permissions – un conjunto de permisos permitidos para un archivo PDF. En este caso, se especifica PdfPermissions.PRINT_DOCUMENT, que permite al usuario imprimir el documento;
• encryption_algorithm – el algoritmo de cifrado utilizado para proteger el archivo PDF. En este caso, se utiliza PdfEncryptionAlgorithm.RC4_128, que es un algoritmo de cifrado RC4 de 128 bits.

ImageRenderingOptions

La clase ImageRenderingOptions soporta todas las opciones generales y permite configurar opciones específicas, como el antialiasing, la configuración del renderizado de texto, la selección del formato de imagen y la compresión de la imagen.

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.

Veamos cómo utilizar un objeto especializado ImageRenderingOptions para establecer el formato TIFF y la compresión de la imagen:

# 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)

XpsRenderingOptions

XpsRenderingOptions heredan todas las opciones de la clase base RenderingOptions. Puede configurar el tamaño de página, los márgenes, el color de fondo y otras opciones comunes al generar archivos XPS.

# 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)

DocRenderingOptions

La clase DocRenderingOptions soporta todas las opciones generales y permite personalizar las propiedades font_embedding_rule y document_format para el fichero de salida.

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.

El siguiente ejemplo muestra cómo personalizar las opciones de representación de un documento DOCX de salida estableciendo el tamaño de página y la regla de incrustación de fuentes:

# 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 ofrece Convertidores en línea gratuitos que pueden convertir archivos HTML, XHTML, MHTML, EPUB, XML y Markdown a una serie de formatos populares. Puedes convertir fácilmente tus documentos basados en HTML a PDF, XPS, DOCX, JPG, PNG, GIF, TIFF y otros. Sólo tienes que seleccionar un archivo, elegir el formato a convertir y listo.