GSoC/2018/StatusReports/DileepSankhla: Difference between revisions

Revision as of 16:57, 7 July 2018

Implementing the FreeText annotation with FreeTextTypewriter behavior

Okular is a KDE universal document viewer. It allows reviewing and annotating the PDF documents and supports various text and graphic annotations. FreeText is one of them but the FreeTextTypewriter behavior (WYSIWYG live editing) is still missing to write directly on PDF page. This project focus on implementing this missing FreeText annotation feature and adding a new ‘Typewriter’ entry in the annotation toolbar.

Mentor: Tobias Deiminger

Project Goals

Add a new typewriter icon and settings dialogue to the annotation toolbar.
Setting annotation background to transparent, and /IT set to FreeTextTypewriter.
Re-design text input UI and implement a community selected WYSIWYG approach to write directly on PDF page.

Work Report

Community Bonding Period

During Community Bonding period, I've been in communication with my mentor, discussing various implementation ideas and learning more about the PDF format and the codebase of Okular and Poppler. In the meantime, I have got a KDE developer account, set up a scratch repository to discuss the ideas and share experimental code and explored pertinent bug reports on Bugzilla by taking part in the conversation. As I didn't mention any particular approach for click-to-type typewriter WYSIWYG editing in my GSoC proposal, we had to discuss, experiment and present a couple of ideas to the okular-devel list and will agree upon the community selected one. Further, I set up the working environment and built the project and I'm reading the Qt TextEdit and Poppler Qt5 frontend documentation while consulting with my mentor for the optimal approach to implement the proposed features.

Coding Period - Phase one (May 14th to June 12th)

Initial Implementation of Typewriter Annotation Tool in Okular

This phase was devoted to implementing the fully functional typewriter tool that creates the annotation with the transparent background in all the supported document formats and the text input UI in the current implementation is the popup QInputDialog window which is in accordance with the inline note. This is how it works:

A number of integration tests have also been written and the tasks for this phase are completed as planned. For the next phase, I'm aiming at fixing the minor bugs and implementing font color in Poppler where it should also respect the font family.

Coding Period - Phase one (June 13th to July 7th)

Implementation of font color in Poppler and Okular

I have patched the poppler-qt5 with the font color by introducing the ‘rg’ operator in the GooString which formats the font color in the RGB color model. The signature of setTextFont function is changed to pass both the QFont and the QColor arguments. In Okular, the font color chooser is introduced in the typewriter annotation setting dialogue which sets both the text annotation’s color and the engine color and hence colorize the typewriter icon color accordingly. The generator side and the doctype XML metadata for saving text color are also adapted. It is well supported in PagePainter too. This is how it works:

Branch where I'm working

Okular typewriter branch

Important Links

Proposal Link

Project Proposal

Blog Posts

Contact

Email: [email protected]

IRC: robstat7

Github: robstat7

@@ Line 25: / Line 25: @@
 A number of integration tests have also been written and the tasks for this phase are completed as planned. For the next phase, I'm aiming at fixing the minor bugs and implementing font color in Poppler where it should also respect the font family.
+===Coding Period - Phase one (June 13th to July 7th)===
+====Implementation of font color in Poppler and Okular====
+I have patched the poppler-qt5 with the font color by introducing the ‘rg’ operator in the GooString which formats the font color in the RGB color model. The signature of setTextFont function is changed to pass both the QFont and the QColor arguments. In Okular, the font color chooser is introduced in the typewriter annotation setting dialogue which sets both the text annotation’s color and the engine color and hence colorize the typewriter icon color accordingly. The generator side and the doctype XML metadata for saving text color are also adapted. It is well supported in PagePainter too. This is how it works:
+[[File:font_color.gif]]
 == Branch where I'm working ==
@@ Line 41: / Line 48: @@
 * [https://dileepsankhla.com/blog/freetext-typewriter-annotation-wysiwyg-implementation-ideas FreeText typewriter annotation WYSIWYG implementation ideas]
 * [https://dileepsankhla.com/blog/gsoc-coding-period-phase-one-may-14th-to-june-12th-initial-implementation-of-typewriter-annotation-tool-in-okular GSoC Coding Period - Phase One (May 14th to June 12th): Initial implementation of typewriter annotation tool in Okular]
+* [https://dileepsankhla.com/blog/gsoc-coding-period-phase-one-june-13th-to-july-7th-font-color-implementation-in-poppler-and-okular GSoC Coding Period - Phase One (June 13th to July 7th): Font color implementation in Poppler and Okular]
 == Contact ==