Просмотр исходного текста страницы Использование PDFium совместно с Qt Quick для отображения PDF-документов в ОС Аврора (Алексей Федченко, OSSDEVCONF-2022)

;{{SpeakerInfo}}: {{Speaker|Алексей Федченко}}
<blockquote>
В докладе описывается реализация библиотеки и&nbsp;приложения для просмотра PDF-документов.

Рассказывается про взаимодействие со&nbsp;структурой документа (страницы, текст, аннотации, заметки),
а&nbsp;также особенности рендеринга контента (в&nbsp;том числе, ограничения видеобуфера, отрисовка тайлами и&nbsp;масштабирование).
Полученное решение основано на&nbsp;технологиях Qt&nbsp;Quick и&nbsp;PDFium.
Оно может быть удобно использовано в&nbsp;приложениях,
написанных с&nbsp;использованием фреймворка&nbsp;Qt, в&nbsp;том числе для ОС&nbsp;Аврора.
</blockquote>

{{VideoSection}}
{{vimeoembed|923073078|800|450}}
{{youtubelink|}}

{{SlidesSection}}
[[File:Использование PDFium совместно с Qt Quick для отображения PDF-документов в ОС Аврора (Алексей Федченко, OSSDEVCONF-2022).pdf|left|page=-|300px]]

{{----}}

== Thesis ==
* https://community.omprussia.ru/open_source

[https://auroraos.ru/ ОС&nbsp;Аврора] —  это российский POSIX-совместимый дистрибутив Linux,
предназначенный для использования на&nbsp;смартфонах и&nbsp;планшетах корпоративными заказчиками и&nbsp;государственными компаниями.

[https://auroraos.ru/applications Экосистема приложений ОС&nbsp;Аврора] обеспечивается
как стандартными приложениями, доступными на&nbsp;устройствах «из&nbsp;коробки»
(голосовые вызовы, сообщения, браузер, заметки и&nbsp;т.&nbsp;п.),
так и&nbsp;приложениями, разрабатываемым третьими лицами:
продуктами партнёров компании или специализированным программным обеспечением (ПО).

Одной из наиболее востребованных функции корпоративного&nbsp;ПО является работа с&nbsp;документами в&nbsp;формате&nbsp;PDF:
просмотр, аннотирование, переход по ссылкам.
Это порождает задачи, требующие интеграции функций для работы с&nbsp;PDF в&nbsp;другие приложения:
системы электронного документооборота, подпись документов, платёжные системы и&nbsp;др.

Поэтому возникает вопрос о&nbsp;том, какие доступны средства разработки,
позволяющие взаимодействовать с&nbsp;документами в&nbsp;формате&nbsp;PDF [https://www.adobe.com/content/dam/acom/en/devnet/acrobat/pdfs/PDF32000_2008.pdf], [https://resources.infosecinstitute.com/topic/pdf-file-format-basic-structure], [https://www.iso.org/standard/51502.html].

Технически могут быть использованы любые POSIX-совместимые решения [https://standards.ieee.org/project/1003_1.html], [https://en.wikipedia.org/wiki/List_of_PDF_software#Linux_and_Unix].

Однако условия их&nbsp;применения на&nbsp;мобильных устройствах, которые уступают в&nbsp;производительности ПК,
накладывают требования к&nbsp;скорости работы.
А&nbsp;потребность использования в&nbsp;сторонних приложениях обуславливает необходимость пермиссивной лицензии.

В&nbsp;статье<ref name="fedchenko-chuvilin_fruct29">Alexey Fedchenko and Kirill Chuvilin, PDF Document Rendering on Mobile Devices in the Case of Aurora OS, book29th Conference of Open Innovations Association,  p. 118—124, 2021, FRUCT</ref> описан выбор библиотеки для работы с&nbsp;PDF,
которая может быть использована для таких целей c&nbsp;учётом всех требований.
Наиболее подходящей оказалась [https://github.com/paulovap/qtpdfium PDFium] — 
библиотека с&nbsp;открытым исходным кодом от&nbsp;Google,
распространяющаяся под лицензией [http://www.linfo.org/mitlicense.html MIT].
Решение, описываемое в&nbsp;докладе, основано именно на&nbsp;ней.

Основным фреймворком для разработки прикладного&nbsp;ПО для ОС&nbsp;Аврора является [https://qt.io Qt]&nbsp;версии&nbsp;5.6 а&nbsp;интерфейс пользователя реализуется с&nbsp;помощью [https://doc.qt.io/qt-5/qmlapplications.html QML].
Это означает, что для удобства использования в&nbsp;приложениях нужно обеспечить совместимость PDFium и&nbsp;Qt.
Есть решения, которые реализуют подобное связывание:

* Библиотека [https://marketplace.qt.io/products/qtpdf QtPDF] предоставляется разработчиками&nbsp;Qt,   но&nbsp;её лицензия [http://www.gnu.org/licenses/gpl-3.0.html GPLv3] требует раскрытия исходного кода конечного приложения,     что делает её&nbsp;неподходящей для большинства прикладных коммерческих приложений.
* [https://github.com/paulovap/qtpdfium QtPDFium] —  это неофициальная библиотека. Она распространяется под удобной [http://www.linfo.org/bsdlicense.html лицензией BSD], но&nbsp;при этом использует непубличный API и&nbsp;привязана к&nbsp;устаревшей версии PDFium. Кроме того, поддержка библиотеки прекращена.

Таким образом, для свободного использования актуальной версии PDFium совместно с&nbsp;Qt
потребовалось разработать новое связующее&nbsp;ПО.

При реализации связующего&nbsp;ПО и приложения его использующего,
возникает ряд задач, обусловленных как функциональными требованиями,
так и техническими ограничениями:

* как обеспечить асинхронную обработку данных, которую активно использует Qt&nbsp;Quick,    при условии строгой однопоточности PDFium; 
* как отрендерить и&nbsp;отрисовывать страницу, разрешение которой превышает размер видеобуфера устройства;
* как реализовать представление списка страниц с&nbsp;корректной прокруткой и&nbsp;эффективным вычислением текущего положения при условии, что страницы могут быть разных пропорций;
* как масштабировать одну страницу и&nbsp;список страниц; 
* как сделать взаимодействие пользователя с&nbsp;гиперссылками и&nbsp;другими элементами навигации;
* каким образом реализовать выделение и&nbsp;копирование текстовых данных;
* как организовать работу с&nbsp;заметками в&nbsp;документе.

В&nbsp;докладе описываются выбранные подходы для решения указанных задач
на&nbsp;примере библиотеки AmberPDF и&nbsp;приложения Tiny&nbsp;PDF&nbsp;Viewer,
которые были реализованы и&nbsp;предоставляются для удобства работы c&nbsp;PDF в&nbsp;приложениях для ОС&nbsp;Аврора,
но&nbsp;также могут быть полезны и&nbsp;при разработке других приложений, основанных на&nbsp;Qt и&nbsp;работающих с&nbsp;PDF.


{{----}}
[[File:{{#setmainimage:Использование PDFium совместно с Qt Quick для отображения PDF-документов в ОС Аврора (Алексей Федченко, OSSDEVCONF-2022)!.jpg}}|center|640px]]
{{LinksSection}}
<!-- <blockquote>[©]</blockquote> -->

<references/>

[[Категория:OSSDEVCONF-2022]]
[[Категория:Draft]]