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

Огляд продукту

PDFiumPas — це комплексна компонентна бібліотека професійного рівня, яка приносить потужні можливості обробки та перегляду PDF у програми Delphi і C++Builder. Побудована на надійному рушії рендерингу Google PDFium, вона надає розробникам повне рішення для інтеграції PDF-функціональності у настільні програми

Бібліотека складається з двох основних компонентів, які безшовно працюють разом: TPdf для обробки та редагування документів і TPdfView для інтерактивного візуального подання. Якщо вам потрібно створити простий переглядач PDF, складну систему керування документами або інтегрувати можливості PDF у наявні програми, PDFiumPas надає потрібні інструменти та гнучкість

Основні компоненти

TPdf Component - Рушій обробки документів

Серце системи обробки PDF, TPdf виконує всі операції на рівні документа, включно із завантаженням, збереженням, вилученням тексту, обробкою форм і керуванням метаданими

Керування документами: Відкриття з файлів, потоків або буферів пам’яті
Text Processing: Розширене вилучення тексту та можливості пошуку
Form Handling: Повна підтримка інтерактивних форм із JavaScript
Security: Підтримка PDF, захищених паролем, і керування дозволами
Metadata Access: Повні властивості документа та отримання інформації

Компонент TPdfView - Інтерактивний елемент керування переглядачем

Вишуканий візуальний елемент керування, який забезпечує насичений перегляд PDF із повними можливостями взаємодії користувача

Високоякісне відтворення: Оптимізоване відображення з кількома режимами рендерингу
Interactive Navigation: Масштабування, прокручування, обертання та навігація по сторінках
Text Selection: Виділення, копіювання та робота з текстом
Annotation Display: Перегляд і взаємодія з анотаціями PDF
Миша та клавіатура: Повна підтримка пристроїв вводу з відображенням координат

Основні функції та можливості

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

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

Операції з текстом і вмістом

Розширене вилучення тексту зі збереженням форматування
Потужний пошук тексту з різними параметрами
Аналіз і позиціювання тексту на рівні символів
Доступ до інформації та властивостей шрифтів
Виділення тексту та операції з буфером обміну
Підтримка багатомовності та Unicode

Інтерактивні форми та анотації

Повна підтримка інтерактивних полів форми
Текстові поля, прапорці, радіокнопки, комбосписки
Перевірка форм і виконання JavaScript
Відображення анотацій та взаємодія з ними
Анотації-посилання та вебпосилання
Підтримка цифрових підписів

Візуальний рендеринг і відображення

Високоякісний згладжений рендеринг із прямим записом без копіювання у цільовий буфер DIB
Скасований прогресивний рендеринг через RenderPageProgressive і IPdfCancellationToken
Кілька режимів відображення (односторінковий безперервний, двосторінковий безперервний, двосторінковий з обкладинкою)
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 властивостей і методів
Підтримка часу проєктування з редакторами властивостей
Потокобезпечні операції там, де це можливо
Ефективна робота з пам’яттю для великих документів

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

Аспект	Подробиці
Механізм рендерингу	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)

Архітектурна схема

PDFiumPas дотримується багаторівневої архітектурної схеми, яка чітко розділяє відповідальність і максимально підвищує повторне використання коду

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

Шар	Файли	Відповідальність
Компоненти 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, FPdfFWLПодія.pas, FPdfCompress.pas, FPdfUtils.pas	Оголошення покажчиків на функції для викликів DLL PDFium
Конвеєр PDF/A	FPdfPdfa.pas	Створення PDF/A-1b (вбудовування XMP, sRGB ICC OutputIntent, оновлення каталогу) і перевірка (визначення відповідності, перелік проблем)
Асинхронна інфраструктура	FPdfAsync.pas	IPdfCancellationToken / IPdfCancellationTokenSource, синглтон PdfNoCancellationToken і допоміжний TPdfFuture<T> для тривалого рендерингу та експорту
Помічники з геометрії	FPdfMatrix.pas	ОО-обгортка навколо FS_MATRIX з допоміжними методами Translate, Scale, Rotate, Flip, Skew і Multiply
Операції зі сторінками	FPdfPageOps.pas	Обгортки для FPDF_ImportPagesByIndex, 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

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

Dynamic DLL Loading: Функції PDFium завантажуються під час виконання через GetProcAddress
Handle-Based Resources: Документи PDF, сторінки та об’єкти керуються через непрозорі handle
Подія-Driven Architecture: Розширені події для взаємодії з формами, змін сторінок і рендерингу
Record-Based Типs: Складні структури даних представлені як записи Delphi (TBookmark, TDestination, TPdfAnnotation тощо)
Opt-In Helpers: FPdfAsync і FPdfMatrix надають утиліти скасування/future і перетворень без примусового вбудовування їх у головний компонент TPdf

Сценарії використання

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

Керування документами Systems: Перегляд, упорядкування та обробка PDF-документів
Report Viewers: Відображення згенерованих звітів і бізнес-документів
Form Processing: Робота з інтерактивними PDF-формами та збирання даних
Archive Systems: Доступ і відображення історичних PDF-документів

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

E-Learning Platforms: Відображення навчальних матеріалів і підручників
Research Tools: Аналіз і вилучення даних з наукових публікацій
Digital Libraries: Перегляд і пошук у колекціях документів
Note-Taking Apps: Додавання анотацій і підсвічування вмісту PDF

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

Legal Document Review: Перевірка контрактів і юридичних матеріалів
Compliance Systems: Перевірка цілісності документів і підписів
Case Management: Упорядкування та перевірка юридичної документації
Audit Tools: Обробка та аналіз нормативних документів

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

CAD Viewers: Відображення технічних креслень і специфікацій
Manual Systems: Доступ до інструкцій з обслуговування та експлуатації
Quality Control: Перевірка звітів випробувань і сертифікацій
Project Management: Робота з проєктною документацією та планами

Переваги та вигоди

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

Proven Technology: Побудовано на рушії Google PDFium, який використовує браузер Chrome
High Performance: Оптимізований рендеринг і керування пам’яттю
Stability: Ретельно протестовано на тисячах PDF-документів
Scalability: Підходить і для малих форм, і для великих багатосторінкових документів

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

Rapid Development: Комплексний API скорочує час розробки
Royalty-Free: Без плати за виконання або ліцензійних складнощів
Source Code Included: Повна можливість налаштування та налагодження
Long-term Support: Регулярні оновлення та підтримка сумісності

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

Easy Integration: Компоненти, які легко додати, з мінімальним налаштуванням
Rich Документація: Докладні довідкові файли та приклади
Подія-Driven: Гнучке налаштування через велику кількість подій
Design-Time Support: Редактори властивостей та інтеграція з IDE

Далі

Головна - Точка входу вебнавігації
Посібник швидкого старту - Почніть роботу за лічені хвилини
Інструкції зі встановлення - Налаштування та конфігурація
Приклади коду - Практичні сценарії використання
Повний довідник API - Повна документація компонента
Компонент TPdf - Деталі обробки документа
Компонент TPdfView - Viewer control details

Бібліотека компонентів PDFiumPas