Biblioteca de PDFium Delphi Component

Firmas digitales — PAdES

Firma completa, no solo lectura de firmas. PDFium puede informar que existe un diccionario de firma; PDFium Delphi Component crea uno

• Niveles de línea base: B-B, B-T, B-LT y B-LTA según ETSI EN 319 142-1 V1.2.1, mediante SignPades, SignPadesToStream y SignPadesBytes
• Contenedor de firma: CMS / CAdES SignedData construido según RFC 5652 con los atributos firmados que exige el perfil — content-type, message-digest, signing-certificate-v2 y commitment-type-indication
• Marcas de tiempo: cliente RFC 3161 TimeStampReq / TimeStampResp con transporte WinHttp, que incrusta el token como atributo sin firmar signature-time-stamp
• Validación a largo plazo: inyección de Document Security Store con /Certs, /OCSPs y /CRLs, diccionarios VRI por firma y el marcador /Extensions /ESIC
• Marcas de tiempo de archivo: diccionarios Document Time-stamp con /SubFilter /ETSI.RFC3161 que cubren el archivo completo, para B-LTA
• Acceso a claves: backend CNG de Windows con soporte de RSA-PSS, RSA PKCS#1 y ECDSA, tras una interfaz ICmsSigner que cualquier otro backend puede implementar
• Firma remota y por HSM: PreparePadesRemoteSignature y CompletePadesRemoteSignature dividen la operación para que la clave privada permanezca dentro de un servicio remoto o un módulo de hardware
• Validación: ValidatePades informa el nivel de línea base más alto que alcanza el documento más códigos de problema a nivel de cláusula; ValidatePadesTrust y ValidatePadesTrustAsync agregan la verificación de confianza de la cadena de certificados
• Listas de confianza europeas: instantáneas autenticadas de listas de confianza de ETSI que proporcionan caché sin conexión con sumas de verificación, actualizaciones a cargo del llamador, anclas de confianza actuales y evaluación de servicios calificados sin acceso a la red dentro del validador
• Integración con archivo: SignPadesWithPdfA convierte a PDF/A-4 y firma en una sola llamada, según EN 319 142-1 Annex A.7

Cifrado e integridad del documento

PDFium abre archivos cifrados. No escribe cifrado. PDFium Delphi Component implementa el lado de escritura conforme a ISO 32000-2 y sus especificaciones técnicas

• AES-256 de PDF 2.0: SaveAsEncrypted con derivación de clave V=5 / R=5 / R=6, incluida la iteración de hash del algoritmo 2.B, y las entradas de diccionario /O /U /OE /UE /Perms
• Barrido del documento completo: cifrado de flujos y cadenas literales con corrección correcta de /Length y una tabla de referencias cruzadas reconstruida
• AES-GCM: cifrado autenticado ISO/TS 32003 V=6 / R=7, incluido el descifrado autenticado de cadenas y flujos AESV4
• PDF MAC: tokens independientes /AuthCode de ISO/TS 32004 — CMS AuthenticatedData con derivación de clave HKDF, encapsulado de clave y verificación HMAC
• Revisiones cifradas: las actualizaciones incrementales R5, R6 y R7 heredan el diccionario de seguridad existente, cifran las cadenas y los flujos modificados, preservan las generaciones de objetos y validan o renuevan la autenticación PDF MAC
• Primitivas: AES-128/256 en CBC y GCM, SHA-256/384/512, SHA-3, HMAC y lectura y escritura de ASN.1 DER, todo en Object Pascal puro sin dependencias C externas, verificado contra los vectores de prueba publicados de FIPS 197, FIPS 180-4 y NIST SP 800-38D

Conformidad con estándares

Seis familias de estándares ISO, cada una con un validador que devuelve códigos de resultado a nivel de cláusula y una ruta de guardado o inyección de marcadores correspondiente

• PDF/A: ISO 19005 partes 1 a 4 — incluidos la base A-4 basada en PDF 2.0 y los perfiles A-4f y A-4e — cubriendo output intents, identificación XMP, incrustación de fuentes, estructura RoleMap y ParentTree, límites de implementación del Annex C y acciones prohibidas
• PDF/X: ISO 15930 desde X-1a hasta el X-6 basado en PDF 2.0, cubriendo la forma del output intent, las restricciones de transparencia y de espacio de color controladas por perfil, y la geometría TrimBox / ArtBox / BleedBox
• PDF/UA: ISO 14289-1, cubriendo estructura de tablas y listas, modelos de encabezado, resolución de RoleMap, contenido real sin etiquetar, contención de Artifact, extracción de Unicode y ActualText en el ámbito de objetos, codificación de fuentes TrueType y compuestas, y exenciones de anotaciones
• PDF/E: ISO 24517-1, incluida la inyección de output intent sRGB incrustado y las reglas de fuentes para documentos de ingeniería
• PDF/VT: ISO 16612-2 VT-1 y VT-2, jerarquías DPart, metadatos de parte de documento y empaquetado de flujos multipart MIME VT-2s
• PDF/R: ISO 23504-1, exigiendo una imagen de franja por página, la lista de codificaciones permitidas y la coherencia de cifrado y versión
• Preflight: un agregador de informes multiestándar que exporta TXT, HTML, Markdown, JSON, CSV, SARIF 2.1.0, JUnit XML y NDJSON, con huellas de informe SHA-256 estables y un ejecutor de línea de comandos cuyo código de salida puede controlar una CI

Serialización y revisiones de PDF

El motor ofrece un único guardado secuencial del archivo completo. Las aplicaciones con frecuencia necesitan más que eso, así que PDFium Delphi Component escribe sus propias revisiones sobre la salida semántica del motor

• Salida linearizada: SaveAsLinearized produce archivos Fast Web View con agrupación de primera página, dos secciones de referencias cruzadas y las tablas de sugerencias de desplazamiento de página y objetos compartidos del Annex F
• Empaquetado de objetos: SaveAsObjectStream agrupa los objetos elegibles en /ObjStm con orden local por página y cobertura completa de referencias cruzadas de tipo 2
• Revisiones incrementales: BeginIncrementalSave y CommitIncrementalSave anexan solo los objetos indirectos nuevos y modificados a fuentes cifradas o no cifradas, preservando la salida anterior byte por byte junto con /Prev, /Encrypt, /Info y el /ID permanente; una confirmación sin cambios no hace crecer el archivo
• Reparación: SaveAsRepaired escribe una copia de una sola revisión y la reverifica con una carga estricta independiente antes de entregarla
• Políticas de carga: modos estricto, compatible y de recuperación con diagnósticos estructurados que informan la ruta de reconstrucción, los desplazamientos corruptos, las revisiones en conflicto y el estado del presupuesto
• Consulta nativa de versión: TPdf.PdfVersion reutiliza el estado del analizador de PDFium y solo realiza una verificación de encabezado de ocho bytes en lugar de volver a analizar el documento de origen
• Almacenamiento de trabajo: TPdfRandomAccessStore mantiene los datos intermedios en memoria hasta SaveMemoryLimit y luego migra a un archivo temporal exclusivo que se elimina al cerrar; el posprocesamiento del guardado principal usa la misma política para los tres espacios de trabajo, mientras que las actualizaciones predeterminadas del catálogo de open-action y de etiquetas de página usan ventanas acotadas y un índice disperso

Servicios de contenido que PDFium no expone

• XFDF y FDF: importación y exportación de valores de campos de formulario y 18 subtipos de anotación, según ISO 19444-1 e ISO 32000-1 §12.7.11, serializados por completo en Pascal sobre el propio modelo de datos del componente
• XMP: un lector y escritor de paquetes con contenedores tipados, usado por todos los perfiles de estándares
• Archivos asociados: arreglos /AF de ISO 32000-2 §7.11.4 adjuntos al catálogo o a una página destino, con los ocho valores de relación de la Table 45
• Integración de OCR: IPdfOcrProvider acepta cualquier motor de reconocimiento — el componente suministra los bitmaps de página y escribe la capa de texto buscable resultante, con estado por página y omisión de texto existente
• Texto estructurado y tablas: GetStructuredText construye una jerarquía página / bloque / línea / tramo con estilo a partir de la geometría de caracteres y la semántica de Tagged PDF; ExtractTables y ExtractDocumentTables detectan tablas con bordes y alineadas por espacios en blanco, preservan tramos combinados, puntúan la confianza y emiten CSV o JSON
• Reflow semántico: BuildReflowDocument convierte un PDF de diseño fijo en un árbol de nodos cuya salida HTML segura preserva encabezados, párrafos, listas, figuras, secciones de página y tramos de tabla
• Métricas de diseño y texto: un constructor de diseño con restricciones de mantener junto, mantener con el siguiente, viudas, huérfanas y salto de página explícito, tablas que cruzan páginas y almacenamiento de comandos paginado en disco con materialización LRU acotada; MeasureText y WrapText proporcionan ajuste de línea sin agregar nada a una página
• Conformación de texto: soporte de conformación a nivel de glifo para escrituras de derecha a izquierda y complejas
• Generación de CMap ToUnicode: sin ella, el texto con fuentes CID se renderiza correctamente pero no se puede copiar, buscar ni leer en voz alta
• Inspección de flujos acotada: TPdfStreamInspector decodifica objetos de flujo arbitrarios bajo presupuestos explícitos de origen, bytes sin procesar, decodificados, razón de expansión y cantidad de flujos, devolviendo un estado estructurado en lugar de agotar la memoria con un archivo malicioso

Componente TPdf — Motor de procesamiento de documentos

El corazón del sistema de procesamiento PDF, TPdf maneja todas las operaciones a nivel de documento, incluida la carga, el guardado, la extracción de texto, el procesamiento de formularios y la gestión de metadatos

• Gestión de documentos: abra desde archivos, streams o búferes de memoria
• Procesamiento de texto: capacidades avanzadas de extracción y búsqueda de texto
• Manejo de formularios: soporte completo para formularios interactivos con JavaScript
• Seguridad: soporte para PDF protegidos con contraseña, gestión de permisos, escritura de cifrado AES-256 de PDF 2.0 y firma digital PAdES
• Estándares: validación de PDF/A, PDF/X, PDF/UA, PDF/E, PDF/VT y PDF/R con funciones auxiliares de guardado e inyección de marcadores correspondientes
• Acceso a metadatos: propiedades completas del documento, paquetes XMP y recuperación de información

Componente TPdfView — Control de visor interactivo

Un sofisticado control visual que proporciona una experiencia rica de visualización de PDF con capacidades completas de interacción del usuario

• Renderizado de alta calidad: visualización optimizada con múltiples modos de renderizado
• Navegación interactiva: zoom, desplazamiento, rotación y navegación de páginas
• Selección de texto: seleccione, copie y manipule contenido textual
• Visualización de anotaciones: vea e interactúe con anotaciones PDF
• Mouse y teclado: soporte completo para dispositivos de entrada con mapeo de coordenadas

Procesamiento de documentos

• Cargue documentos PDF desde archivos, streams, búferes de memoria o adaptadores TStream bajo demanda mediante LoadCustomDocument, con políticas compatible, estricta y de recuperación además de diagnósticos xref estructurados
• Cree copias de reparación de una sola revisión con verificación estricta independiente mediante SaveAsRepaired
• Guarde y exporte documentos con diversas opciones (incremental, eliminar seguridad, versión PDF de destino explícita)
• El validador de conformidad de versiones PDF rechaza características más nuevas que la versión de destino elegida (PDF 1.0 a 1.7)
• Creación PDF/A-1b a través de SaveAsPdfA / SaveAsPdfAToStream con perfil ICC sRGB incluido y soporte para perfiles personalizados
• Validación PDF/A mediante ValidatePdfA y la propiedad de solo lectura PdfAConformance
• Maneje PDF protegidos con contraseña y cifrados
• Gestión de metadatos y propiedades del documento
• Composición de páginas: MergeFiles (fusión por lotes de fuentes acotadas), ImportPagesByIndex (importación de subconjunto), ImportNPagesToOne (cuadrícula N-up), MovePages (reordenamiento en sitio)
• Reutilización de páginas mediante Form XObject: estampe una página en muchas a través de CreateXObjectFromPage e InsertFormObjectFromXObject
• Soporte para marcadores y destinos
• Aplanado de formularios: regenere los streams de apariencia (/AP) a partir de los valores de los campos y, luego, integre las anotaciones y los widgets de formulario en el contenido estático de la página

Operaciones de texto y contenido

• Extracción avanzada de texto con preservación del formato
• Búsqueda de texto potente con múltiples opciones
• Análisis y posicionamiento de texto a nivel de carácter
• Acceso a propiedades e información de fuentes
• Selección de texto y operaciones con el portapapeles
• Soporte multilingüe y Unicode

Formularios interactivos y anotaciones

• Soporte completo para campos de formulario interactivos
• Campos de texto, casillas de verificación, botones de opción, listas desplegables
• Validación de formularios y ejecución de JavaScript
• Visualización e interacción con anotaciones
• Anotaciones de enlace y enlaces web
• Firmas digitales: firma PAdES de B-B a B-LTA, marcas de tiempo RFC 3161, firma remota / por HSM y validación de confianza

Renderizado y visualización gráfica

• Renderizado de alta calidad con suavizado y escrituras directas sin copia (zero-copy) en el búfer DIB de destino
• Renderizado progresivo cancelable mediante RenderPageProgressive e IPdfCancellationToken
• Descarga progresiva nativa mediante TPdfProgressiveDocument, incluidas sugerencias de rangos de bytes dispersos, programación de rangos priorizada, reintentos acotados, cancelación y compuertas de disponibilidad de documento, formulario y página
• Salida Fast Web View mediante SaveAsLinearized, incluidas la agrupación de primera página, dos secciones de referencias cruzadas y las tablas de sugerencias de desplazamiento de página y objetos compartidos del Annex F
• Empaquetado moderno de objetos de PDF 1.5 o superior mediante SaveAsObjectStream, incluidos grupos ObjStm acotados, orden local por página y cobertura completa de xref de tipo 2
• Sesiones de revisión de objetos modificados mediante BeginIncrementalSave y CommitIncrementalSave, incluida la preservación del prefijo cifrado, parámetros de seguridad heredados, confirmaciones sin cambios, validación estricta de reapertura, archivos laterales duraderos, reemplazo atómico, reversión y estadísticas por confirmación
• Almacenamiento de trabajo de acceso aleatorio acotado mediante TPdfRandomAccessStore y SaveMemoryLimit, incluido el desborde seguro a archivos temporales, E/S posicional y diagnósticos de pico por guardado
• Múltiples modos de visualización (continuo de una página, continuo de dos páginas, dos páginas con portada)
• FitMode elige cómo se posiciona la página en el viewport (zoom manual, tamaño real, ajustar página, ajustar ancho); se reaplica automáticamente al redimensionar o cambiar de página
• PageColor desacopla el fondo de la página PDF renderizada del Color del control circundante, ideal para visores en modo oscuro
• Resaltado de resultados de búsqueda a través de HighlightSearchText y ClearHighlight
• Sombra paralela opcional (PageShadowSize / PageShadowColor) y borde de página (PageBorderColor)
• Manejo seguro de clics en enlaces con listas de permitidos por acción (LinkOptions) y eventos OnAnnotationLinkClick / OnWebLinkClick
• Restricción de la entrada del usuario (AllowUserPageChange, ChangePageOnMouseScrolling, AllowUserTextSelection) para kioscos e integraciones de solo lectura
• Navegación por miniaturas a través del componente de panel lateral TPdfThumbnailView
• Renderizado de texto optimizado para LCD
• Salida con calidad de impresión y modos de impresión PDFium seleccionables (EMF, solo texto, PostScript nivel 2 / 3, pass-through, image-mask, Type 42)
• Renderizado en escala de grises y con colores personalizados

Características amigables para el desarrollador

• Sistema integral de eventos para personalización
• Mapeo preciso de coordenadas entre la pantalla y el PDF
• API exhaustivas de propiedades y métodos
• Soporte en tiempo de diseño con editores de propiedades
• Operaciones seguras en hilos cuando es aplicable
• Procesamiento eficiente en memoria para documentos grandes

Arquitectura en capas

Jerarquía de componentes

• TPdf (TComponent) — componente no visual para operaciones con documentos PDF
• TPdfView (TScrollingWinControl) — control visual que hereda capacidades de desplazamiento y foco
• TPdfThumbnailView (TCustomControl) — panel lateral desplazable de miniaturas vinculado a un componente TPdf

Patrones de diseño clave

• Carga dinámica de DLL: las funciones de PDFium se cargan en tiempo de ejecución mediante GetProcAddress
• Recursos basados en handles: los documentos, páginas y objetos PDF se gestionan mediante handles opacos
• Arquitectura impulsada por eventos: eventos extensos para interacción con formularios, cambios de página y renderizado
• Tipos basados en records: estructuras de datos complejas expuestas como records de Delphi (TBookmark, TDestination, TPdfAnnotation, etc.)
• Helpers opcionales: FPdfAsync y FPdfMatrix proporcionan utilidades de cancelación/future y transformación sin imponerlas en el componente principal TPdf

Aplicaciones empresariales

• Sistemas de gestión documental: visualice, organice y procese documentos PDF
• Visores de reportes: muestre reportes generados y documentos empresariales
• Procesamiento de formularios: maneje formularios PDF interactivos y recolección de datos
• Sistemas de archivo: acceda y visualice documentos PDF históricos

Educación e investigación

• Plataformas de e-learning: muestre materiales de curso y libros de texto
• Herramientas de investigación: analice y extraiga datos de artículos académicos
• Bibliotecas digitales: explore y busque en colecciones de documentos
• Aplicaciones para tomar notas: anote y resalte contenido PDF

Legal y cumplimiento normativo

• Revisión de documentos legales: examine contratos y documentos legales
• Sistemas de cumplimiento: verifique la integridad de documentos y las firmas
• Gestión de casos: organice y revise documentación legal
• Herramientas de auditoría: procese y analice documentos regulatorios

Técnica e ingeniería

• Visores CAD: muestre dibujos técnicos y especificaciones
• Sistemas de manuales: acceda a manuales de operación y mantenimiento
• Control de calidad: revise reportes de pruebas y certificaciones
• Gestión de proyectos: maneje documentación y planes de proyectos

Rendimiento y confiabilidad

• Renderizado probado: el renderizado de páginas usa la familia de motores PDFium detrás de la visualización PDF de Chromium, mientras que todo lo que está por encima es una implementación propia de Object Pascal de losLab
• Alto rendimiento: escrituras DIB sin copia, renderizado progresivo cancelable, renderizado de páginas en paralelo, carga bajo demanda con capacidad de búsqueda que evita una copia previa en memoria y un presupuesto de bytes medible en todas las escenas de página retenidas y las instantáneas administradas
• Estabilidad ante entradas hostiles: la decodificación de flujos, la normalización de contenido y el escaneo de estructura se ejecutan bajo presupuestos explícitos de origen, salida, tokens, anidamiento y razón de expansión, de modo que un archivo malformado o malicioso devuelve un estado estructurado en lugar de agotar la memoria
• Escalabilidad: maneja desde formularios pequeños hasta documentos de varios gigabytes, con almacenamiento de trabajo acotado que se desborda a un archivo temporal que se elimina al cerrar

Valor para el negocio

• Desarrollo rápido: 475 miembros públicos de TPdf y 36 proyectos listos para ejecutar reducen el tiempo de desarrollo
• Un solo proveedor para firma y cifrado: las firmas PAdES y el cifrado de PDF 2.0 forman parte de esta biblioteca — sin SDK de firma aparte, sin despliegue de OpenSSL y sin una segunda licencia que negociar
• Libre de regalías: sin tarifas de ejecución ni complicaciones de licenciamiento
• Código fuente incluido: personalización y depuración completas, hasta las primitivas criptográficas, que son Object Pascal puro sin dependencias C externas que superar en una revisión de seguridad
• Soporte a largo plazo: actualizaciones regulares y mantenimiento de compatibilidad en Delphi y C++Builder desde XE5 hasta 13.1 Florence, además de Lazarus / Free Pascal

Experiencia del desarrollador

• Integración fácil: componentes listos para usar con configuración mínima
• Documentación rica: archivos de ayuda y ejemplos completos
• Impulsada por eventos: personalización flexible mediante eventos extensos
• Soporte en tiempo de diseño: editores de propiedades e integración con el IDE