Foxit PDF SDK
|
Public Member Functions | |
TextPage (PDFPage page, int flags) throws com.foxit.sdk.PDFException | |
Constructor, from a parsed PDF page. More... | |
TextPage (TextPage other) | |
Constructor, with another text page object. More... | |
synchronized void | delete () |
Clean up related resources immediately. More... | |
int | getBaselineRotation (int rect_index) throws com.foxit.sdk.PDFException |
Get the text trend (as rotation) of a specified rectangle. More... | |
int | getCharCount () throws com.foxit.sdk.PDFException |
Get the count of all the characters. More... | |
TextPageCharInfo | getCharInfo (int char_index) throws com.foxit.sdk.PDFException |
Get character information of a specific character. More... | |
Range | getCharRange (RectF rect) throws com.foxit.sdk.PDFException |
Get the character index range of all text rectangles within the specified rectangle region. More... | |
String | getChars (int start, int count) throws com.foxit.sdk.PDFException |
Get all the characters within a range specified by a start index and count. More... | |
int | getIndexAtPos (float x, float y, float tolerance) throws com.foxit.sdk.PDFException |
Get the character index at or around a specified position on the page, in [PDF coordinate system] (com.foxit.sdk.pdf.PDFPage). More... | |
String | getText (int flag) throws com.foxit.sdk.PDFException |
Get the page text. More... | |
String | getTextInRect (RectF rect) throws com.foxit.sdk.PDFException |
Get the text within a rectangle, in PDF coordinate system. More... | |
RectF | getTextRect (int rect_index) throws com.foxit.sdk.PDFException |
Get the text rectangle by the index. More... | |
RectFArray | getTextRectArrayByRect (RectF rect) throws com.foxit.sdk.PDFException |
Get the array of all text rectangles within the specified rectangle region. More... | |
int | getTextRectCount (int start, int count) throws com.foxit.sdk.PDFException |
Count the text rectangles within a range specified by a start index and count. More... | |
String | getTextUnderAnnot (Annot annot) throws com.foxit.sdk.PDFException |
Get the page text which intersect with a specified an annotation. More... | |
Range | getWordAtPos (float x, float y, float tolerance) throws com.foxit.sdk.PDFException |
Get the character range of a word at or around a specified position on the page, in [PDF coordinate system] (com.foxit.sdk.pdf.PDFPage). More... | |
boolean | isEmpty () |
Check whether current object is empty or not. More... | |
Static Public Attributes | |
static final int | e_ParseTextNormal = 0x0000 |
Parse the text content of a PDF page by normalizing characters based on their positions in the PDF page. | |
static final int | e_ParseTextOutputHyphen = 0x0001 |
Parse the text content of a PDF page with outputting the hyphen on a line feed. | |
static final int | e_ParseTextUseStreamOrder = 0x0002 |
Parse the text content of a PDF page by the stream order. | |
static final int | e_TextDisplayOrder = 1 |
If this is set, that means to get text content of a PDF page by the display order. | |
static final int | e_TextStreamOrder = 0 |
If this is set, that means to get text content of a PDF page by the stream order. | |
PDF text page represents all the text contents in a PDF page, according to a specified parsing flag for these text. Class TextPage can be used to retrieve information about text in a PDF page, such as single character, single word, text content within specified character range or rectangle and so on.
This class object can also be used to construct objects of other text related classes in order to do more operation for text contents or access specified information from text contents:
com.foxit.sdk.pdf.TextPage.TextPage | ( | PDFPage | page, |
int | flags | ||
) | throws com.foxit.sdk.PDFException |
Constructor, from a parsed PDF page.
[in] | page | A valid PDF page object. This page should has been parsed. |
[in] | flags | Parsing flags for the text page. Please refer to values starting from com.foxit.sdk.pdf.TextPage.e_ParseTextNormal and this can be one or combination of these values. |
com.foxit.sdk.pdf.TextPage.TextPage | ( | TextPage | other | ) |
Constructor, with another text page object.
[in] | other | Another text page object. |
synchronized void com.foxit.sdk.pdf.TextPage.delete | ( | ) |
Clean up related resources immediately.
Reimplemented from com.foxit.sdk.common.Base.
int com.foxit.sdk.pdf.TextPage.getBaselineRotation | ( | int | rect_index | ) | throws com.foxit.sdk.PDFException |
Get the text trend (as rotation) of a specified rectangle.
[in] | rect_index | The index of the rectangle to be retrieved. Valid range: from 0 to (count -1). count is returned by function TextPage.getTextRectCount . |
int com.foxit.sdk.pdf.TextPage.getCharCount | ( | ) | throws com.foxit.sdk.PDFException |
Get the count of all the characters.
TextPageCharInfo com.foxit.sdk.pdf.TextPage.getCharInfo | ( | int | char_index | ) | throws com.foxit.sdk.PDFException |
Get character information of a specific character.
[in] | char_index | A zero-based index of character. Range: from 0 to (charcount - 1).charcount is returned by function TextPage.getCharCount . |
Range com.foxit.sdk.pdf.TextPage.getCharRange | ( | RectF | rect | ) | throws com.foxit.sdk.PDFException |
Get the character index range of all text rectangles within the specified rectangle region.
[in] | rect | A rectangle region, in PDF coordinate system. |
String com.foxit.sdk.pdf.TextPage.getChars | ( | int | start, |
int | count | ||
) | throws com.foxit.sdk.PDFException |
Get all the characters within a range specified by a start index and count.
[in] | start | Index of start character, which is the first character of the expected text content. Valid range: from 0 to (charcount -1). charcount is returned by function TextPage.getCharCount . |
[in] | count | Count of characters to be retrieved. -1 means to get the whole characters from start_index to the end of PDF page. Especially, when parameter count is larger than (charcount - start), all the rest character (from start_index) will be retrieved. charcount is returned by function TextPage.getCharCount . |
int com.foxit.sdk.pdf.TextPage.getIndexAtPos | ( | float | x, |
float | y, | ||
float | tolerance | ||
) | throws com.foxit.sdk.PDFException |
Get the character index at or around a specified position on the page, in [PDF coordinate system] (com.foxit.sdk.pdf.PDFPage).
[in] | x | Value of x position, in PDF coordinate system. |
[in] | y | Value of y position, in PDF coordinate system. |
[in] | tolerance | Tolerance value for character hit detection, in point units. This should not be a negative. |
String com.foxit.sdk.pdf.TextPage.getText | ( | int | flag | ) | throws com.foxit.sdk.PDFException |
Get the page text.
[in] | flag | Text order flag to decide how to get text content of the related PDF page. Please refer to values starting from com.foxit.sdk.pdf.TextPage.e_TextStreamOrder and this should be one of these values. |
String com.foxit.sdk.pdf.TextPage.getTextInRect | ( | RectF | rect | ) | throws com.foxit.sdk.PDFException |
Get the text within a rectangle, in PDF coordinate system.
[in] | rect | A rectangle region, in PDF coordinate system. |
RectF com.foxit.sdk.pdf.TextPage.getTextRect | ( | int | rect_index | ) | throws com.foxit.sdk.PDFException |
Get the text rectangle by the index.
[in] | rect_index | The index of the rectangle to be retrieved. Valid range: from 0 to (count -1). count is returned by function TextPage.getTextRectCount . |
RectFArray com.foxit.sdk.pdf.TextPage.getTextRectArrayByRect | ( | RectF | rect | ) | throws com.foxit.sdk.PDFException |
Get the array of all text rectangles within the specified rectangle region.
[in] | rect | A rectangle region, in PDF coordinate system. |
int com.foxit.sdk.pdf.TextPage.getTextRectCount | ( | int | start, |
int | count | ||
) | throws com.foxit.sdk.PDFException |
Count the text rectangles within a range specified by a start index and count.
[in] | start | Index of start character in the character index range. Valid range: from 0 to (charcount -1). charcount is returned by function TextPage.getCharCount . |
[in] | count | Count of characters in the character index range. -1 means to get the whole characters from start_index to the end of PDF page. |
String com.foxit.sdk.pdf.TextPage.getTextUnderAnnot | ( | Annot | annot | ) | throws com.foxit.sdk.PDFException |
Get the page text which intersect with a specified an annotation.
If the whole character or most part of the character intersects with an annotation, this character will be retrieved by current function.
[in] | annot | An annotation. Page text which intersects with this annotation is to be retrieved. Currently, only support text markup annotation (highlight/underline/strike-out/squggly annotations); for annotation in other types, this function will throw exception com.foxit.sdk.common.Constants.e_ErrUnsupported . |
Range com.foxit.sdk.pdf.TextPage.getWordAtPos | ( | float | x, |
float | y, | ||
float | tolerance | ||
) | throws com.foxit.sdk.PDFException |
Get the character range of a word at or around a specified position on the page, in [PDF coordinate system] (com.foxit.sdk.pdf.PDFPage).
Currently, for Chinese/Japanese/Korean, only support to get a single character at or around the specified position.
[in] | x | Value of x position, in PDF coordinate system. |
[in] | y | Value of y position, in PDF coordinate system. |
[in] | tolerance | Tolerance value for word hit detection, in point units.This should not be a negative. |
boolean com.foxit.sdk.pdf.TextPage.isEmpty | ( | ) |
Check whether current object is empty or not.
When the current object is empty, that means current object is useless.