StructuredText

StructuredText objects hold text from a page that has been analyzed and grouped into blocks, lines and spans.

Constructors

class StructuredText()

You cannot create instances of this class with the new operator!

To obtain a StructuredText instance use Page.prototype.toStructuredText().

Static properties

StructuredText.SEARCH_EXACT

used to search untransformed text

StructuredText.SEARCH_IGNORE_CASE

used to search text ignoring case differences

StructuredText.SEARCH_IGNORE_DIACRITICS

used to search text ignoring diacritics

StructuredText.SEARCH_REGEXP

used to search text with the needle being a regexp

StructuredText.SEARCH_KEEP_LINES

used to search text preserving line breaks.

StructuredText.SEARCH_KEEP_PARAGRAPHS

used to search text preserving paragraph breaks.

StructuredText.SEARCH_KEEP_HYPHENS

used to search text preserving hyphens and not joining lines.

Instance methods

StructuredText.prototype.search(needle, maxHits)

Search the text for all instances of needle, and return an array with all matches found on the page.

Each match in the result is an array containing one or more Quads that cover the matching text.

Arguments:

• needle (string) – The text to search for.

• options (number) – Optional options for the search. A logical or of options such as StructuredText.SEARCH_EXACT.

Returns:

Array of Array of Quad

var result = sText.search("Hello World!")

StructuredText.prototype.highlight(p, q, maxHits)

Return an array of Quad used to highlight a selection defined by the start and end points.

Arguments:

• p (Point) – Start point.

• q (Point) – End point.

• maxHits (number) – The maximum number of hits to return. Default 500.

Returns:

Array of Quad

var result = sText.highlight([100, 100], [200, 100])

StructuredText.prototype.copy(p, q)

Return the text from the selection defined by the start and end points.

Arguments:

• p (Point) – Start point.

• q (Point) – End point.

Returns:

string

var result = sText.copy([100, 100], [200, 100])

StructuredText.prototype.walk(walker)

Arguments:

• walker (StructuredTextWalker) – Callback object.

Walk through the blocks (images or text blocks) of the structured text. For each text block walk over its lines of text, and for each line each of its characters. For each block, line or character the walker will have a method called.

var sText = page.toStructuredText()
sText.walk({
        beginLine: function (bbox, wmode, direction) {
                console.log("beginLine", bbox, wmode, direction)
        },
        endLine: function () {
                console.log("endLine")
        },
        beginTextBlock: function (bbox) {
                console.log("beginTextBlock", bbox)
        },
        endTextBlock: function () {
                console.log("endTextBlock")
        },
        beginStruct: function (standard, raw, index) {
                console.log("beginStruct", standard, raw, index)
        },
        endStruct: function () {
                console.log("endStruct")
        },
        onChar: function (utf, origin, font, size, quad, argb, flags) {
                console.log("onChar", utf, origin, font, size, quad, argb, flags)
        },
        onImageBlock: function (bbox, transform, image) {
                console.log("onImageBlock", bbox, transform, image)
        },
        onVector: function (bbox, flags, argb) {
                console.log("onVector", bbox, flags, argb)
        },
})

StructuredText.prototype.asText()

Returns a plain text representation.

Returns:

string

StructuredText.prototype.asHTML(id)

Returns a string containing an HTML rendering of the text.

Arguments:

• id (number) – Used to number the “id” on the top div tag (as "page" + id).

Returns:

string

StructuredText.prototype.asJSON(scale)

Returns a JSON string representing the structured text data.

This is a simplified serialization of the information that StructuredText.prototype.walk() provides.

Note: You must extract the structured text with “preserve-spans”! If you forget to set this option, any font changes in the middle of the line will not be present in the JSON output.

Arguments:

• scale (number) – Optional scaling factor to multiply all the coordinates by.

Returns:

string containing JSON of the following schema:

type StructuredTextPage = {
        blocks: StructuredTextBlock[]
}
type StructuredTextBlock = {
        type: "image" | "text",
        bbox: {
                x: number,
                y: number,
                w: number,
                h: number
        },
        lines: StructuredTextLine[],
}
type StructuredTextLine = {
        wmode: 0 | 1,   // 0=horizontal, 1=vertical
        bbox: {
                x: number,
                y: number,
                w: number,
                h: number
        },
        font: {
                name: string,
                family: "serif" | "sans-serif" | "monospace",
                weight: "normal" | "bold",
                style: "normal" | "italic",
                size: number
        },
        // text origin point for first character in line
        x: number,
        y: number,
        text: string
}

var data = JSON.parse(page.toStructuredText("preserve-spans").asJSON())