Libreria di componenti PDFium Delphi Component

Firme digitali — PAdES

Firma completa, non semplice lettura delle firme. PDFium può segnalare che un dizionario di firma esiste; PDFium Delphi Component lo crea

• Livelli baseline: B-B, B-T, B-LT e B-LTA secondo ETSI EN 319 142-1 V1.2.1, tramite SignPades, SignPadesToStream e SignPadesBytes
• Contenitore della firma: CMS / CAdES SignedData costruito secondo RFC 5652 con gli attributi firmati richiesti dal profilo — content-type, message-digest, signing-certificate-v2 e commitment-type-indication
• Marche temporali: client RFC 3161 TimeStampReq / TimeStampResp con trasporto WinHttp, che incorpora il token come attributo non firmato signature-time-stamp
• Validazione a lungo termine: iniezione del Document Security Store con /Certs, /OCSPs e /CRLs, dizionari VRI per singola firma e marcatore /Extensions /ESIC
• Marche temporali di archivio: dizionari Document Time-stamp con /SubFilter /ETSI.RFC3161 che coprono l'intero file, per B-LTA
• Accesso alle chiavi: backend Windows CNG con supporto per RSA-PSS, RSA PKCS#1 ed ECDSA, dietro un'interfaccia ICmsSigner che qualsiasi altro backend può implementare
• Firma remota e HSM: PreparePadesRemoteSignature e CompletePadesRemoteSignature scompongono l'operazione così che la chiave privata possa rimanere all'interno di un servizio remoto o di un modulo hardware
• Validazione: ValidatePades riporta la baseline più alta raggiunta dal documento più codici di problema a livello di clausola; ValidatePadesTrust e ValidatePadesTrustAsync aggiungono il controllo di affidabilità della catena di certificati
• Elenchi fidati europei: istantanee autenticate degli elenchi fidati ETSI offrono caching offline con checksum, aggiornamenti a cura del chiamante, trust anchor correnti e valutazione dei servizi qualificati senza accesso alla rete all'interno del validatore
• Integrazione con l'archiviazione: SignPadesWithPdfA converte in PDF/A-4 e firma in una sola chiamata, secondo l'allegato A.7 di EN 319 142-1

Cifratura e integrità dei documenti

PDFium apre i file cifrati, ma non scrive la cifratura. PDFium Delphi Component implementa il lato scrittura secondo ISO 32000-2 e le sue specifiche tecniche

• AES-256 PDF 2.0: SaveAsEncrypted con derivazione delle chiavi V=5 / R=5 / R=6, inclusa l'iterazione hash dell'algoritmo 2.B, e le voci di dizionario /O /U /OE /UE /Perms
• Analisi dell'intero documento: cifratura di stream e stringhe letterali con correzione corretta di /Length e tabella dei riferimenti incrociati ricostruita
• AES-GCM: cifratura autenticata ISO/TS 32003 V=6 / R=7, inclusa la decifratura autenticata di stringhe e stream AESV4
• PDF MAC: token /AuthCode autonomi secondo ISO/TS 32004 — CMS AuthenticatedData con derivazione delle chiavi HKDF, key wrapping e verifica HMAC
• Revisioni cifrate: gli aggiornamenti incrementali R5, R6 e R7 ereditano il dizionario di sicurezza esistente, cifrano le stringhe e gli stream modificati, preservano le generazioni degli oggetti e validano o rinnovano l'autenticazione PDF MAC
• Primitive: AES-128/256 in CBC e GCM, SHA-256/384/512, SHA-3, HMAC e lettura e scrittura ASN.1 DER, tutto in Object Pascal puro senza dipendenze C esterne, verificato rispetto ai vettori di test pubblicati FIPS 197, FIPS 180-4 e NIST SP 800-38D

Conformità agli standard

Sei famiglie di standard ISO, ciascuna con un validatore che restituisce codici di risultato a livello di clausola e un corrispondente percorso di salvataggio o di iniezione di marcatori

• PDF/A: ISO 19005 parti da 1 a 4 — inclusa la base A-4 basata su PDF 2.0 con i profili A-4f e A-4e — copre gli output intent, l'identificazione XMP, l'incorporamento dei font, la struttura RoleMap e ParentTree, i limiti di implementazione dell'allegato C e le azioni vietate
• PDF/X: ISO 15930 da X-1a fino a X-6 basato su PDF 2.0, copre la forma dell'output intent, la trasparenza vincolata dal profilo e le restrizioni degli spazi colore, e la geometria TrimBox / ArtBox / BleedBox
• PDF/UA: ISO 14289-1, copre la struttura di tabelle ed elenchi, i modelli di intestazione, la risoluzione RoleMap, il contenuto reale non contrassegnato, il contenimento degli Artifact, l'estrazione Unicode e ActualText con ambito di oggetto, la codifica dei font TrueType e compositi e le esenzioni delle annotazioni
• PDF/E: ISO 24517-1, inclusa l'iniezione dell'output intent sRGB incorporato e le regole sui font per i documenti di ingegneria
• PDF/VT: ISO 16612-2 VT-1 e VT-2, gerarchie DPart, metadati delle parti di documento e confezionamento multipart MIME degli stream VT-2s
• PDF/R: ISO 23504-1, impone una sola immagine a striscia per pagina, l'elenco delle codifiche consentite e la coerenza tra cifratura e versione
• Preflight: un aggregatore di report trasversale agli standard che esporta TXT, HTML, Markdown, JSON, CSV, SARIF 2.1.0, JUnit XML e NDJSON, con impronte SHA-256 dei report stabili e un runner da riga di comando il cui codice di uscita può governare la CI

Serializzazione PDF e revisioni

Il motore offre un unico salvataggio sequenziale dell'intero file. Le applicazioni spesso necessitano di molto di più, così PDFium Delphi Component scrive le proprie revisioni sopra l'output semantico del motore

• Output linearizzato: SaveAsLinearized produce file Fast Web View con raggruppamento della prima pagina, due sezioni di riferimenti incrociati e tabelle di hint degli offset di pagina e degli oggetti condivisi dell'allegato F
• Impacchettamento degli oggetti: SaveAsObjectStream raggruppa gli oggetti idonei in /ObjStm con ordinamento locale per pagina e copertura completa dei riferimenti incrociati di tipo 2
• Revisioni incrementali: BeginIncrementalSave e CommitIncrementalSave aggiungono solo gli oggetti indiretti modificati e nuovi a sorgenti cifrate o non cifrate, preservando byte per byte l'output precedente insieme a /Prev, /Encrypt, /Info e al /ID permanente; un commit senza modifiche non fa crescere il file
• Riparazione: SaveAsRepaired scrive una copia a revisione singola e la riverifica con un caricamento rigoroso indipendente prima di consegnarla
• Criteri di caricamento: modalità strict, compatible e recovery con diagnostica strutturata che riporta il percorso di ricostruzione, gli offset dei danneggiamenti, le revisioni in conflitto e lo stato dei budget
• Interrogazione nativa della versione: TPdf.PdfVersion riutilizza lo stato del parser di PDFium ed esegue solo una verifica di guardia a otto byte dell'intestazione invece di riparaggiare il documento sorgente
• Archivio di lavoro: TPdfRandomAccessStore mantiene i dati intermedi in memoria fino a SaveMemoryLimit, quindi migra verso un file temporaneo esclusivo eliminato alla chiusura; la post-elaborazione del salvataggio principale usa la stessa policy per tutti e tre gli spazi di lavoro, mentre gli aggiornamenti predefiniti del catalogo open-action e delle etichette di pagina usano finestre delimitate e un indice sparso

Servizi sui contenuti che PDFium non espone

• XFDF e FDF: importazione ed esportazione dei valori dei campi modulo e di 18 sottotipi di annotazione, secondo ISO 19444-1 e ISO 32000-1 §12.7.11, serializzati interamente in Pascal sul modello dati del componente
• XMP: un lettore e scrittore di pacchetti con contenitori tipizzati, usato da ogni profilo di standard
• Associated Files: array /AF secondo ISO 32000-2 §7.11.4 allegati al catalogo o a una pagina di destinazione, con gli otto valori di relazione della Table 45
• Integrazione OCR: IPdfOcrProvider accetta qualsiasi motore di riconoscimento — il componente fornisce le bitmap di pagina e scrive il livello di testo ricercabile risultante, con stato per pagina e salto del testo esistente
• Testo strutturato e tabelle: GetStructuredText costruisce una gerarchia pagina / blocco / riga / segmento stilizzato a partire dalla geometria dei caratteri e dalla semantica del PDF con tag; ExtractTables e ExtractDocumentTables rilevano le tabelle con bordi e quelle allineate sugli spazi, preservano le celle unite, attribuiscono punteggi di confidenza ed emettono CSV o JSON
• Reflusso semantico: BuildReflowDocument trasforma un PDF a layout fisso in un albero di nodi il cui output HTML sicuro preserva intestazioni, paragrafi, elenchi, figure, sezioni di pagina e celle delle tabelle
• Metriche di layout e testo: un costruttore di layout con vincoli keep-together, keep-with-next, vedova, orfana e interruzione di pagina esplicita, tabelle su più pagine e archiviazione dei comandi impaginati su disco con materializzazione LRU delimitata; MeasureText e WrapText forniscono il testo a capo senza aggiungere nulla a una pagina
• Text shaping: supporto dello shaping a livello di glifo per gli script da destra a sinistra e complessi
• Generazione di CMap ToUnicode: senza di essa, il testo con font CID viene renderizzato correttamente ma non può essere copiato, cercato o letto ad alta voce
• Ispezione delimitata degli stream: TPdfStreamInspector decodifica oggetti stream arbitrari nel rispetto di espliciti budget su sorgente, dati grezzi, dati decodificati, rapporto di espansione e numero di stream, restituendo uno stato strutturato invece di esaurire la memoria su un file appositamente costruito

Componente TPdf - Motore di elaborazione documenti

Cuore del sistema di elaborazione PDF, TPdf gestisce tutte le operazioni a livello di documento, tra cui caricamento, salvataggio, estrazione del testo, elaborazione dei moduli e gestione dei metadati

• Gestione documenti: apertura da file, stream o buffer di memoria
• Elaborazione testo: capacità avanzate di estrazione e ricerca del testo
• Gestione moduli: supporto completo per moduli interattivi con JavaScript
• Sicurezza: supporto per PDF protetti da password, gestione dei permessi, scrittura della cifratura AES-256 PDF 2.0 e firma digitale PAdES
• Standard: validazione PDF/A, PDF/X, PDF/UA, PDF/E, PDF/VT e PDF/R con helper corrispondenti di salvataggio e iniezione di marcatori
• Accesso metadati: proprietà complete del documento, pacchetti XMP e recupero delle informazioni

Componente TPdfView - Controllo visualizzatore interattivo

Un controllo visuale sofisticato che fornisce una ricca esperienza di visualizzazione PDF con piena interazione utente

• Rendering di alta qualità: visualizzazione ottimizzata con più modalità di rendering
• Navigazione interattiva: zoom, scorrimento, rotazione e navigazione delle pagine
• Selezione del testo: selezione, copia e manipolazione del contenuto testuale
• Visualizzazione annotazioni: visualizzazione e interazione con le annotazioni PDF
• Mouse e tastiera: supporto completo per dispositivi di input con mappatura delle coordinate

Elaborazione documenti

• Caricamento di documenti PDF da file, stream, buffer di memoria o adattatori TStream su richiesta tramite LoadCustomDocument, con criteri compatible, strict e recovery oltre a diagnostica xref strutturata
• Creazione di copie di riparazione a revisione singola con verifica rigorosa indipendente tramite SaveAsRepaired
• Salvataggio ed esportazione di documenti con varie opzioni (incrementale, rimozione della sicurezza, versione PDF di destinazione esplicita)
• Il validatore di conformità della versione PDF rifiuta funzionalità più recenti del target scelto (PDF 1.0 - 1.7)
• Creazione PDF/A-1b tramite SaveAsPdfA / SaveAsPdfAToStream con profilo ICC sRGB incluso e supporto per profili personalizzati
• Validazione PDF/A tramite ValidatePdfA e proprietà di sola lettura PdfAConformance
• Gestione di PDF protetti da password e cifrati
• Gestione di metadati e proprietà del documento
• Composizione delle pagine: MergeFiles (unione in batch con sorgenti delimitate), ImportPagesByIndex (importazione di un sottoinsieme), ImportNPagesToOne (griglia N-up), MovePages (riordino in posto)
• Riutilizzo di pagine tramite Form XObject: applicare una pagina su molte tramite CreateXObjectFromPage e InsertFormObjectFromXObject
• Supporto per segnalibri e destinazioni
• Appiattimento dei moduli: rigenerazione degli stream di aspetto (/AP) dai valori dei campi, quindi consolidamento di annotazioni e widget di modulo nel contenuto statico della pagina

Operazioni su testo e contenuti

• Estrazione avanzata del testo con preservazione della formattazione
• Ricerca testuale potente con molteplici opzioni
• Analisi e posizionamento del testo a livello di carattere
• Accesso alle informazioni e proprietà dei font
• Operazioni di selezione del testo e degli appunti
• Supporto multilingua e Unicode

Moduli interattivi e annotazioni

• Supporto completo per i campi dei moduli interattivi
• Campi di testo, caselle di controllo, pulsanti di opzione, caselle combinate
• Validazione del modulo ed esecuzione JavaScript
• Visualizzazione e interazione con annotazioni
• Annotazioni di collegamento e link web
• Firme digitali: firma PAdES da B-B a B-LTA, marche temporali RFC 3161, firma remota / HSM e validazione dell'affidabilità

Rendering visivo e visualizzazione

• Rendering anti-aliased di alta qualità con scrittura diretta a zero copia nel buffer DIB di destinazione
• Rendering progressivo annullabile tramite RenderPageProgressive e IPdfCancellationToken
• Download progressivo nativo tramite TPdfProgressiveDocument, inclusi hint sparse per byte-range, pianificazione degli intervalli con priorità, tentativi delimitati, annullamento e gate di disponibilità di documento, modulo e pagina
• Output Fast Web View tramite SaveAsLinearized, incluso il raggruppamento della prima pagina, due sezioni di riferimenti incrociati e le tabelle di hint degli offset di pagina e degli oggetti condivisi dell'allegato F
• Impacchettamento moderno degli oggetti PDF 1.5+ tramite SaveAsObjectStream, inclusi gruppi ObjStm delimitati, ordinamento locale per pagina e copertura completa degli xref di tipo 2
• Sessioni di revisione a oggetti modificati tramite BeginIncrementalSave e CommitIncrementalSave, inclusa la preservazione del prefisso cifrato, i parametri di sicurezza ereditati, i commit senza effetto, la validazione rigorosa alla riapertura, file laterali durevoli, sostituzione atomica, rollback e statistiche per commit
• Archivio di lavoro ad accesso casuale delimitato tramite TPdfRandomAccessStore e SaveMemoryLimit, incluso lo spill sicuro su file temporaneo, l'I/O posizionale e le diagnostiche di picco per salvataggio
• Più modalità di visualizzazione (singola continua, due pagine continua, due pagine con copertina)
• FitMode sceglie come la pagina si dispone nel viewport (zoom manuale, dimensioni reali, adatta pagina, adatta larghezza); riapplicato automaticamente al Resize / cambio pagina
• PageColor disaccoppia lo sfondo della pagina PDF renderizzata dal Color del controllo circostante per i visualizzatori in modalità scura
• Evidenziazione dei risultati di ricerca tramite HighlightSearchText e ClearHighlight
• Ombra opzionale (PageShadowSize / PageShadowColor) e bordo pagina (PageBorderColor)
• Gestione sicura del clic sui link con liste di consentiti per azione (LinkOptions) ed eventi OnAnnotationLinkClick / OnWebLinkClick
• Blocco dell'input utente (AllowUserPageChange, ChangePageOnMouseScrolling, AllowUserTextSelection) per chioschi e integrazioni di sola lettura
• Navigazione tramite miniature con il componente pannello laterale TPdfThumbnailView
• Rendering del testo ottimizzato per LCD
• Output di qualità per la stampa con modalità di stampa PDFium selezionabili (EMF, solo testo, PostScript Level 2 / 3, pass-through, image-mask, Type 42)
• Rendering personalizzato a colori e in scala di grigi

Funzionalità a favore degli sviluppatori

• Sistema di eventi completo per la personalizzazione
• Mappatura precisa delle coordinate tra schermo e PDF
• Ampie API di proprietà e metodi
• Supporto a tempo di design con editor di proprietà
• Operazioni thread-safe dove applicabile
• Elaborazione efficiente in memoria per documenti di grandi dimensioni

Architettura a livelli

Gerarchia dei componenti

• TPdf (TComponent) - Componente non visuale per le operazioni sui documenti PDF
• TPdfView (TScrollingWinControl) - Controllo visuale che eredita le capacità di scorrimento e focus
• TPdfThumbnailView (TCustomControl) - Pannello laterale scorrevole per la navigazione tramite miniature collegato a un componente TPdf

Pattern di progettazione chiave

• Caricamento dinamico della DLL: le funzioni PDFium vengono caricate a runtime tramite GetProcAddress
• Risorse basate su handle: documenti PDF, pagine e oggetti gestiti tramite handle opachi
• Architettura guidata dagli eventi: eventi estesi per l'interazione con i moduli, cambi di pagina e rendering
• Tipi basati su record: strutture dati complesse esposte come record Delphi (TBookmark, TDestination, TPdfAnnotation, ecc.)
• Helper opt-in: FPdfAsync e FPdfMatrix forniscono utility di cancellazione/future e di trasformazione senza imporle al componente TPdf principale

Applicazioni aziendali

• Sistemi di gestione documentale: visualizzare, organizzare ed elaborare documenti PDF
• Visualizzatori di report: visualizzare report generati e documenti aziendali
• Elaborazione moduli: gestire moduli PDF interattivi e raccolta dati
• Sistemi di archiviazione: accedere e visualizzare documenti PDF storici

Istruzione e ricerca

• Piattaforme di e-learning: visualizzare materiali didattici e libri di testo
• Strumenti di ricerca: analizzare ed estrarre dati da pubblicazioni accademiche
• Biblioteche digitali: sfogliare e cercare collezioni documentali
• App per appunti: annotare ed evidenziare contenuti PDF

Legale e conformità

• Revisione di documenti legali: esaminare contratti e documenti legali
• Sistemi di conformità: verificare l'integrità dei documenti e delle firme
• Gestione casi: organizzare e revisionare la documentazione legale
• Strumenti di audit: elaborare e analizzare documenti normativi

Tecnico e ingegneristico

• Visualizzatori CAD: visualizzare disegni tecnici e specifiche
• Sistemi di manualistica: accedere a manuali di manutenzione e operativi
• Controllo qualità: revisionare report di test e certificazioni
• Gestione progetti: gestire documentazione di progetto e piani

Prestazioni e affidabilità

• Rendering consolidato: il rendering delle pagine usa la famiglia di motori PDFium alla base della visualizzazione PDF di Chromium, mentre tutto ciò che sta sopra è un'implementazione Object Pascal di losLab
• Prestazioni elevate: scritture DIB a zero copia, rendering progressivo annullabile, rendering parallelo delle pagine, caricamento seekable su richiesta che evita una copia iniziale in memoria e un unico budget di byte misurabile su scene di pagina trattenute e istantanee gestite
• Stabilità con input ostile: la decodifica degli stream, la normalizzazione dei contenuti e la scansione della struttura girano sotto espliciti budget su sorgente, output, token, annidamento e rapporto di espansione, così un file malformato o appositamente costruito restituisce uno stato strutturato invece di esaurire la memoria
• Scalabilità: gestisce sia moduli piccoli sia documenti di molti gigabyte, con un archivio di lavoro delimitato che trabocca su un file temporaneo eliminato alla chiusura

Valore aziendale

• Sviluppo rapido: 475 membri pubblici di TPdf e 36 progetti pronti all'uso riducono i tempi di sviluppo
• Un unico fornitore per firma e cifratura: le firme PAdES e la cifratura PDF 2.0 fanno parte di questa libreria — nessun SDK di firma separato, nessun deployment di OpenSSL, nessuna seconda licenza da negoziare
• Royalty-free: nessuna tariffa a runtime né complicazioni di licenza
• Codice sorgente incluso: piena personalizzazione e debug, fino alle primitive crittografiche, che sono Object Pascal puro senza dipendenze C esterne da far passare in una revisione di sicurezza
• Supporto a lungo termine: aggiornamenti regolari e manutenzione della compatibilità su Delphi e C++Builder da XE5 a 13.1 Florence, oltre a Lazarus / Free Pascal

Esperienza dello sviluppatore

• Integrazione facile: componenti pronti all'uso con configurazione minima
• Documentazione ricca: guide complete ed esempi
• Guidato dagli eventi: personalizzazione flessibile tramite numerosi eventi
• Supporto a tempo di design: editor di proprietà e integrazione con l'IDE