SaveAsPdfUa метод

SaveAsPdfUa спершу виконує звичайний SaveAs, а потім нашаровує інкрементне оновлення поверх збережених байтів, яке перетворює файл на документ PDF/UA-1 або PDF/UA-2. Постобробка вставляє чотири класи маркерів у збережений потік:

• Потік метаданих XMP, що заявляє ідентифікацію PDF/UA (pdfuaid:part = 1) плюс відповідний опис pdfaExtension:schemas, обов'язковий запис dc:title (ISO 14289-1 §7.1) та перенесені поля Info-словника (Author, Subject, Producer, Keywords, CreationDate, ModDate тощо).
• Каталог отримує /MarkInfo << /Marked true /Suspects false >>, коли в каталозі джерела немає запису /MarkInfo (§7.1).
• Каталог отримує /ViewerPreferences << /DisplayDocTitle true >>, коли в джерела немає запису /ViewerPreferences (§7.1).
• Каталог отримує /Lang (xx), коли в джерела немає /Lang і Options.Language подає мітку BCP 47 (§7.2). Трейлер також отримує масив /ID (повторно використовується з FPDF_GetFileIdentifier, якщо доступний, інакше детерміновано виводиться з байтів джерела).

Результат побайтово збігається з базовим SaveAs до кінця початкового PDF; додається лише інкрементне оновлення. Проглядачі, які не розуміють PDF/UA, усе одно рендерять файл точно так, як це зробив би звичайний SaveAs. Два перевантаження відрізняються лише способом передавання конфігурації: форма лише з іменем файлу використовує TPdfUaSaveOptions.Default з автозаповненням із FPDF_GetMetaText / FPDF_GetFileIdentifier / FPDFCatalog_GetLanguage, тоді як форма TPdfUaSaveOptions дозволяє викликачу перевизначити Title, Author, Subject, Keywords, Creator, Producer, CreationDate, ModDate, Language, DocumentId, InstanceId та ідентифікатори pdfuaid Part, Revision, Amd і Corr

TPdfUaSaveOptions.PdfUa2 обирає Part 2, подає типове значення pdfuaid:rev 2024 і записує в каталог /Version /2.0, тож джерело PDF 1.x із інкрементним оновленням отримує PDF 2.0 як чинну версію

Повертає True у разі успіху. Повертає False, якщо базовий SaveAs завершився невдало або якщо інкрементне оновлення не вдалося додати (PDF надто короткий, недійсний трейлер, зашифроване джерело).

• SaveAsPdfUa додає маркери формату файлу, вимогені ISO 14289-1 — він не створює дерево структури, не вбудовує відсутні шрифти, не додає Alt-текст до зображень і не змінює вміст сторінок. Створення tagged-документа (StructTreeRoot, Figure /Alt, таблиці /TH /Scope тощо) усе ще лишається на відповідальності викликача. Використовуйте ValidatePdfUa, щоб виявити відсутність цих вимог рівня вмісту.
• Вставлення суто адитивне: якщо джерело вже містить /MarkInfo, /ViewerPreferences або /Lang, ці записи зберігаються і SaveAsPdfUa їх не перезаписує. /Metadata завжди замінюється новим PDF/UA XMP.
• Зашифровані документи не можна зберегти як PDF/UA. За потреби спершу викличте SaveAs(..., saRemoveSecurity).
• Працює на всіх платформах, які підтримує PDFium Delphi Component, оскільки постобробка реалізована на Pascal і не залежить від експортів PDFium DLL, окрім читачів метаданих.