SaveAsPdfR Método

Esta entrada API conserva identificadores, firmas, bloques de código y términos PDF en su forma original.

Guarda el documento actual como un archivo conforme a PDF/R-1 (ISO 23504-1:2020, el subconjunto de PDF para transporte y almacenamiento de imágenes raster usado para documentos escaneados)

SaveAsPdfR realiza primero el SaveAs normal y después superpone una actualización incremental sobre los bytes guardados que adjunta marcadores de formato de archivo PDF/R-1. PDF/R-1 (ISO 23504-1:2020) es el subconjunto estricto de transporte de imágenes ráster de PDF usado por el TWAIN Working Group para flujos de trabajo de documentos escaneados; lleva un búfer ráster de tamaño fijo por página, admite solo imágenes bitonales / escala de grises / RGB y compresión FlateDecode / CCITTFaxDecode / DCTDecode

El posprocesado inyecta cinco clases de bytes en el flujo guardado:

• The %PDF-raster-1.0 version-identification comment, written between the trailer dictionary and the startxref keyword (ISO 23504-1 §5). This is unique to PDF/R — the other PDF/x standards identify themselves through XMP and Info-dictionary entries instead.
• The document catalog stripped down to the §6.3 white list. Only the optional entries Version / ViewerPreferences / PageLayout / PageMode / AcroForm / Metadata are preserved; all other catalog entries (Names / Outlines / Dests / StructTreeRoot / OutputIntents / Lang / PageLabels / OCProperties / etc.) are removed.
• The Document Information Dictionary stripped to the §6.4.3 white list. Only Creator / Producer / CreationDate / ModDate are preserved; Title / Author / Subject / Keywords / Trapped are removed.
• A catalog /Metadata XMP stream carrying the four §6.4.4 Table 1 properties (xmp:CreatorTool, pdf:Producer, xmp:CreateDate, xmp:ModifyDate) plus xmp:MetadataDate.
• A trailer /ID array (recommended by the §5 example).

La salida permanece idéntica en bytes al resultado base de SaveAs hasta el final del PDF original; solo se añade la actualización incremental (y el catálogo / Info de origen se sustituyen por versiones recortadas mediante reescritura con el mismo número de objeto). Las dos sobrecargas difieren solo en cómo se pasa la configuración: la forma de solo nombre de archivo usa TPdfRSaveOptions.Default con autocompletado de los cuatro campos Info y DocumentId desde FPDF_GetMetaText / FPDF_GetFileIdentifier

Returns True on success.

• SaveAsPdfR attaches the file-format-level markers PDF/R requires — it does not guarantee that the source PDF's content already satisfies PDF/R's structural restrictions. PDF/R is much stricter than the other PDF/x standards: each page must have exactly one /Contents entry, MediaBox must be [0 0 w h], only FlateDecode / CCITTFaxDecode (bitonal) / DCTDecode (8-bit gray or RGB) filters are allowed, no object streams, every indirect reference must have generation number zero, and each page is essentially a single raster image. PDFium-generated documents that already match this pattern (e.g. scanner output passed through PDFium for repackaging) work well; arbitrary content-rich PDFs typically do not.
• Use ValidatePdfR after SaveAsPdfR to confirm what the source actually achieves. Pair with a TWAIN Working Group PDF/R validator for full content-level verification.
• TPdfRSaveOptions.StripCatalogOptionalEntries and StripInfoOptionalEntries default to True; set them False if you want the injector to preserve all source entries (the output then won't meet §6.3 / §6.4.3 but the version marker and XMP are still attached).
• Encryption is permitted by PDF/R §6.2.3, but only with a %PDF-2.0 header and AES encryption. PDFium-generated PDFs use a 1.x header so encrypted output isn't a PDF/R-1 candidate without further re-saving.

SaveAsPdfRToStream, ValidatePdfR, PdfRConformance, SaveAsPdfA, SaveAsPdfX