PDFium Delphi Component Docs

GenerateTaggedLayout Метод

Компонент: TPdf  ·  Модули: PDFium, FPdfLayout

Syntax

function GenerateTaggedLayout(Layout: TPdfLayoutDocument; out Plan: TPdfLayoutPlan; const Language: string = 'en-US'): Boolean;

Description

Измеряет и выводит новый документ вёрстки, назначает непрерывные MCID семантическим объектам страниц, помечает декоративное содержимое как Artifact, строит иерархию структуры и перезагружает готовый Tagged PDF в тот же TPdf

Назначение должно быть неактивным или содержать ноль страниц, чтобы каждый неартефактный объект покрывался сгенерированным семантическим планом

Метод загружает PDFium перед проверкой возможностей помеченного содержимого, поэтому он может быть первой нативной операцией над новым экземпляром TPdf без предварительного вызова CreateDocument

Semantic model

AddText по умолчанию использует plsrParagraph, а колонтитулы, линейки, изображения, XObject страниц и кэшированные узлы — plsrArtifact

Вызывайте SetLastItemSemantics, чтобы назначить заголовки, секции, разделы, рисунки, подписи, роли списков, роли таблиц, альтернативный текст, фактический текст, язык, ID, охват таблиц, объединения или ID заголовков

Используйте AddSemanticNode для невизуальных контейнеров списков и таблиц, затем связывайте потомков через ElementID и ParentID

Tagged links

AddLink добавляет измеренный текст URI и аннотацию Link

Сгенерированная аннотация при необходимости преобразуется в косвенный объект, получает ключ StructParent и связывается со своим элементом структуры Link через записи OBJR и ParentTree

Validation

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

Генерация отклоняет зашифрованный вывод, существующее дерево структуры, несовпадающие количества страниц или объектов, дублирующиеся MCID, неполные соответствия аннотаций и превышения настроенных лимитов объектов

Result

Plan содержит семантические элементы, родительские индексы, MCID, индексы аннотаций-ссылок, количества помеченного содержимого и количества артефактов в дополнение к обычным метрикам вёрстки

Готовый документ несёт элемент структуры Document, ParentTree, IDTree при наличии ID, MarkInfo, язык документа, StructParents страниц и порядок табуляции по структуре для страниц с аннотациями

Дополнительные таблицы

TPdfLayoutTableCell.AddTextRun сохраняет смешанные стили текста как нативный извлекаемый текст; SetImage выдаёт Figure с альтернативным текстом под исходной ячейкой таблицы

При AllowRowSpanContinuation=True одна ячейка TH или TD охватывает все свои физические фрагменты страниц через записи MCR для каждой страницы, сохраняя RowSpan, ColumnSpan и связи заголовков

Строки подытогов остаются строками тела, а метки продолжения помечаются как Artifact; об ограничениях и бюджетах см FPdfLayout

See Also

GenerateLayout, ValidatePdfUa, ReadableContent