PDFium Delphi Component — комплексное решение для работы с PDF в Delphi и C++Builder

За пределами движка

Перечисленные ниже возможности не имеют аналога в C API PDFium. Каждая из них реализована в PDFium Delphi Component на Object Pascal, проверена по опубликованным пунктам ISO, ETSI, IETF или FIPS и доступна в виде исходного кода

Цифровые подписи — PAdES

Полное подписание, а не чтение подписей. PDFium может лишь сообщить, что словарь подписи существует; PDFium Delphi Component его создаёт

Базовые уровни: B-B, B-T, B-LT и B-LTA согласно ETSI EN 319 142-1 V1.2.1 через SignPades, SignPadesToStream и SignPadesBytes
Контейнер подписи: CMS / CAdES SignedData, построенный по RFC 5652 с подписанными атрибутами, требуемыми профилем — content-type, message-digest, signing-certificate-v2 и commitment-type-indication
Метки времени: клиент RFC 3161 TimeStampReq / TimeStampResp с транспортом WinHttp, встраивающий токен как неподписанный атрибут signature-time-stamp
Долгосрочная проверка: внедрение Document Security Store с /Certs, /OCSPs и /CRLs, словари VRI на каждую подпись и маркер /Extensions /ESIC
Архивные метки времени: словари Document Time-stamp с /SubFilter /ETSI.RFC3161, охватывающие весь файл, для B-LTA
Доступ к ключам: серверный механизм Windows CNG с поддержкой RSA-PSS, RSA PKCS#1 и ECDSA за интерфейсом ICmsSigner, который может реализовать любой другой механизм
Удалённое подписание и HSM: PreparePadesRemoteSignature и CompletePadesRemoteSignature разделяют операцию, чтобы закрытый ключ оставался внутри удалённого сервиса или аппаратного модуля
Проверка: ValidatePades сообщает самый высокий базовый уровень документа плюс коды проблем уровня пунктов; ValidatePadesTrust и ValidatePadesTrustAsync добавляют проверку доверия цепочки сертификатов
Европейские списки доверия: аутентифицированные снимки списков доверия ETSI дают офлайн-кеширование с проверкой контрольных сумм, обновление силами вызывающего кода, актуальные якоря доверия и оценку квалифицированных сервисов без сетевого доступа внутри валидатора
Интеграция с архивом: SignPadesWithPdfA преобразует в PDF/A-4 и подписывает за один вызов согласно EN 319 142-1 Annex A.7

Шифрование и целостность документа

PDFium открывает зашифрованные файлы, но не записывает шифрование. PDFium Delphi Component реализует сторону записи согласно ISO 32000-2 и его техническим спецификациям

PDF 2.0 AES-256: SaveAsEncrypted с деривацией ключей V=5 / R=5 / R=6, включая итеративное хеширование алгоритма 2.B, и записи словаря /O /U /OE /UE /Perms
Полная обработка документа: шифрование потоков и литеральных строк с корректной поправкой /Length и перестроенной таблицей перекрёстных ссылок
AES-GCM: аутентифицированное шифрование ISO/TS 32003 V=6 / R=7, включая аутентифицированную расшифровку строк и потоков AESV4
PDF MAC: автономные токены /AuthCode ISO/TS 32004 — CMS AuthenticatedData с деривацией ключей HKDF, обёртыванием ключей и проверкой HMAC
Зашифрованные редакции: инкрементальные обновления R5, R6 и R7 наследуют существующий словарь безопасности, шифруют изменённые строки и потоки, сохраняют поколения объектов и проверяют или обновляют аутентификацию PDF MAC
Примитивы: AES-128/256 в режимах CBC и GCM, SHA-256/384/512, SHA-3, HMAC и чтение/запись ASN.1 DER — всё на чистом Object Pascal без внешних C-зависимостей, проверено по опубликованным тестовым векторам FIPS 197, FIPS 180-4 и NIST SP 800-38D

Соответствие стандартам

Шесть семейств стандартов ISO, каждое с валидатором, возвращающим коды результатов уровня пунктов, и соответствующим путём сохранения или внедрения маркеров

PDF/A: ISO 19005 части 1–4 — включая основанный на PDF 2.0 базовый уровень A-4 и профили A-4f и A-4e — с охватом output intent, идентификации XMP, внедрения шрифтов, структуры RoleMap и ParentTree, ограничений реализации Annex C и запрещённых действий
PDF/X: ISO 15930 от X-1a до основанного на PDF 2.0 X-6, с охватом формы output intent, прозрачности с привязкой к профилю, ограничений цветовых пространств и геометрии TrimBox / ArtBox / BleedBox
PDF/UA: ISO 14289-1, с охватом структуры таблиц и списков, моделей заголовков, разрешения RoleMap, неразмеченного реального содержимого, границ артефактов, Unicode с привязкой к объектам и извлечения ActualText, кодировок TrueType и составных шрифтов и освобождений для аннотаций
PDF/E: ISO 24517-1, включая внедрение sRGB output intent и правила шрифтов для инженерных документов
PDF/VT: ISO 16612-2 VT-1 и VT-2, иерархии DPart, метаданные частей документа и упаковка многокомпонентных MIME-потоков VT-2s
PDF/R: ISO 23504-1, с требованием одного полосного изображения на страницу, списком разрешённых кодирований и согласованностью шифрования и версии
Предпечатная проверка: межстандартный агрегатор отчётов с экспортом TXT, HTML, Markdown, JSON, CSV, SARIF 2.1.0, JUnit XML и NDJSON, со стабильными отпечатками отчётов SHA-256 и консольным раннером, чей код выхода может управлять CI

Сериализация PDF и редакции

Движок предлагает одно последовательное сохранение всего файла. Приложениям часто нужно больше, поэтому PDFium Delphi Component записывает собственные редакции поверх семантического вывода движка

Линеаризованный вывод: SaveAsLinearized создаёт файлы Fast Web View с группировкой первой страницы, двумя секциями перекрёстных ссылок и таблицами подсказок смещений страниц и общих объектов по Annex F
Упаковка объектов: SaveAsObjectStream группирует подходящие объекты в /ObjStm с порядком, локальным для страницы, и полным покрытием перекрёстных ссылок типа 2
Инкрементальные редакции: BeginIncrementalSave и CommitIncrementalSave дописывают только изменённые и новые косвенные объекты, сохраняя предыдущий вывод байт в байт вместе с /Prev, /Encrypt, /Info и постоянным /ID; фиксация без изменений не увеличивает файл
Восстановление: SaveAsRepaired записывает копию с одной редакцией и повторно проверяет её независимой строгой загрузкой перед выдачей
Политики загрузки: строгий, совместимый и восстановительный режимы со структурированной диагностикой, сообщающей путь перестроения, смещения повреждений, конфликтующие редакции и состояние бюджета
Нативный запрос версии: TPdf.PdfVersion повторно использует состояние парсера PDFium и выполняет только восьмибайтовую проверку заголовка вместо повторного разбора исходного документа
Рабочее хранилище: TPdfRandomAccessStore держит промежуточные данные в памяти до SaveMemoryLimit, затем переносит их в эксклюзивный временный файл с удалением при закрытии; постобработка базового сохранения применяет ту же политику ко всем трём рабочим областям, а обновления каталога для action по умолчанию и меток страниц используют ограниченные окна и разреженный индекс

Сервисы содержимого, которые PDFium не предоставляет

XFDF и FDF: импорт и экспорт значений полей форм и 18 подтипов аннотаций согласно ISO 19444-1 и ISO 32000-1 §12.7.11, полностью сериализованные на Pascal поверх собственной модели данных компонента
XMP: читатель и писатель пакетов с типизированными контейнерами, используемый каждым профилем стандартов
Associated Files: массивы /AF ISO 32000-2 §7.11.4, прикреплённые к catalog или целевой странице, с восемью значениями связи из Table 45
Интеграция OCR: IPdfOcrProvider принимает любой движок распознавания — компонент поставляет битовые карты страниц и записывает итоговый доступный для поиска текстовый слой, со статусом на каждую страницу и пропуском существующего текста
Структурированный текст и таблицы: GetStructuredText строит иерархию страница / блок / строка / стилизованный диапазон из геометрии символов и семантики Tagged PDF; ExtractTables и ExtractDocumentTables обнаруживают таблицы с рамками и выровненные по пробелам, сохраняют объединённые диапазоны, оценивают достоверность и выдают CSV или JSON
Семантический reflow: BuildReflowDocument превращает PDF с фиксированной вёрсткой в дерево узлов, безопасный HTML-вывод которого сохраняет заголовки, абзацы, списки, иллюстрации, секции страниц и диапазоны таблиц
Компоновка и метрики текста: построитель компоновки с ограничениями «не отрывать», «держать со следующим», «вдова», «сирота» и явными разрывами страниц, таблицами, переходящими с страницы на страницу, и дисковым страничным хранилищем команд с ограниченной LRU-материализацией; MeasureText и WrapText дают перенос по словам, не добавляя на страницу ничего лишнего
Шейпинг текста: поддержка шейпинга на уровне глифов для письма справа налево и сложных письменностей
Генерация ToUnicode CMap: без неё текст шрифтов CID отображается корректно, но не может копироваться, искаться или прочитываться вслух
Ограниченная инспекция потоков: TPdfStreamInspector декодирует произвольные объекты-потоки под явными бюджетами источника, сырых и декодированных данных, коэффициента расширения и числа потоков, возвращая структурированный статус вместо исчерпания памяти на сконструированном файле

Основные компоненты

Компонент TPdf — движок обработки документов

Ядро системы обработки PDF, TPdf обрабатывает все операции уровня документа, включая загрузку, сохранение, извлечение текста, обработку форм и управление метаданными

Управление документами: открытие из файлов, потоков или буферов памяти
Обработка текста: расширенные возможности извлечения и поиска текста
Работа с формами: полная поддержка интерактивных форм с JavaScript
Безопасность: поддержка PDF с паролем и управление разрешениями, запись шифрования PDF 2.0 AES-256 и подпись PAdES
Стандарты: валидация PDF/A, PDF/X, PDF/UA, PDF/E, PDF/VT и PDF/R с соответствующими помощниками сохранения и внедрения маркеров
Доступ к метаданным: полные свойства документа, пакеты XMP и получение сведений

Компонент TPdfView — интерактивный элемент управления просмотром

Развитый визуальный элемент управления, предоставляющий богатые возможности просмотра PDF с полной поддержкой взаимодействия с пользователем

Высококачественный рендеринг: оптимизированное отображение с несколькими режимами рендеринга
Интерактивная навигация: масштабирование, прокрутка, поворот и переход между страницами
Выделение текста: выделение, копирование и манипулирование текстовым содержимым
Отображение аннотаций: просмотр и взаимодействие с аннотациями PDF
Мышь и клавиатура: полная поддержка устройств ввода с отображением координат

Ключевые возможности

Обработка документов

Загрузка документов PDF из файлов, потоков, буферов памяти или адаптеров TStream по требованию через LoadCustomDocument, с совместимым, строгим и восстановительным режимами плюс структурированной диагностикой xref
Создание независимо строгопроверенных ремонтных копий с одной редакцией через SaveAsRepaired
Сохранение и экспорт документов с различными опциями (инкрементальное сохранение, удаление защиты, явное указание целевой версии PDF)
Валидатор соответствия версии PDF отклоняет возможности, появившиеся позже выбранной целевой версии (PDF 1.0 — 1.7)
Создание PDF/A-1b через SaveAsPdfA / SaveAsPdfAToStream со встроенным ICC-профилем sRGB и поддержкой пользовательских профилей
Валидация PDF/A через ValidatePdfA и свойство PdfAConformance только для чтения
Работа с защищёнными паролем и зашифрованными PDF
Управление метаданными и свойствами документа
Композиция страниц: MergeFiles (пакетное слияние с ограниченными источниками), ImportPagesByIndex (импорт подмножества), ImportNPagesToOne (сетка N-up), MovePages (изменение порядка на месте)
Повторное использование страниц через Form XObject: штамповка одной страницы на многие через CreateXObjectFromPage и InsertFormObjectFromXObject
Поддержка закладок и адресов назначения
Сплющивание форм: восстановление потоков внешнего вида (/AP) из значений полей с последующим запеканием аннотаций и виджетов форм в статическое содержимое страниц

Операции с текстом и содержимым

Расширенное извлечение текста с сохранением форматирования
Мощный текстовый поиск с множеством опций
Посимвольный анализ текста и определение позиций
Доступ к сведениям о шрифтах и их свойствам
Выделение текста и операции с буфером обмена
Поддержка множества языков и Unicode

Интерактивные формы и аннотации

Полная поддержка полей интерактивных форм
Текстовые поля, флажки, переключатели, комбинированные списки
Валидация форм и выполнение JavaScript
Отображение и взаимодействие с аннотациями
Аннотации-ссылки и веб-ссылки
Цифровые подписи: подписание PAdES от B-B до B-LTA, метки времени RFC 3161, удалённое подписание и HSM, проверка доверия

Визуальный рендеринг и отображение

Высококачественный рендеринг со сглаживанием и прямой записью в буфер DIB назначения без копирования
Отменяемый прогрессивный рендеринг через RenderPageProgressive и IPdfCancellationToken
Нативная прогрессивная загрузка через TPdfProgressiveDocument, включая разреженные подсказки байтовых диапазонов, приоритетное планирование диапазонов, ограниченные повторные попытки, отмену и контроль доступности документа, форм и страниц
Вывод Fast Web View через SaveAsLinearized, включая группировку первой страницы, две секции перекрёстных ссылок и таблицы подсказок смещений страниц и общих объектов по Annex F
Современная упаковка объектов PDF 1.5+ через SaveAsObjectStream, включая ограниченные группы ObjStm, порядок, локальный для страницы, и полное покрытие xref типа 2
Сеансы редакций изменённых объектов через BeginIncrementalSave и CommitIncrementalSave, включая сохранение зашифрованного префикса, наследуемые параметры безопасности, фиксации без операций, строгую повторную проверку при открытии, надёжные боковые файлы, атомарную замену, откат и статистику на каждую фиксацию
Ограниченное рабочее хранилище произвольного доступа через TPdfRandomAccessStore и SaveMemoryLimit, включая безопасный сброс во временный файл, позиционируемый ввод-вывод и диагностику пиковых значений на каждое сохранение
Несколько режимов отображения (одиночная непрерывная, двухстраничная непрерывная, двухстраничная с обложкой)
FitMode определяет, как страница располагается в области просмотра (ручное масштабирование, фактический размер, страница целиком, по ширине); автоматически применяется при изменении размера и смене страницы
PageColor отделяет фон отрисованной страницы PDF от свойства Color окружающего элемента управления для просмотрщиков в тёмной теме
Подсветка результатов поиска через HighlightSearchText и ClearHighlight
Необязательная отбрасываемая тень (PageShadowSize / PageShadowColor) и рамка страницы (PageBorderColor)
Безопасная обработка кликов по ссылкам со списками разрешённых действий (LinkOptions) и события OnAnnotationLinkClick / OnWebLinkClick
Ограничение пользовательского ввода (AllowUserPageChange, ChangePageOnMouseScrolling, AllowUserTextSelection) для киосков и встраивания в режиме только для чтения
Навигация по миниатюрам через боковую панель компонента TPdfThumbnailView
Оптимизированный для LCD рендеринг текста
Качество печати с выбираемыми режимами печати PDFium (EMF, только текст, PostScript Level 2 / 3, прямая передача, маска изображения, Type 42)
Пользовательская цветопередача и рендеринг в оттенках серого

Удобные для разработчика возможности

Всеобъемлющая система событий для настройки
Точное сопоставление координат между экраном и PDF
Обширный API свойств и методов
Поддержка времени проектирования с редакторами свойств
Потокобезопасные операции там, где это применимо
Эффективная по памяти обработка больших документов

Технические характеристики

Аспект	Подробности
Движок рендеринга	Google PDFium — стандартный отраслевой, проверенный временем движок PDF
Поддержка PDF	Версии PDF от 1.0 до 1.7, зашифрованные и защищённые паролем файлы
Совместимость платформ	32-разрядные и 64-разрядные приложения для Windows
Поддержка IDE	Delphi XE5 / C++Builder XE5 (RAD Studio XE5) — Delphi/C++Builder 13.1 Florence (RAD Studio 13.1), Lazarus 3.8+
Кодировка символов	Полная поддержка Unicode, обработка многоязычного текста
Управление памятью	Оптимизировано для больших документов, эффективное использование ресурсов
Потокобезопасность	Однопоточный дизайн (согласно требованиям PDFium)

Архитектурный дизайн

PDFium Delphi Component следует многоуровневой архитектуре, которая чётко разделяет ответственность и максимизирует повторное использование кода:

Многоуровневая архитектура

Уровень	Файлы	Ответственность
Компоненты VCL	PDFium.pas, FPdfThumbnail.pas	Компоненты Delphi VCL (TPdf, TPdfView, TPdfThumbnailView) с поддержкой времени проектирования
Привязки API	FPdfView.pas, FPdfDoc.pas, FPdfText.pas, FPdfEdit.pas, FPdfAnnot.pas, FPdfFormFill.pas, FPdfPageOps.pas, FPdfAttachment.pas, FPdfSignature.pas, FPdfStructTree.pas, FPdfDataAvail.pas, FPdfExtensions.pas, FPdfFWLEvent.pas, FPdfCompress.pas, FPdfUtils.pas	Объявления указателей на функции для вызовов DLL PDFium
Конвейер PDF/A	FPdfPdfa.pas	Создание PDF/A-1b (внедрение XMP, ICC OutputIntent sRGB, обновление catalog) и валидация (определение уровня соответствия, перечисление проблем)
Асинхронная инфраструктура	FPdfAsync.pas	IPdfCancellationToken / IPdfCancellationTokenSource, singleton PdfNoCancellationToken и помощник TPdfFuture<T> для длительных операций рендеринга и экспорта
Помощники геометрии	FPdfMatrix.pas	Объектно-ориентированная обёртка над FS_MATRIX с помощниками Translate, Scale, Rotate, Flip, Skew и Multiply
Операции со страницами	FPdfPageOps.pas	Обёртки для FPDF_ImportPagesByIndex, FPDF_ImportPages, FPDF_ImportNPagesToOne, FPDF_MovePages, масштабируемое файловое пакетное планирование плюс помощники Form-XObject (CreateXObjectFromPage / InsertFormObjectFromXObject)
Боковая панель миниатюр	FPdfThumbnail.pas	TPdfThumbnailView — прокручиваемая боковая панель миниатюр страниц с эффектами наведения, выделения и навигацией OnPageClick
Нативный движок	DLLs\Win32\|Win64\pdfium.dll и pdfium.v8.dll	Нативный движок рендеринга Google PDFium с необязательными сборками с поддержкой V8

Иерархия компонентов

TPdf (TComponent) — невизуальный компонент для операций с PDF-документом
TPdfView (TScrollingWinControl) — визуальный элемент управления, наследующий возможности прокрутки и фокуса
TPdfThumbnailView (TCustomControl) — прокручиваемая боковая панель навигации по миниатюрам, связанная с компонентом TPdf

Ключевые шаблоны проектирования

Динамическая загрузка DLL: функции PDFium загружаются во время выполнения через GetProcAddress
Ресурсы на основе дескрипторов: PDF-документы, страницы и объекты управляются через непрозрачные дескрипторы
Событийно-ориентированная архитектура: обширные события для взаимодействия с формами, смены страниц и рендеринга
Типы на основе записей: сложные структуры данных представлены как записи Delphi (TBookmark, TDestination, TPdfAnnotation и т. п.)
Помощники по выбору: FPdfAsync и FPdfMatrix предоставляют утилиты отмены/future и преобразований, не навязывая их основному компоненту TPdf

Сценарии применения

Бизнес-приложения

Системы документооборота: просмотр, организация и обработка PDF-документов
Просмотрщики отчётов: отображение сгенерированных отчётов и деловых документов
Обработка форм: работа с интерактивными PDF-формами и сбор данных
Архивные системы: доступ и отображение исторических PDF-документов

Образование и исследования

Платформы электронного обучения: отображение учебных материалов и учебников
Исследовательские инструменты: анализ и извлечение данных из научных статей
Цифровые библиотеки: просмотр и поиск по коллекциям документов
Приложения для заметок: аннотирование и подсветка содержимого PDF

Юридическая сфера и комплаенс

Анализ юридических документов: изучение договоров и юридических документов
Системы комплаенса: проверка целостности документов и подписей
Управление делами: организация и проверка юридической документации
Аудиторские инструменты: обработка и анализ нормативных документов

Технические и инженерные задачи

Просмотрщики CAD: отображение технических чертежей и спецификаций
Системы руководств: доступ к руководствам по обслуживанию и эксплуатации
Контроль качества: проверка отчётов о тестировании и сертификатов
Управление проектами: работа с проектной документацией и планами

Преимущества и выгоды

Производительность и надёжность

Проверенный рендеринг: отрисовка страниц использует семейство движков PDFium, на котором построен показ PDF в Chromium, а всё над ним — собственная реализация losLab на Object Pascal
Высокая производительность: запись в DIB без копирования, отменяемый прогрессивный рендеринг, параллельная отрисовка страниц, загрузка по требованию с позиционированием, не требующая предварительного копирования в память, и единый измеримый байтовый бюджет для удерживаемых сцен страниц и управляемых снимков
Стабильность на враждебном вводе: декодирование потоков, нормализация содержимого и сканирование структур выполняются под явными бюджетами источника, вывода, токенов, вложенности и коэффициента расширения, поэтому некорректный или сконструированный файл возвращает структурированный статус вместо исчерпания памяти
Масштабируемость: работает как с небольшими формами, так и с многогигабайтными документами, с ограниченным рабочим хранилищем, сбрасываемым во временный файл с удалением при закрытии

Ценность для бизнеса

Быстрая разработка: 475 публичных членов TPdf и 36 готовых к запуску проектов сокращают время разработки
Один поставщик для подписи и шифрования: подписи PAdES и шифрование PDF 2.0 входят в эту библиотеку — отдельный SDK подписи, развёртывание OpenSSL и вторая лицензия не нужны
Без отчислений: отсутствие платы за время выполнения и лицензионных сложностей
Включает исходный код: полная кастомизация и отладка вплоть до криптографических примитивов, написанных на чистом Object Pascal без внешних C-зависимостей, которые пришлось бы проверять при аудите безопасности
Долгосрочная поддержка: регулярные обновления и поддержка совместимости от Delphi и C++Builder XE5 до 13.1 Florence, а также Lazarus / Free Pascal

Опыт разработчика

Простая интеграция: готовые к использованию компоненты с минимальной настройкой
Богатая документация: подробные файлы справки и примеры
Событийно-ориентированная архитектура: гибкая настройка через обширные события
Поддержка времени проектирования: редакторы свойств и интеграция с IDE

Библиотека компонентов PDFium Delphi Component

Обзор продукта