Text.Element

AI-generated Key Takeaways

• Text.Element represents a space-separated text segment within a line of text, like a word.

• Each Text.Element provides access to its recognized text, bounding box, confidence score, language, and constituent symbols.

• Corner points and rotation angle information are also available for each detected element.

• The getSymbols method allows access to individual characters or symbols that comprise the element.

• If a word is hyphenated across lines, it's represented by multiple Text.Symbol objects within separate Text.Element instances.

public static class Text.Element extends Object

Represents a space-separated segment in a line of text (for example, a word in most Latin languages). If a word is split between two lines by a hyphen, each part is encoded as a separate Text.Symbol.

Public Method Summary

float	getAngle() Gets the angle(in degrees, clockwise is positive, range is [-180, 180]) of the rotation of the recognized element.
Rect	getBoundingBox() Returns the axis-aligned bounding rectangle of the detected text.
float	getConfidence() Gets the confidence of the recognized element.
Point[]	getCornerPoints() Gets the four corner points in clockwise direction starting with top-left.
String	getRecognizedLanguage() Gets prevailing language in the text, if any.
synchronized List<Text.Symbol>	getSymbols() Gets a unmodifiable list of Text.Symbols that make up this text element.
String	getText() Gets the recognized text in the Text.Element.

Inherited Method Summary

From class java.lang.Object

Object	clone()
boolean	equals(Object arg0)
void	finalize()
final Class<?>	getClass()
int	hashCode()
final void	notify()
final void	notifyAll()
String	toString()
final void	wait(long arg0, int arg1)
final void	wait(long arg0)
final void	wait()

Public Methods

public float getAngle ()

Gets the angle(in degrees, clockwise is positive, range is [-180, 180]) of the rotation of the recognized element.

public Rect getBoundingBox ()

Returns the axis-aligned bounding rectangle of the detected text. If nothing found, it returns null.

public float getConfidence ()

Gets the confidence of the recognized element.

It is in range [0.0f, 1.0f].

Note that this information will be unavailable (i.e. returns 0) if you're using the unbundled version of Text Recognition library with an older version of Google Play services (lower than 22.30.XX).

public Point[] getCornerPoints ()

Gets the four corner points in clockwise direction starting with top-left. Due to the possible perspective distortions, this is not necessarily a rectangle. Parts of the region could be outside of the image. If nothing found, it returns null.

public String getRecognizedLanguage ()

Gets prevailing language in the text, if any. The format is in BCP47 (e.g. "en" or "sr-Latn-BA") or "und" if the language could not be determined.

public synchronized List<Text.Symbol> getSymbols ()

Gets a unmodifiable list of Text.Symbols that make up this text element. Note that such field is not available for unbundled versions of Text Recognition library yet.

Returns an empty list if nothing is found.

public String getText ()

Gets the recognized text in the Text.Element.

The recognized text is in reading order for the language. For Latin, it is left-to-right.

Returns an empty string if nothing is found.