PAGE XML renderer / export

[JKamlah]

Hi everyone,

I've created a PAGE-XML renderer/export.

It's not just a simple PAGE-XML export, it can also produce a textline polygon instead of a simple bounding box, and it can output up to word level.
The output can be customised with three bool parameters

   tessedit_create_page_xml -> "Write .page.xml PAGE file".
   page_xml_polygon -> "Create PAGE file with polygons instead of box values (default:True)".
   page_xml_level -> "Create PAGE with 0 - line or 1 - word level (default:0)".

After installing tesseract you can use the preconfigured settings: 'page' .
page -> Output page.xml file with polygon and line-level

As word-level is more of a niche requirement, you need to enable it via -c:
-c page_xml_polygon=1 // True polygon or False bounding boxes
-c page_xml_level=1 // 0 line or 1 word level

The output is valid for PAGE XML version 2019-07-15.

If the textlines contains only ltr or rtl characters, the output is correct, but for mixed lines (BiDi) I am not quite sure.
Can anyone help me here?

[egorpugin]

Can you send a result file of this code for some example image?

[stweil]

The CI builds fail because some include statements are missing.

[JKamlah]

Thanks for suggestion and fixes @stweil

Here are examples for eurotext and hebrew with 'page' and 'page-poly':
https://digi.bib.uni-mannheim.de/~jkamlah/PAGERenderer/

[stweil]

Can you send a result file of this code for some example image?

PAGE XML with box coordinates:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<PcGts xmlns="http://schema.primaresearch.org/PAGE/gts/pagecontent/2019-07-15" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://schema.primaresearch.org/PAGE/gts/pagecontent/2019-07-15 http://schema.primaresearch.org/PAGE/gts/pagecontent/2019-07-15/pagecontent.xsd">
        <Metadata>
                <Creator>Tesseract - 5.3.4-27-ge2f3</Creator>
                <Created>2024-03-20T14:16:51</Created>
                <LastChange>2024-03-20T14:16:51</LastChange>
        </Metadata>
        <Page imageFilename="test/testing/HelloGoogle.tif" imageWidth="400" imageHeight="200" type="content">
                <ReadingOrder>
                        <OrderedGroup id="ro6814328771458624830" caption="Regions reading order">
                                <RegionRefIndexed index="0" regionRef="r0"/>
                        </OrderedGroup>
                </ReadingOrder>
                <TextRegion id="r0" custom="readingOrder {index:0;} readingDirection {left-to-right;} orientation {0;}">
                        <Coords points="10,20 331,20 331,71 10,71"/>
                        <TextLine id="r0l0" readingDirection="left-to-right" custom="readingOrder {index:0;}">
                                <Coords points="10,20 331,20 331,71 10,71"/>
                                <Baseline points="10,59 331,63"/>
                                <TextEquiv index="1" conf="0.9585">
                                        <Unicode>Hello Google</Unicode>
                                </TextEquiv>
                        </TextLine>
                        <TextEquiv index="1" conf="0.9585">
                                <Unicode>Hello Google</Unicode>
                        </TextEquiv>
                </TextRegion>
                </Page>
</PcGts>

PAGE XML with polygon:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<PcGts xmlns="http://schema.primaresearch.org/PAGE/gts/pagecontent/2019-07-15" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://schema.primaresearch.org/PAGE/gts/pagecontent/2019-07-15 http://schema.primaresearch.org/PAGE/gts/pagecontent/2019-07-15/pagecontent.xsd">
        <Metadata>
                <Creator>Tesseract - 5.3.4-27-ge2f3</Creator>
                <Created>2024-03-20T14:19:36</Created>
                <LastChange>2024-03-20T14:19:36</LastChange>
        </Metadata>
        <Page imageFilename="test/testing/HelloGoogle.tif" imageWidth="400" imageHeight="200" type="content">
                <ReadingOrder>
                        <OrderedGroup id="ro6814328771458624830" caption="Regions reading order">
                                <RegionRefIndexed index="0" regionRef="r0"/>
                        </OrderedGroup>
                </ReadingOrder>
                <TextRegion id="r0" custom="readingOrder {index:0;} readingDirection {left-to-right;} orientation {0;}">
                        <Coords points="10,20 331,20 331,71 10,71"/>
                        <TextLine id="r0l0" readingDirection="left-to-right" custom="readingOrder {index:0;}">
                                <Coords points="10,21 42,21 46,30 74,30 79,20 102,20 105,30 132,30 158,22 193,22 197,32 276,32 276,22 298,22 331,23 331,63 298,63 298,71 259,71 256,62 197,62 158,61 74,60 46,60 10,58"/>
                                <Baseline points="10,59 158,60 331,63"/>
                                <TextEquiv index="1" conf="0.9585">
                                        <Unicode>Hello Google</Unicode>
                                </TextEquiv>
                        </TextLine>
                        <TextEquiv index="1" conf="0.9585">
                                <Unicode>Hello Google</Unicode>
                        </TextEquiv>
                </TextRegion>
                </Page>
</PcGts>

[JKamlah]

Added terminating linefeed, removed trailing whitespaces and fixed typos (found by typos-cli).
For the unused functions and variables I need some time.

[stweil]

Maybe we can merge this new feature in a new 5.4.0 pre-release.

[egorpugin]

Should we squash long PRs?

Upd.:
I see, seems squashed.