Trabajar con artefactos PDF en Python

Los artefactos en PDF son objetos gráficos u otros elementos que no forman parte del contenido real del documento. Normalmente se utilizan para decoración, diseño o propósitos de fondo. Ejemplos de artefactos incluyen encabezados y pies de página, separadores o imágenes que no transmiten ningún significado.

El propósito de los artefactos en PDF es permitir la distinción entre elementos de contenido y elementos que no forman parte del contenido. Esto es importante para la accesibilidad, ya que los lectores de pantalla y otras tecnologías de asistencia pueden ignorar los artefactos y centrarse en el contenido relevante. Los artefactos también pueden mejorar el rendimiento y la calidad de los documentos PDF, ya que pueden omitirse en la impresión, la búsqueda o la copia.

Utilice esta sección cuando necesite crear o inspeccionar elementos PDF que no forman parte del contenido en Python, como fondos de documentos, marcas de agua de página y marcas de numeración Bates. Las siguientes guías muestran los principales flujos de trabajo de artefactos compatibles con Aspose.PDF for Python via .NET.

Para crear un elemento como artefacto en PDF, necesita usar la clase Artifact. Esta clase contiene las siguientes propiedades útiles:

  • custom_type - Obtiene el nombre del tipo de artefacto. Puede usarse si el tipo de artefacto no es estándar.
  • custom_subtype - Obtiene el nombre del subtipo de artefacto. Puede usarse si el subtipo de artefacto no es un subtipo estándar.
  • type - Obtiene el tipo de artefacto.
  • subtype - Obtiene el subtipo de artefacto. Si el artefacto tiene un subtipo no estándar, el nombre del subtipo puede leerse a través de CustomSubtype.
  • contents - Obtiene la colección de operadores internos del artefacto.
  • form - Obtiene el XForm del artefacto (si se usa XForm).
  • rectangle - Obtiene el rectángulo del artefacto.
  • position - Obtiene o establece la posición del artefacto. Si se especifica esta propiedad, entonces los márgenes y alineaciones se ignoran.
  • right_margin - Margen derecho del artefacto. Si la posición se especifica explícitamente (en la propiedad Position) este valor se ignora.
  • left_margin - Margen izquierdo del artefacto. Si la posición se especifica explícitamente (en la propiedad Position) este valor se ignora.
  • top_margin - Margen superior del artefacto. Si la posición se especifica explícitamente (en la propiedad Position) este valor se ignora.
  • bottom_margin - Margen inferior del artefacto. Si la posición se especifica explícitamente (en la propiedad Position) este valor se ignora.
  • artifact_horizontal_alignment - Alineación horizontal del artefacto. Si la posición se especifica explícitamente (en la propiedad Position) este valor se ignora.
  • artifact_vertical_alignment - Alineación vertical del artefacto. Si la posición se especifica explícitamente (en la propiedad Position) este valor se ignora.
  • rotation - Obtiene o establece el ángulo de rotación del artefacto.
  • text - Obtiene el texto del artefacto.
  • image - Obtiene la imagen del artefacto (si está presente).
  • opacity - Obtiene o establece la opacidad del artefacto. Los valores posibles están en el rango 0..1.
  • lines - Líneas del artefacto de texto multilínea.
  • text_state - Estado de texto para el texto del artefacto.
  • is_background - Si es verdadero, el Artefacto se coloca detrás del contenido de la página.

Las siguientes clases también pueden ser útiles para trabajar con artefactos:

Flujos de trabajo de artefactos cubiertos en esta sección

Por favor revise las siguientes secciones del artículo:

Estos tutoriales son útiles cuando necesitas gestionar elementos decorativos o estructurales del PDF sin cambiar el flujo de contenido principal del documento.

Trabajar con archivos adjuntos PDF en Python Accesibilidad y Tagged PDFs en Python