SaveAsPdfR Metod

SaveAsPdfR utför först den vanliga SaveAs och lägger sedan en inkrementell uppdatering ovanpå de sparade byten som bifogar PDF/R-1- filformatsmarkörer. PDF/R-1 (ISO 23504-1:2020) är den strikta delmängden av PDF för överföring av rasterbilder som används av TWAIN Working Group för arbetsflöden med skannade dokument; den har en rasterbuffer med fast storlek per sida och stöder endast bitonala / gråskala / RGB-bilder samt komprimeringen FlateDecode / CCITTFaxDecode / DCTDecode

Efterbearbetningen injicerar fem klasser av byte i den sparade strömmen:

• Versionsidentifieringskommentaren %PDF-raster-1.0, skriven mellan trailer-dictionaryn och nyckelordet startxref (ISO 23504-1 §5). Den är unik för PDF/R — de övriga PDF/x-standarderna identifierar sig genom XMP och Info-dictionary-poster i stället
• Dokumentkatalogen nedbantad till vitlistan i §6.3. Endast de valfria posterna Version / ViewerPreferences / PageLayout / PageMode / AcroForm / Metadata bevaras; alla övriga katalogposter (Names / Outlines / Dests / StructTreeRoot / OutputIntents / Lang / PageLabels / OCProperties / etc.) tas bort
• Document Information Dictionary nedbantad till vitlistan i §6.4.3. Endast Creator / Producer / CreationDate / ModDate bevaras; Title / Author / Subject / Keywords / Trapped tas bort
• En katalog /Metadata XMP-ström som bär de fyra egenskaperna i §6.4.4 Table 1 (xmp:CreatorTool, pdf:Producer, xmp:CreateDate, xmp:ModifyDate) plus xmp:MetadataDate
• En /ID-array i trailern (rekommenderas av exemplet i §5)

Utmatningen förblir byte-identisk med basresultatet från SaveAs fram till slutet på den ursprungliga PDF-filen; endast den inkrementella uppdateringen läggs till (och källans katalog / Info ersätts med nedbantade versioner via omskrivning med samma objektnummer). De två överlagringarna skiljer sig bara i hur konfigurationen skickas in: formen med enbart filnamn använder TPdfRSaveOptions.Default med automatisk ifyllning av de fyra Info-fälten och DocumentId från FPDF_GetMetaText / FPDF_GetFileIdentifier

Returnerar True vid lyckat resultat

• SaveAsPdfR bifogar filformatsmarkörerna på den nivå som PDF/R kräver — den garanterar inte att käll-PDF:ens innehåll redan uppfyller PDF/R:s strukturella begränsningar. PDF/R är mycket striktare än de övriga PDF/x-standarderna: varje sida måste ha exakt en /Contents-post, MediaBox måste vara [0 0 w h], endast filtren FlateDecode / CCITTFaxDecode (bitonal) / DCTDecode (8-bit gråskala eller RGB) tillåts, inga objektströmmar, varje indirekt referens måste ha generationsnummer noll och varje sida är i praktiken en enda rasterbild. PDFium-genererade dokument som redan följer det här mönstret (till exempel skannerutmatning som passerat PDFium för ompaketering) fungerar bra; innehållsrika PDF-filer i allmänhet gör det vanligtvis inte
• Använd ValidatePdfR efter SaveAsPdfR för att bekräfta vad källan faktiskt uppnår. Kombinera med en PDF/R-validator från TWAIN Working Group för fullständig verifiering på innehållsnivå
• TPdfRSaveOptions.StripCatalogOptionalEntries och StripInfoOptionalEntries har standardvärdet True; sätt dem till False om du vill att injektorn ska bevara alla källposter (utmatningen uppfyller då inte §6.3 / §6.4.3 men versionsmarkören och XMP bifogas ändå)
• Kryptering tillåts av PDF/R §6.2.3, men endast med ett %PDF-2.0-huvud och AES-kryptering. PDFium-genererade PDF-filer använder ett 1.x-huvud, så krypterad utmatning är inte en PDF/R-1-kandidat utan ytterligare omsparning