PDFium Delphi Component

Цифрові підписи — 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 trusted-list дають офлайн-кешування з контрольними сумами, оновлення, керовані викликом, актуальні trust anchors та оцінювання кваліфікованих сервісів без мережевого доступу всередині валідатора
• Інтеграція з архівами: SignPadesWithPdfA перетворює документ на PDF/A-4 і підписує його одним викликом, згідно з додатком A.7 EN 319 142-1

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

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: частини 1–4 ISO 19005 — включно з базовим профілем A-4, A-4f і A-4e на основі PDF 2.0 — охоплює output intents, ідентифікацію XMP, вбудовування шрифтів, структуру RoleMap і ParentTree, обмеження реалізації з додатка C і заборонені дії
• PDF/X: ISO 15930 від X-1a до базованого на PDF 2.0 X-6: форма output intent, обмеження прозорості та колірних просторів за профілем, геометрія TrimBox / ArtBox / BleedBox
• PDF/UA: ISO 14289-1: структура таблиць і списків, моделі заголовків, розрішення RoleMap, нетегований реальний вміст, розміщення Artifact, витягнення Unicode і ActualText у межах об’єктів, кодування шрифтів TrueType і складених, винятки для анотацій
• PDF/E: ISO 24517-1, включно з упорскуванням вбудованого output-intent sRGB і правилами шрифтів для інженерних документів
• PDF/VT: ISO 16612-2 VT-1 і VT-2, ієрархії DPart, метадані частин документа та пакування потоку VT-2s у multipart MIME
• PDF/R: ISO 23504-1: по одній strip-стрічці зображення на сторінку, дозволений перелік кодувань і узгодженість шифрування з версією
• Preflight: крос-стандартний агрегатор звітів з експортом TXT, HTML, Markdown, JSON, CSV, SARIF 2.1.0, JUnit XML і NDJSON, стабільними відбитками SHA-256 звітів і консольним запускачем, код виходу якого можна вбудувати в CI

Серіалізація PDF і ревізії

Рушій уміє лише одне послідовне збереження всього файлу. Програмам часто потрібно більше, тому PDFium Delphi Component записує власні ревізії поверх семантичного виводу рушія

• Лінеаризований вивід: SaveAsLinearized створює файли Fast Web View з групуванням першої сторінки, двома секціями перехресних посилань і таблицями підказок зсувів сторінок та спільних об’єктів із додатка F
• Упакування об’єктів: SaveAsObjectStream групує відповідні об’єкти в /ObjStm із впорядкуванням за сторінками та повним покриттям перехресних посилань типу 2
• Інкрементальні ревізії: BeginIncrementalSave і CommitIncrementalSave дописують до зашифрованих або незашифрованих джерел лише змінені й нові непрямі об’єкти, зберігаючи попередній вивід байт-у-байт разом із /Prev, /Encrypt, /Info і постійним /ID; фіксація без змін не збільшує файл
• Відновлення: SaveAsRepaired пише копію з однією ревізією та повторно звіряє її незалежним строгим завантаженням, перш ніж віддати результат
• Політики завантаження: режими strict, compatible і recovery зі структурованою діагностикою, що повідомляє шлях перебудови, зсуви пошкоджень, конфліктні ревізії та стан бюджетів
• Нативний запит версії: TPdf.PdfVersion повторно використовує стан парсера PDFium і виконує лише восьмибайтову перевірку заголовка замість повторного розбору вихідного документа
• Робоче сховище: TPdfRandomAccessStore тримає проміжні дані в пам’яті до SaveMemoryLimit, а потім переїжджає в ексклюзивний тимчасовий файл із видаленням після закриття; постобробка збереження в ядрі застосовує ту саму політику до всіх трьох робочих просторів, тоді як типові оновлення каталогу open-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, що кріпляться до каталогу чи цільової сторінки, з вісьмома значеннями зв’язків із Table 45
• Інтеграція OCR: IPdfOcrProvider приймає будь-який рушій розпізнавання — компонент постачає бітмапи сторінок і записує результуючий текстовий шар із можливістю пошуку, зі статусом на сторінку та пропуском наявного тексту
• Структурований текст і таблиці: GetStructuredText будує ієрархію сторінка / блок / рядок / стилізований фрагмент із геометрії символів і семантики Tagged PDF; ExtractTables і ExtractDocumentTables знаходять таблиці з лінійками та вирівняні пробілами, зберігають об’єднані діапазони, оцінюють впевненість і видають CSV або JSON
• Семантичний reflow: BuildReflowDocument перетворює PDF із фіксованим компонуванням на дерево вузлів, чиї безпечні HTML-виводи зберігають заголовки, абзаци, списки, ілюстрації, секції сторінок і діапазони таблиць
• Компонування й метрики тексту: конструктор компонування з обмеженнями keep-together, keep-with-next, widow, orphan і явними розривами сторінок, таблицями крізь сторінки та дисковим сховищем посторінкових команд з обмеженою 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, з політиками compatible, strict і recovery плюс структурованою діагностикою xref
• Створюйте незалежно верифіковані строгим завантаженням відновлювальні копії з однією ревізією через SaveAsRepaired
• Зберігайте та експортуйте документи з різними параметрами (інкрементальне збереження, зняття захисту, явна цільова версія PDF)
• Валідатор сумісності версій PDF відхиляє можливості новіші за вибрану ціль (PDF 1.0 - 1.7)
• Створення PDF/A-1b через SaveAsPdfA / SaveAsPdfAToStream із вбудованим профілем sRGB ICC та підтримкою власних профілів
• Перевірка PDF/A через ValidatePdfA і властивість лише для читання PdfAConformance
• Працюйте з PDF, захищеними паролем, і зашифрованими 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 з розрідженими підказками byte-range, пріоритезованим плануванням діапазонів, обмеженими повторами, скасуванням і воротами доступності документа, форми та сторінок
• Вивід Fast Web View через SaveAsLinearized з групуванням першої сторінки, двома секціями перехресних посилань і таблицями підказок зсувів сторінок та спільних об’єктів із додатка F
• Сучасне упакування об’єктів PDF 1.5+ через SaveAsObjectStream з обмеженими групами ObjStm, впорядкуванням за сторінками та повним покриттям xref типу 2
• Сеанси інкрементальних ревізій змінених об’єктів через BeginIncrementalSave і CommitIncrementalSave зі збереженням зашифрованого префікса, успадкованими параметрами безпеки, фіксаціями без змін, строгою валідацією повторного відкриття, довговічними побічними файлами, атомарним заміщенням, відкатом і статистикою на кожну фіксацію
• Обмежене робоче сховище з довільним доступом через TPdfRandomAccessStore і SaveMemoryLimit із безпечним вивантаженням у тимчасовий файл, позиційним вводом-виводом і діагностикою піків на кожне збереження
• Кілька режимів відображення (односторінковий безперервний, двосторінковий безперервний, двосторінковий з обкладинкою)
• FitMode визначає, як сторінка розміщується у вікні перегляду (ручний масштаб, фактичний розмір, умістити сторінку, умістити ширину); автоматично застосовується повторно під час Resize / зміни сторінки
• PageColor відокремлює фон відрендереної PDF-сторінки від Color самого елемента керування для переглядачів у темному режимі
• Підсвічування результатів пошуку через HighlightSearchText і ClearHighlight
• Необов’язкова тінь (PageShadowSize / PageShadowColor) і межа сторінки (PageBorderColor)
• Безпечна обробка клацань по посиланнях із дозволеними списками для окремих дій (LinkOptions) і подіями OnAnnotationLinkClick / OnWebLinkClick
• Обмеження введення користувача (AllowUserPageChange, ChangePageOnMouseScrolling, AllowUserTextSelection) для кіосків і вбудувань лише для читання
• Навігація за ескізами через бічний компонент TPdfThumbnailView
• Рендеринг тексту, оптимізований для LCD
• Вивід друкарської якості з вибором режимів друку PDFium (EMF, лише текст, PostScript Level 2 / 3, pass-through, image-mask, Type 42)
• Користувацький кольоровий і відтінковий рендеринг

Зручні для розробника можливості

• Комплексна система подій для налаштування
• Точне відображення координат між екраном і PDF
• Широкі API властивостей і методів
• Підтримка часу проєктування з редакторами властивостей
• Потокобезпечні операції там, де це можливо
• Ефективна робота з пам’яттю для великих документів

Багаторівнева архітектура

Ієрархія компонентів

• TPdf (TComponent) - Невізуальний компонент для операцій з PDF-документами
• TPdfView (TScrollingWinControl) - Візуальний елемент керування, що успадковує можливості прокручування та фокуса
• TPdfThumbnailView (TCustomControl) - Прокручувана бічна панель навігації ескізами, пов’язана з компонентом TPdf

Основні шаблони проектування

• Динамічне завантаження DLL: Функції PDFium завантажуються під час виконання через GetProcAddress
• Ресурси на основі handle: Документи PDF, сторінки та об’єкти керуються через непрозорі handle
• Архітектура на подіях: Розширені події для взаємодії з формами, змін сторінок і рендерингу
• Типи на основі записів: Складні структури даних представлені як записи Delphi (TBookmark, TDestination, TPdfAnnotation тощо)
• Додаткові помічники: FPdfAsync і FPdfMatrix надають утиліти скасування/future і перетворень без примусового вбудовування їх у головний компонент TPdf

Бізнес-додатки

• Системи керування документами: Перегляд, упорядкування та обробка PDF-документів
• Переглядачі звітів: Відображення згенерованих звітів і бізнес-документів
• Обробка форм: Робота з інтерактивними PDF-формами та збирання даних
• Архівні системи: Доступ і відображення історичних PDF-документів

Освітні та дослідницькі

• Платформи e-learning: Відображення навчальних матеріалів і підручників
• Дослідницькі інструменти: Аналіз і вилучення даних з наукових публікацій
• Цифрові бібліотеки: Перегляд і пошук у колекціях документів
• Програми для нотаток: Додавання анотацій і підсвічування вмісту PDF

Юридичні питання та відповідність

• Перегляд юридичних документів: Перевірка контрактів і юридичних матеріалів
• Системи відповідності: Перевірка цілісності документів і підписів
• Керування справами: Упорядкування та перевірка юридичної документації
• Інструменти аудиту: Обробка та аналіз нормативних документів

Технічні та інженерні

• CAD-переглядачі: Відображення технічних креслень і специфікацій
• Системи посібників: Доступ до інструкцій з обслуговування та експлуатації
• Контроль якості: Перевірка звітів випробувань і сертифікацій
• Керування проєктами: Робота з проєктною документацією та планами

Продуктивність і надійність

• Перевірений рендеринг: Рендеринг сторінок використовує родину рушіїв PDFium, що стоїть за показом PDF у Chromium, а все, що над ними, — власна реалізація losLab на Object Pascal
• Висока продуктивність: Записи DIB без копіювання, прогресивний рендеринг із можливістю скасування, паралельний рендеринг сторінок, завантаження з довільним доступом на вимогу без попереднього копіювання в пам’ять і один вимірюваний байтовий бюджет для утримуваних сцен сторінок і керованих знімків
• Стабільність під ворожим введенням: Декодування потоків, нормалізація вмісту та сканування структури працюють у межах явних бюджетів джерела, виводу, токенів, вкладеності та коефіцієнта розширення, тому пошкоджений або сконструйований файл повертає структурований статус замість вичерпання пам’яті
• Масштабованість: Працює і з малими формами, і з документами на кілька гігабайт, з обмеженим робочим сховищем, яке вивантажує дані у тимчасовий файл із видаленням після закриття

Бізнес-цінність

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

Досвід розробника

• Легка інтеграція: Компоненти, які легко додати, з мінімальним налаштуванням
• Багата документація: Докладні довідкові файли та приклади
• Керованість подіями: Гнучке налаштування через велику кількість подій
• Підтримка часу проєктування: Редактори властивостей та інтеграція з IDE