SaveAsPdfR Metodo

SaveAsPdfR esegue prima il normale SaveAs, poi sovrappone un aggiornamento incrementale ai byte salvati che applica le marcature di formato file PDF/R-1. PDF/R-1 (ISO 23504-1:2020) è il sottosistema rigoroso di trasporto di immagini raster del PDF usato dal TWAIN Working Group per i flussi di lavoro con documenti scansionati; porta un buffer raster di dimensione fissa per pagina, supporta immagini bitonali / in scala di grigio / RGB e solo la compressione FlateDecode / CCITTFaxDecode / DCTDecode

Il post-processing inietta cinque classi di byte nello stream salvato:

• Il commento di identificazione di versione %PDF-raster-1.0, scritto tra il dizionario trailer e la parola chiave startxref (ISO 23504-1 §5). È una peculiarità di PDF/R — gli altri standard PDF/x si identificano invece tramite voci XMP e del dizionario Info
• Il catalogo del documento ridotto alla whitelist del §6.3. Solo le voci opzionali Version / ViewerPreferences / PageLayout / PageMode / AcroForm / Metadata vengono conservate; tutte le altre voci del catalogo (Names / Outlines / Dests / StructTreeRoot / OutputIntents / Lang / PageLabels / OCProperties / ecc.) vengono rimosse
• Il Document Information Dictionary ridotto alla whitelist del §6.4.3. Vengono conservati solo Creator / Producer / CreationDate / ModDate; Title / Author / Subject / Keywords / Trapped vengono rimossi
• Uno stream XMP /Metadata nel catalogo con le quattro proprietà della Tabella 1 del §6.4.4 (xmp:CreatorTool, pdf:Producer, xmp:CreateDate, xmp:ModifyDate) più xmp:MetadataDate
• Un array /ID nel trailer (consigliato dall'esempio del §5)

L'output resta byte-identico al risultato del SaveAs base fino alla fine del PDF originale; viene appeso solo l'aggiornamento incrementale (e il catalogo / Info della sorgente vengono sostituiti con versioni ridotte tramite riscrittura a parità di numero d'oggetto). I due overload differiscono solo nel modo in cui la configurazione viene passata: la forma con solo nome file usa TPdfRSaveOptions.Default con auto-popolamento dei quattro campi Info e di DocumentId da FPDF_GetMetaText / FPDF_GetFileIdentifier

Restituisce True in caso di successo

• SaveAsPdfR applica le marcature a livello di formato file che PDF/R richiede — non garantisce che il contenuto del PDF sorgente soddisfi già le restrizioni strutturali di PDF/R. PDF/R è molto più severo degli altri standard PDF/x: ogni pagina deve avere esattamente una voce /Contents, il MediaBox deve essere [0 0 w h], sono ammessi solo i filtri FlateDecode / CCITTFaxDecode (bitonale) / DCTDecode (8-bit grigio o RGB), niente object stream, ogni riferimento indiretto deve avere numero di generazione zero, e ogni pagina è di fatto una singola immagine raster. I documenti generati da PDFium che già rispettano questo schema (es. output di scanner ripassati da PDFium per il repackaging) funzionano bene; i PDF generici ricchi di contenuti tipicamente no
• Usa ValidatePdfR dopo SaveAsPdfR per confermare ciò che la sorgente ottiene davvero. Abbinalo a un validatore PDF/R del TWAIN Working Group per la verifica completa a livello di contenuto
• TPdfRSaveOptions.StripCatalogOptionalEntries e StripInfoOptionalEntries valgono True per predefinito; impostale False se vuoi che l'injector conservi tutte le voci della sorgente (l'output allora non rispetterà §6.3 / §6.4.3 ma la marcatura di versione e l'XMP vengono comunque applicate)
• La crittografia è permessa da PDF/R §6.2.3, ma solo con intestazione %PDF-2.0 e crittografia AES. I PDF generati da PDFium usano intestazione 1.x, quindi l'output crittografato non è un candidato PDF/R-1 senza un ulteriore risalvataggio