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:

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

# 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, "convert-html-to-pdf-with-encryption.pdf")

# Create PDF rendering options and set password protection
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
)

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

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

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:

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

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

# Prepare paths for input HTML and output TIFF file
document_path = os.path.join(data_dir, "html_file.html")
save_path = os.path.join(output_dir, "html_file.tiff")

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

# Create rendering options for image format (TIFF in this case)
image_options = ri.ImageRenderingOptions(ri.ImageFormat.TIFF)
image_options.compression = ri.Compression.NONE

# Create an ImageDevice and specify options and output file
device = ri.ImageDevice(image_options, save_path)

# Render HTML to TIFF
doc.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.

import os
import aspose.html as ah
import aspose.html.rendering.xps as rx
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 a path to the source HTML file
document_path = os.path.join(data_dir, "document.html")

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

# Create an instance of XPS Rendering Options
options = rx.XpsRenderingOptions()

# Set custom page size (5 x 2 inches)
options.page_setup.any_page = dr.Page(dr.Size(dr.Length.from_inches(5.0), dr.Length.from_inches(2.0)))

# Prepare a path to save the converted file
save_path = os.path.join(output_dir, "document-options.xps")

# Create an XpsDevice with the specified options and output file
device = rx.XpsDevice(options, save_path)

# Render HTML to XPS
doc.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:

import os
import aspose.html as ah
import aspose.html.rendering.doc as rd
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 a path to the source HTML file
document_path = os.path.join(data_dir, "document.html")

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

# Create an instance of DocRenderingOptions and set a custom page size
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

# Prepare a path to save the converted file
save_path = os.path.join(output_dir, "document-options.docx")

# Create a DocDevice with the specified options and output file
device = rd.DocDevice(options, save_path)

# Render HTML to DOCX
doc.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.