SaveAsSanitised - TPdf - PDFium Delphi Component

Компонент: TPdf · Модуль: PDFium

Записывает чистую копию с одной ревизией через ограниченные обновления каталога и trailer, затем обрезает недостижимые объекты, так что осиротевшие тела JavaScript, действий, вложений и метаданных исчезают из тела файла

Syntax

function SaveAsSanitised(Stream: TStream;
const Options: TPdfSanitiseOptions;
out Report: TPdfSanitiseReport): Boolean; overload;

function SaveAsSanitised(const FileName: string;
const Options: TPdfSanitiseOptions;
out Report: TPdfSanitiseReport): Boolean; overload;

Description

SaveAsSanitised создаёт очищенную копию PDF с одной ревизией, удаляющую векторы активного содержимого из каталога документа, а затем опционально выполняет обрезку по достижимости, устраняющую осиротевшие объекты из тела файла

Двухэтапный конвейер сначала вырезает записи каталога (/OpenAction, /AA, /Names, /AF, /AcroForm, /Metadata) через StripDictionaryEntries в виде инкрементального обновления, затем запускает PruneUnreachablePdfStream, который перезаписывает файл как одну чистую классическую ревизию

Обновление каталога и trailer использует разреженный поиск по xref, окна парсера не крупнее 1 МиБ и копирование диапазонами по 64 КиБ на обычном пути xref вместо материализации всего сохраняемого PDF в одном массиве байтов

Когда обрезка включена, промежуточное рабочее пространство — это TPdfRandomAccessStore, управляемый SaveMemoryLimit и SaveTemporaryDirectory Его пиковая память и состояние переноса на диск учитываются в LastSaveLargestMemoryBuffer и LastSaveSpillCount

Каждый флаг вырезания независим TPdfSanitiseOptions.Default включает полный профиль безопасности: StripOpenAction, StripCatalogActions, StripNames, StripAssociatedFiles плюс обрезка RemoveUnreachable. StripAcroForm и StripMetadata по умолчанию False, поскольку они удаляют поля форм и метаданные, которые вызывающий код может хотеть сохранить

Вывод всегда является единственной ревизией без инкрементальной истории, когда RemoveUnreachable=True

Parameters

Options — запись TPdfSanitiseOptions; используйте Default для стандартного профиля безопасности
Report — получает количество вырезанных записей, количество обрезанных объектов, счётчики байтов и любую ошибку

Remarks

StripNames удаляет весь словарь /Names, включая /JavaScript, /EmbeddedFiles, /Dests и /AP; это намеренно агрессивная мера для очистки
StripAssociatedFiles удаляет запись /AF уровня каталога и по умолчанию True
StripMetadata удаляет и каталоговый /Metadata (XMP), и /Info в trailer
Искажённые или неподдерживаемые макеты xref откатываются к парсеру совместимости, чтобы ограниченный быстрый путь не сужал принимаемый вход
Действия /AA и /A на уровне отдельных аннотаций этим методом не вырезаются; удаляется только активное содержимое уровня каталога
Зашифрованные документы отклоняются защитой TryReadTrailerInfo в основе
Подписанные документы следует очищать осторожно, поскольку вырезание /AcroForm удаляет поля подписи и делает существующие подписи недействительными

Example

var
  Options: TPdfSanitiseOptions;
  Report: TPdfSanitiseReport;
begin
  Pdf1.FileName := 'C:\Untrusted.pdf';
  Pdf1.Active := True;
  Options := TPdfSanitiseOptions.Default;
  Pdf1.SaveAsSanitised('C:\Sanitised.pdf', Options, Report);
end;

SaveAsSanitised Метод