SaveAs - TPdf - PDFium Delphi Component

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

Сохраняет копию PDF-документа в указанный поток или файл с явной нормализацией и проверками соответствия для версий с PDF 1.3 по PDF 1.7

Syntax

function SaveAs(Stream: TStream; Option: TSaveOption = saNone; PdfVersion: TPdfVersion = pvUnknown): Boolean;

Stream	Значение TStream, принимающее данные PDF
Option	TSaveOption. Параметр сохранения: `saNone` для обычного сохранения, `saIncremental` для инкрементального обновления, `saNoIncremental` для принудительной полной перезаписи или `saRemoveSecurity` для удаления защиты при сохранении
PdfVersion	Целевое значение TPdfVersion; используйте `pvUnknown`, чтобы сохранить текущую версию

function SaveAs(const FileName: string; Option: TSaveOption = saNone; PdfVersion: TPdfVersion = pvUnknown): Boolean;

FileName	string. Путь выходного файла. Сначала завершается соседний временный файл, затем он атомарно заменяет назначение
Option	TSaveOption. Параметр сохранения: `saNone`, `saIncremental`, `saNoIncremental` или `saRemoveSecurity`
PdfVersion	Целевое значение TPdfVersion; используйте `pvUnknown`, чтобы сохранить текущую версию

Return Value

Возвращает True, если документ успешно сохранён, или False в случае ошибки

Description

Сохраняет текущий документ в путь к файлу или в TStream

Параметр PdfVersion задаёт выходную версию PDF; передайте pvUnknown, чтобы сохранить существующую версию документа

Свойство Compressed управляет сжатием потоков. Входные данные с гибридными ссылками, потоками xref и объектными потоками сохраняются, когда перезапись с классическим xref не может удержать их полную семантику перекрёстных ссылок

Каждое полное (неинкрементальное) сохранение чинит подмножества шрифтов, чьи CMap ToUnicode содержат записи диапазонов массива, противоречащие отображениям символов, поэтому перезагруженный документ извлекает исходные пробелы и дефисы вместо U+00A0 и U+00AD; инкрементальные ревизии, разреженные обновления и документы с потоками перекрёстных ссылок проходят без изменений

Явные проверки версии PDF следуют активной цепочке редакций перекрёстных ссылок и активным членам объектных потоков, поэтому устаревшие или неупомянутые тела объектов не влияют на запрошенный порог версии

Файловая перегрузка оставляет существующее назначение без изменений, если сжатие, постобработка или проверка версии завершаются неудачей

Обновление V8 для Windows из v3.125.2 чинит точное сохранение значений полей для протестированных массивов пакетов и поддерживаемого подмножества XDP с одиночным потоком; более старые runtime могут отбрасывать правки одиночного потока или добавлять лишние переводы строк

Заново откройте XFA-вывод и, прежде чем принимать результат, сверьте требуемые значения полей в точности; не обрезайте пробельные символы, чтобы скрыть расхождение в сохранении

Conformance behavior

pv13 нормализует унаследованные ресурсы страниц, канонизирует /ProcSet и удаляет только исходные значения состояния прозрачности, включая /BM /Normal, /SMask /None, /CA 1, /ca 1, /AIS false и /TK true
pv13 отклоняет активные потоки метаданных, поскольку /Type /Metadata и метаданные компонентов XMP требуют PDF 1.4 или новее
pv13 отклоняет деревья имён /EmbeddedFiles документа, сохраняя более старые ссылки на потоки встроенных файлов, не использующие элемент дерева имён PDF 1.4
pv13 отклоняет запись /Lang в каталоге документа, поскольку определение естественного языка на уровне документа требует PDF 1.4 или новее
Цели pv14 и старше отклоняют значения /PageLayout /TwoPageLeft и /TwoPageRight в каталоге документа, поскольку двухстраничные макеты требуют PDF 1.5 или новее
Цели pv14 и старше отклоняют XObject-изображения с /BitsPerComponent 16, поскольку 16-битные компоненты изображений требуют PDF 1.5 или новее
Цели pv14 и старше отклоняют записи /SMaskInData XObject-изображений, поскольку встроенные каналы мягких масок JPEG 2000 требуют PDF 1.5 или новее
pv13 вместе с saIncremental вызывает EPdfError, поскольку нормализация не может сохранить подписанные предыдущие редакции
Любой зашифрованный вывод с явной версией вызывает EPdfError; вызывающие должны снять защиту перед запросом целевой основной версии
Словари расширений разработчика проверяются независимо от действующей основной версии, включая экранированные имена PDF и строгие целочисленные уровни
Потоки PRC 3D требуют расширения разработчика /ADBE с /BaseVersion /1.7 и /ExtensionLevel 1 или новее; одного объявления PDF 1.7 недостаточно
Аннотации RichMedia и действия RichMediaExecute требуют расширения разработчика /ADBE с /BaseVersion /1.7 и /ExtensionLevel 3 или новее
Словари /Type /Measure /Subtype /GEO и аннотации Projection требуют расширения разработчика /ADBE с /BaseVersion /1.7 и /ExtensionLevel 3 или новее
Каждый словарь аннотации, прямой или косвенный, достигаемый через запись /Annots страницы, должен содержать обязательные записи /Subtype и /Rect
Проверка /OCProperties каталога требует массив /OCGs, словарь /D, корректные значения /BaseState /ON и /Intent /View по умолчанию при их наличии и записи /Configs, /ON, /OFF, /AS и /Order со значениями-массивами
Библиотеки V8 для Windows из v3.125.2 сохраняют отредактированный текст XFA при сохранении массивов пакетов и поддерживаемого XDP с одиночным потоком, включая пустой текст, исходные пробельные символы, переводы строк и дополнительные символы Unicode
Библиотеки V8 для Windows из v3.126.0 сохраняют XML-комментарии и инструкции обработки вне живых datasets и пакетов форм в поддерживаемом XDP с одиночным потоком, включая входные данные в UTF-8 и UTF-16 с BOM; комментарии и инструкции обработки внутри заменяемых живых пакетов, недопустимая кодировка UTF-8 или UTF-16, незавершённые теги, некорректные ссылки на сущности, искажённые инструкции обработки, объявления DTD и XMLDSig отвергаются до изменения постоянного потока XFA
Библиотеки V8 для Windows из v3.126.2 также отвергают некорректные пробелы между атрибутами, значения без кавычек, лексически или по пространству имён продублированные атрибуты, непривязанные или зарезервированные префиксы пространств имён, недопустимые квалифицированные имена, декларации не на своём месте, недопустимый порядок и значения деклараций и декларации, чья кодировка не сходится с входными байтами, — всё это до изменения постоянного потока
Эти ограниченные защиты сохранения XML 1.0 не дают валидации схем, поддержки DTD, перезаписи XMLDSig или общей поддержки XML 1.1; дополнительные символы Unicode поддерживаются в тексте и значениях атрибутов, а имена элементов и атрибутов остаются ограничены поддержкой имён BMP в нативном DOM
Поддерживаемые прочие элементы пакетов и корневые пространства имён сохраняются семантически; вывод использует UTF-8 без гарантии побайтовой точности XML
Библиотеки V8 из v3.125.2 сообщают об ошибках экспорта пакетов XFA, не очищая состояние изменённости; сбои финального буферизованного писателя сообщаются как неудачные сохранения в этих библиотеках V8 и в обычных библиотеках Windows из v3.125.3
Файловые сохранения используют временный файл в том же каталоге и заменяют назначение только после успешной постобработки
Постобработка с явной версией декодирует PNG-предикторы, объявленные в прямом словаре /DecodeParms потока или в массиве параметров из одного элемента, включая cross-reference streams, сжатые предиктором, в многостраничных формах; посторонние вложенные ключи не переопределяют параметры декодирования потока

Example

// Save to file
Pdf.SaveAs('output.pdf');

// Save to stream
var MS: TMemoryStream;
MS := TMemoryStream.Create;
try
  Pdf.SaveAs(MS);
  MS.SaveToFile('output.pdf');
finally
  MS.Free;
end;

SaveAs Метод