GoogleVisionOCR (T-Plan Robot Enterprise 7.0 Code Documentation)

java.lang.Object
- com.tplan.robot.imagecomparison.tesseractocr.GoogleVisionOCR

All Implemented Interfaces:

com.tplan.robot.gui.components.ComparisonModuleGuiSupport, AdvancedImageComparisonModule, ExtendedSearchCapabilities, ImageComparisonModule, OCRConstants, TextRecognitionGUISupport, LocalizedPlugin, Plugin, Configurable, ExtendedParamsObject, Measurable, Stoppable, ImageObserver
```
public class GoogleVisionOCR
extends Object
implements ImageComparisonModule, Plugin, ImageObserver, ExtendedParamsObject, Configurable, ExtendedSearchCapabilities, com.tplan.robot.gui.components.ComparisonModuleGuiSupport, AdvancedImageComparisonModule, TextRecognitionGUISupport, Stoppable, Measurable, LocalizedPlugin
```
Module performing OCR through a call of the Google Vision API cloud service.

Since:

5.0

T-Plan Robot Enterprise, (C) 2009-2022 T-Plan Limited. All rights reserved.

Nested Class Summary
- Nested classes/interfaces inherited from interface com.tplan.robot.imagecomparison.tesseractocr.OCRConstants
  OCRConstants.OCR_ENGINES

Field Summary
- Fields inherited from interface com.tplan.robot.imagecomparison.ImageComparisonModule
  CONTEXT_OBJECT_IMAGE_COMPARISON_FAILURE_DESC, SEARCH_COORD_LIST
- Fields inherited from interface java.awt.image.ImageObserver
  ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
- Fields inherited from interface com.tplan.robot.gui.components.ComparisonModuleGuiSupport
  PROPERTY_NAME_OBJECT_CHANGED
- Fields inherited from interface com.tplan.robot.imagecomparison.tesseractocr.OCRConstants
  CFG_DEBUG_MODE, CFG_DOTALL_MODE, CFG_LEAVE_FILES, CFG_OCR_ENGINE, CONTEXT_TOCR_ERROR, CONTEXT_TOCR_TEXT, DEFAULT_FONT_SIZE, PARAM_DISTANCE, PARAM_FILTER, PARAM_FONTSIZE, PARAM_LANGUAGE, PARAM_MODE, PARAM_PATTERN, PARAM_SCALE, PARAM_TEXT, VAR_TOCR_ERROR, VAR_TOCR_LINE, VAR_TOCR_LINE_COUNT, VAR_TOCR_LINE_H, VAR_TOCR_LINE_W, VAR_TOCR_LINE_X, VAR_TOCR_LINE_Y, VAR_TOCR_MATCH, VAR_TOCR_MATCH_CLICK_X, VAR_TOCR_MATCH_CLICK_Y, VAR_TOCR_MATCH_COUNT, VAR_TOCR_MATCH_H, VAR_TOCR_MATCH_INDEX, VAR_TOCR_MATCH_W, VAR_TOCR_MATCH_X, VAR_TOCR_MATCH_Y, VAR_TOCR_TEXT, VAR_TOCR_TEXT_H, VAR_TOCR_TEXT_W, VAR_TOCR_TEXT_X, VAR_TOCR_TEXT_Y

Constructor Summary

Constructors
Constructor and Description

GoogleVisionOCR()

Constructors
Constructor and Description
`GoogleVisionOCR()`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`checkDependencies(PluginManager manager)` Check whether the current product installation contains all dependencies (other plugins) required to install this plugin.
`float`	`compare(Image desktopImage, Rectangle area, Image image, String methodParams, ScriptingContext repository, float passRate)` Compare the desktop image to another image and return a number indicating how much they match.
`float`	`compareToBaseImage(Image desktopImage, Rectangle area, String methodParams, ScriptingContext context, float passRate)` Compare the desktop image to the base image and return a number indicating how much they match.
`Map<Rectangle,int[]>`	`getAllFailedPixels()`
`String`	`getCode()` Get plugin code.
`Map<String,Object>`	`getComparisonParams()`
`Date`	`getDate()` Get plugin release date.
`float`	`getDefaultPassRate()` Get the default pass rate value.
`String`	`getDescription()` Get plugin description to be displayed in the GUI.
`String`	`getDisplayName()` Get short plugin name to be displayed in the GUI.
`String`	`getDisplayNameKey()` Get the key to the plugin name in the resource bundle.
`List<Point>`	`getFailedPixels()`
`String`	`getHitDescription(Rectangle r, StringBuilder label)` Get description of a particular match area.
`List<Rectangle>`	`getHits()`
`Class`	`getImplementedInterface()` Get Class of the exposed functional interface that this plugin implements.
`LinkedHashMap<Rectangle,String>`	`getLineRects()`
`String`	`getLongDescription()` Get long description of the object - purpose, usage, parameter syntax etc.
`int[]`	`getLowestSupportedVersion()` Get the lowest required version of T-Plan Robot Enterprise.
`List<TextSearchResult>`	`getMatches()`
`String`	`getMessageAfterInstall()` Get text of a message to be displayed after installation of this plugin.
`String`	`getMessageBeforeInstall()` Get text of a message to be displayed before installation of this plugin.
`String`	`getMethodDescription()` Get the method description.
`String`	`getMethodName()` Get the method name.
`List<String>`	`getParameters()` Get the list of parameter names supported by the object implementing this interface.
`List`	`getParameterValues(String parameterName)` Get the list of acceptable values of a particular parameter (if known).
`String`	`getPassRateName()` Get alternative name for the default "pass rate".
`List<Preference>`	`getPreferences()` Get metadata of displayable/editable configurable parameters.
`Component`	`getPreviewComponent(Window owner, File selectedFile, StringBuilder title)` Get the preview component.
`float`	`getProgress()` Get the task progress where 0 means "0% done" and 1 means "100% done".
`Rectangle`	`getRectangle()`
`String`	`getResultMessage(boolean useHtml, StringBuilder title, StringBuilder buttonLabel)` Get the message describing results of the last performed image comparison.
`String`	`getShortDescription()` Get short description which describes in a few words purpose and role of the object.
`String`	`getSupportContact()` Get support contact.
`Rectangle`	`getText(StringBuilder out)`
`String`	`getUniqueId()` Get unique ID associated with the plugin.
`String`	`getVendorHomePage()` Get the vendor home page.
`String`	`getVendorName()` Get vendor (provider) name to be displayed in the GUI.
`int[]`	`getVersion()` Get plugin version in form of an integer array.
`List<Preference>`	`getVisualParameters()` Get the list of supported parameters encapsulated in `Preference` instances.
`boolean`	`imageUpdate(Image img, int infoflags, int x, int y, int width, int height)` Dummy method implementing the ImageObserver interface.
`boolean`	`isMethodParamsSupported()` Define whether this module supports some custom parameters which can be passed via the `methodparams` parameter of the scripting language.
`boolean`	`isSecondImageRequired()` Determine whether we are comparing two images or just analyze the desktop image.
`boolean`	`isStopped()` Find out whether the task has been already stopped.
`boolean`	`isTrackingOfFailedPixelsSupported()`
`boolean`	`requiresRestart()` Indicate whether installation of this plugin requires application restart.
`void`	`setBaseImage(Image img)` Set the base image.
`void`	`setConfiguration(UserConfiguration cfg)` If an object implementing this interface is a plugin (i.e.
`void`	`setParameters(Map<String,String> paramsAndValues)` Set parameters and their values in the object.
`void`	`setTrackingOfFailedPixelsEnabled(boolean enabled)`
`void`	`stop()` Call this method to request the implementing object to stop the current task or activity.
`String`	`toString()`
`boolean`	`usesPassRate()` Indicate whether the module uses the pass rate as a parameter or not.

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.tplan.robot.imagecomparison.ImageComparisonModule
compare, getMethodName, isMethodParamsSupported, isSecondImageRequired, setBaseImage

Methods inherited from interface java.awt.image.ImageObserver
imageUpdate

Methods inherited from interface com.tplan.robot.imagecomparison.ExtendedSearchCapabilities
getAllFailedPixels, getHits, getRectangle, isTrackingOfFailedPixelsSupported, setTrackingOfFailedPixelsEnabled

Methods inherited from interface com.tplan.robot.gui.components.ComparisonModuleGuiSupport
getHitDescription, getPreviewComponent, getResultMessage

Methods inherited from interface com.tplan.robot.imagecomparison.AdvancedImageComparisonModule
getDefaultPassRate, getPassRateName, usesPassRate

Methods inherited from interface com.tplan.robot.imagecomparison.TextRecognitionGUISupport
getComparisonParams, getLineRects, getMatches, getText

Methods inherited from interface com.tplan.robot.util.Stoppable
isStopped, stop

Methods inherited from interface com.tplan.robot.util.Measurable
getProgress

Methods inherited from interface com.tplan.robot.plugin.Plugin
checkDependencies, getCode, getDate, getImplementedInterface, getLowestSupportedVersion, getMessageAfterInstall, getMessageBeforeInstall, getSupportContact, getVendorHomePage, getVendorName, getVersion, requiresRestart

- Constructor Detail
  - GoogleVisionOCR
```
public GoogleVisionOCR()
```
- Method Detail
  - compareToBaseImage
```
public float compareToBaseImage(Image desktopImage,
                                Rectangle area,
                                String methodParams,
                                ScriptingContext context,
                                float passRate)
```
    Description copied from interface: ImageComparisonModule
    Compare the desktop image to the base image and return a number indicating how much they match.
    This is just a convenience method used by the 'Waitfor match' command to perform repeated image comparisons against one image.
    The default image comparison algorithm is based on color histograms. A call of this method performs image comparison against precalculated base image histogram rather that against the base image pixels. As calculation of a color histograms is quite a time expensive operation, this approach allows to achieve higher performance.
    Any custom implementation of this interface may or may not take advantage of this approach. If you don't want to diferentiate between repeated and one time comparison calls, define the setBaseImage() and compareToBaseImage() methods as follows:
    // Base image private Image baseImage; // Set the base image public void setBaseImage(Image img) { baseImage = img; } // Compare an image with the base image public float compareToBaseImage(Image desktopImage) { return compare(desktopImage, baseImage); }
    Specified by:
    
    compareToBaseImage in interface ImageComparisonModule
    
    Parameters:
    
    desktopImage - an image to be compared to the base image.
    
    area - a rectangle area of the remote desktop to be used for image comparison. If the argument is null, the whole remote desktop image will be used.
    
    methodParams - method parameters passed by the 'methodparams' parameter of the 'CompareTo' or 'Waitfor update' command.
    
    context - a Map with execution context. Note that most of the objects contain there are not public and the parameter is specified here to allow compatibility among the custom and internal comparsion methods.
    
    passRate - pass rate in form of a float value between 0 and 1. This user input value indicates the lowest result which will be considered as match ("passed"). It is in fact the number specified by the 'passrate' parameter of the commands Screenshot, Compareto and Waitfor match/mismatch.
    
    Returns:
    
    a number between 0 and 1. While a value of 0 indicates 0% match (images do not match at all), 1 indicates a 100% match (images are equal).
  - getMethodDescription
```
public String getMethodDescription()
```
    Description copied from interface: ImageComparisonModule
    
    Get the method description. Though this method is not used in versions 1.2 and lower, future versions may provide a GUI method of adding custom comparison method which will take advantage of the method description.
    
    Specified by:
    
    getMethodDescription in interface ImageComparisonModule
    
    Returns:
    
    Description of the image comparison method (algorithm).
  - getDisplayName
```
public String getDisplayName()
```
    Description copied from interface: Plugin
    
    Get short plugin name to be displayed in the GUI.
    
    Specified by:
    
    getDisplayName in interface Plugin
    
    Returns:
    
    short plugin name.
  - getDisplayNameKey
```
public String getDisplayNameKey()
```
    Description copied from interface: LocalizedPlugin
    
    Get the key to the plugin name in the resource bundle.
    
    Specified by:
    
    getDisplayNameKey in interface LocalizedPlugin
    
    Returns:
    
    the plugin name key.
  - getDescription
```
public String getDescription()
```
    Description copied from interface: Plugin
    
    Get plugin description to be displayed in the GUI.
    
    Specified by:
    
    getDescription in interface Plugin
    
    Returns:
    
    plugin description. May be null.
  - getUniqueId
```
public String getUniqueId()
```
    Description copied from interface: Plugin
    
    Get unique ID associated with the plugin. The plugin manager uses the ID together with the version string to identify whether a plugin is already installed and whether a newer version of the same plugin is available.
    
    The unique ID in fact identifies a particular plugin delivered by a particular vendor. Plugin developers are recommended to choose an ID and keep it constant for all versions of one particular plugin. The ID is never displayed in the GUI so it doesn't have to be a readable text. To avoid conflicts with other vendors it is recommended to elaborate vendor or author name and feature description into the ID, for example "custom RFB client implemented by John Doe".
    
    Specified by:
    
    getUniqueId in interface Plugin
    
    Returns:
    
    unique plugin ID.
  - getParameters
```
public List<String> getParameters()
```
    Description copied from interface: ExtendedParamsObject
    
    Get the list of parameter names supported by the object implementing this interface.
    
    Specified by:
    
    getParameters in interface ExtendedParamsObject
    
    Returns:
    
    list of supported parameter names.
  - getParameterValues
```
public List getParameterValues(String parameterName)
```
    Description copied from interface: ExtendedParamsObject
    
    Get the list of acceptable values of a particular parameter (if known). The method should return null for parameters which are not enumerated "one of" type.
    
    Specified by:
    
    getParameterValues in interface ExtendedParamsObject
    
    Parameters:
    
    parameterName - parameter name
    
    Returns:
    
    list of acceptable parameter values or null if the parameter value is not limited to a particular value set.
  - setParameters
```
public void setParameters(Map<String,String> paramsAndValues)
```
    Description copied from interface: ExtendedParamsObject
    
    Set parameters and their values in the object. It will be called by the command and the map will contain parameters parsed on the command line. Parsing of the parameter values should be performed in a way which is not case sensitive (for example through encapsulating the map through the CaseTolerantHashMap class);
    
    Specified by:
    
    setParameters in interface ExtendedParamsObject
    
    Parameters:
    
    paramsAndValues - map of parameters and their values.
  - getVisualParameters
```
public List<Preference> getVisualParameters()
```
    Description copied from interface: ExtendedParamsObject
    
    Get the list of supported parameters encapsulated in Preference instances. It allows to specify a larger set of parameter properties such as parameter name ("configuration key" in the Preferences object), label (short description), description, expected value type and optional value limits and relationships with other parameters. This allows the GUI to build and display the parameters in form of GUI components in command property dialogs and validate the values entered by users..
    
    Specified by:
    
    getVisualParameters in interface ExtendedParamsObject
    
    Returns:
    
    list of supported parameters in form of Preference instances.
  - setConfiguration
```
public void setConfiguration(UserConfiguration cfg)
```
    Description copied from interface: Configurable
    
    If an object implementing this interface is a plugin (i.e. implements also the Plugin interface) and is instantiated through a supported plugin factory, the Plugin Manager calls this method right after an instance of this object is created.
    
    Custom objects which do not already have their configuration parameters in the default configuration file should take advantage of this method to store their configuration into the shared User Configuration instance. It is recommended to call the UserConfiguration.saveConfiguration() method in the end to save the configuration to the hard drive.
    
    Objects wishing to be notified of changes of configuration parameters should implement the ConfigurationChangeListener interface and register with the UserConfiguration instance through the addConfigurationChangeListener() method.
    
    Specified by:
    
    setConfiguration in interface Configurable
    
    Parameters:
    
    cfg - global shared instance of user configuration preloaded with parameters from the default and user configuration files.
  - getPreferences
```
public List<Preference> getPreferences()
```
    Description copied from interface: Configurable
    
    Get metadata of displayable/editable configurable parameters. This method should declare a list of metadata for all configurable parameters which may be editable in the GUI. If the returned list is not null and contains at least one parameter, it gets picked up by the Preferences dialog which creates a panel with GUI components allowing to edit the declared configuration parameters.
    
    Specified by:
    
    getPreferences in interface Configurable
    
    Returns:
    
    a list of metadata for all public editable configuration parameters.
  - getShortDescription
```
public String getShortDescription()
```
    Description copied from interface: ExtendedParamsObject
    
    Get short description which describes in a few words purpose and role of the object. The text should be single line in plain text. This is optional and the method may return null. The short description is typically displayed by the GUI by the object name or ID.
    
    Specified by:
    
    getShortDescription in interface ExtendedParamsObject
    
    Returns:
    
    short object description.
  - getLongDescription
```
public String getLongDescription()
```
    Description copied from interface: ExtendedParamsObject
    
    Get long description of the object - purpose, usage, parameter syntax etc. The text may be multiline plain text or HTML with extended link syntax described in CustomHyperlinkListener. This is optional and the method may return null. The long description is typically displayed by the GUI when user selects to view details of the object.
    
    Specified by:
    
    getLongDescription in interface ExtendedParamsObject
    
    Returns:
    
    long object description.
  - setBaseImage
```
public void setBaseImage(Image img)
```
    Description copied from interface: ImageComparisonModule
    
    Set the base image.
    This is just a convenience method used by the 'Waitfor match' command to perform repeated image comparisons against one image.
    The default image comparison algorithm is based on color histograms. When you call this method, a histogram is calculated for the base image and cached for future repeated comparisons performed through the compareToBaseImage() method calls. As calculation of a color histograms is quite a time expensive operation, this approach allows to achieve higher performance.
    See the compareToBaseImage() method doc for more info.
    
    Specified by:
    
    setBaseImage in interface ImageComparisonModule
    
    Parameters:
    
    img - the base (component) image.
  - compare
```
public float compare(Image desktopImage,
                     Rectangle area,
                     Image image,
                     String methodParams,
                     ScriptingContext repository,
                     float passRate)
```
    Description copied from interface: ImageComparisonModule
    
    Compare the desktop image to another image and return a number indicating how much they match.
    
    Specified by:
    
    compare in interface ImageComparisonModule
    
    Parameters:
    
    desktopImage - desktop image.
    
    area - a rectangle area of the remote desktop to be used for image comparison. If the argument is null, the whole remote desktop image will be used.
    
    image - another image to be compared to the desktop image.
    
    methodParams - method parameters passed by the 'methodparams' parameter of the 'CompareTo' and 'Waitfor update' commands. You can use this to pass custom parameters from the script to this module.
    
    repository - a Map with execution context. Note that most of the objects contain there are not public and the parameter is specified here to allow compatibility among the custom and internal comparsion methods.
    
    passRate - pass rate in form of a float value between 0 and 1. This user input value indicates the lowest result which will be considered as match ("passed"). It is in fact the number specified by the 'passrate' parameter of the commands Screenshot, Compareto and Waitfor match/mismatch.
    
    Returns:
    
    a number between 0 and 1. While a value of 0 indicates 0% match (images do not match at all), 1 indicates a 100% match (images are equal).
  - getText
```
public Rectangle getText(StringBuilder out)
```
    Specified by:
    
    getText in interface TextRecognitionGUISupport
  - getHitDescription
```
public String getHitDescription(Rectangle r,
                                StringBuilder label)
```
    Description copied from interface: com.tplan.robot.gui.components.ComparisonModuleGuiSupport
    
    Get description of a particular match area. This is used by the Search Hits dialog which displays the text in a text field whenever the match is selected in the drop down. This is useful for example for OCR modules which wish to display the recognized text along with its rectangle.
    
    Modules which want to skip this functionality and made the description components invisible should make the method return null when the rectangle argument is null.
    
    Specified by:
    
    getHitDescription in interface com.tplan.robot.gui.components.ComparisonModuleGuiSupport
    
    Parameters:
    
    r - selected rectangle. The argument is null if no rectangle is selected. As this typically corresponds to the view of all matches the method should return a general text and/or label.
    
    label - optional label to display the text with.
    
    Returns:
    
    description of the match.
  - getAllFailedPixels
```
public Map<Rectangle,int[]> getAllFailedPixels()
```
    Specified by:
    
    getAllFailedPixels in interface ExtendedSearchCapabilities
  - usesPassRate
```
public boolean usesPassRate()
```
    Description copied from interface: AdvancedImageComparisonModule
    
    Indicate whether the module uses the pass rate as a parameter or not. This information is typically used by the GUI which disables or removes the password field.
    
    Specified by:
    
    usesPassRate in interface AdvancedImageComparisonModule
    
    Returns:
    
    true if the module allows to specify a pass rate, false if not.
  - getPassRateName
```
public String getPassRateName()
```
    Description copied from interface: AdvancedImageComparisonModule
    
    Get alternative name for the default "pass rate". This allows to update the GUI component label to be more descriptive, for example when the module calls the pass rate parameter in a different way such as "similarity", "comparison factor" or other.
    
    Specified by:
    
    getPassRateName in interface AdvancedImageComparisonModule
    
    Returns:
    
    alternative pass rate name; null defaults to "pass rate".
  - getDefaultPassRate
```
public float getDefaultPassRate()
```
    Description copied from interface: AdvancedImageComparisonModule
    
    Get the default pass rate value. It must be a float value between 0 and 1. This method gets called only if AdvancedImageComparisonModule.usesPassRate() returns true.
    
    Specified by:
    
    getDefaultPassRate in interface AdvancedImageComparisonModule
    
    Returns:
    
    default pass rate value;
  - getLineRects
```
public LinkedHashMap<Rectangle,String> getLineRects()
```
    Specified by:
    
    getLineRects in interface TextRecognitionGUISupport
  - getComparisonParams
```
public Map<String,Object> getComparisonParams()
```
    Specified by:
    
    getComparisonParams in interface TextRecognitionGUISupport
  - getMatches
```
public List<TextSearchResult> getMatches()
```
    Specified by:
    
    getMatches in interface TextRecognitionGUISupport
  - stop
```
public void stop()
```
    Description copied from interface: Stoppable
    
    Call this method to request the implementing object to stop the current task or activity.
    
    Specified by:
    
    stop in interface Stoppable
  - isStopped
```
public boolean isStopped()
```
    Description copied from interface: Stoppable
    
    Find out whether the task has been already stopped.
    
    Specified by:
    
    isStopped in interface Stoppable
    
    Returns:
    
    true if the task has been stopped, false otherwise. If the task hasn't been started yet, the method should return false.
  - getProgress
```
public float getProgress()
```
    Description copied from interface: Measurable
    
    Get the task progress where 0 means "0% done" and 1 means "100% done".
    
    Specified by:
    
    getProgress in interface Measurable
    
    Returns:
    
    a relative number between 0 and 1 indicating how much has been completed.
  - isSecondImageRequired
```
public boolean isSecondImageRequired()
```
    Description copied from interface: ImageComparisonModule
    
    Determine whether we are comparing two images or just analyze the desktop image.
    If this method returns true, commands CompareTo and WaitFor update of the scripting language will require presence of the 'template' parameter which specifies an image located in the filesystem to be compared to the current desktop.
    If you wish just to analyze the desktop image instead of comparing it to another one, implement this method to return false. The tool will not validate whether an image from the file system is passed correctly. Note that commands will supply null instead of an image in all arguments corresponding to the template image, i.e. expect method calls like compare(desktopImage, null) and setBaseImage(null).
    
    Specified by:
    
    isSecondImageRequired in interface ImageComparisonModule
    
    Returns:
    
    true for comparison mode, false for image analysis.
  - isMethodParamsSupported
```
public boolean isMethodParamsSupported()
```
    Description copied from interface: ImageComparisonModule
    
    Define whether this module supports some custom parameters which can be passed via the methodparams parameter of the scripting language.
    When this method returns false, the tool will report a syntax error when this module gets used in a command together with the methodparams parameter.
    When this method returns true, commands using this module may take advantage of the methodparams parameter to pass custom parameters which are not defined by the scripting language.
    The default image comparison algorithm doesn't provide any custom parameters.
    
    Specified by:
    
    isMethodParamsSupported in interface ImageComparisonModule
    
    Returns:
    
    true if the module supports customized parameters, false if not.
  - getCode
```
public String getCode()
```
    Description copied from interface: Plugin
    
    Get plugin code. This string serves as an identifier of the functionality delivered by the plugin. For example, desktop client plugins return protocol name like "RFB" or "RDP" as their code.
    
    Plugin code is used by pluggable instance factories to identify a particular plugin. It may be used to replace internal plugins with third party code. For example if you develop a class which implements this and the com.tplan.robot.remoteclient.RemoteDesktop interfaces and the getCode() method returns "RFB", it will replace the internal implementation of the RFB (VNC) client.
    
    Specified by:
    
    getCode in interface Plugin
    
    Returns:
    
    plugin code (identifier). The name must not be null.
  - getMethodName
```
public String getMethodName()
```
    Description copied from interface: ImageComparisonModule
    
    Get the method name. It will be used as an identificator of the image comparison module in commands of the scripting language (parameter module of the 'CompareTo' and 'Waitfor update' commands) and in default comparison method configuration (user config parameter CompareToCommand.defaultComparisonModule).
    Method names are not case sensitive. Be sure not to specify a name which is reserved by the tool or already used by another method. Version 1.3 reserves two names, 'default' and search. You can't override these names.
    
    Specified by:
    
    getMethodName in interface ImageComparisonModule
    
    Returns:
    
    name of the module (image comparison method).
  - getVendorName
```
public String getVendorName()
```
    Description copied from interface: Plugin
    
    Get vendor (provider) name to be displayed in the GUI.
    
    Specified by:
    
    getVendorName in interface Plugin
    
    Returns:
    
    vendor name. May be null.
  - getSupportContact
```
public String getSupportContact()
```
    Description copied from interface: Plugin
    
    Get support contact. If the contact is a valid mail link like "mailto:<mailaddress>" or an HTTP link like "http://<link>", the application may follow it with appropriate program (mail client or web browser).
    
    Specified by:
    
    getSupportContact in interface Plugin
    
    Returns:
    
    support contact. May be null or a text to be displayed by the GUI or a valid URI.
  - getVersion
```
public int[] getVersion()
```
    Description copied from interface: Plugin
    
    Get plugin version in form of an integer array. Major version numbers are first. For example, version 1.2.3 should be represented as new int[] { 1, 2, 3 }.
    
    Specified by:
    
    getVersion in interface Plugin
    
    Returns:
    
    version number.
  - getImplementedInterface
```
public Class getImplementedInterface()
```
    Description copied from interface: Plugin
    
    Get Class of the exposed functional interface that this plugin implements. For example remote desktop clients return com.tplan.robot.remoteclient.RemoteDesktopClient.class.
    
    Specified by:
    
    getImplementedInterface in interface Plugin
    
    Returns:
    
    class instance of the implemented functional interface.
  - requiresRestart
```
public boolean requiresRestart()
```
    Description copied from interface: Plugin
    
    Indicate whether installation of this plugin requires application restart. If it returns true, users are asked to restart after plugin installation via GUI.
    
    Specified by:
    
    requiresRestart in interface Plugin
    
    Returns:
    
    true if installation of the plugin requires application restart, false otherwise.
  - getVendorHomePage
```
public String getVendorHomePage()
```
    Description copied from interface: Plugin
    
    Get the vendor home page. If the contact is a valid HTTP link like "http://<link>", the application may follow it with appropriate program (typically web browser).
    
    Specified by:
    
    getVendorHomePage in interface Plugin
    
    Returns:
    
    vendor home page URL.
  - getDate
```
public Date getDate()
```
    Description copied from interface: Plugin
    
    Get plugin release date.
    
    Specified by:
    
    getDate in interface Plugin
    
    Returns:
    
    plugin release date.
  - getLowestSupportedVersion
```
public int[] getLowestSupportedVersion()
```
    Description copied from interface: Plugin
    
    Get the lowest required version of T-Plan Robot Enterprise. If user attempts to install the plugin on a lower version, an error is reported.
    
    Specified by:
    
    getLowestSupportedVersion in interface Plugin
    
    Returns:
    
    the lowest T-Plan Robot Enterprise version supported by this plugin.
  - getMessageBeforeInstall
```
public String getMessageBeforeInstall()
```
    Description copied from interface: Plugin
    
    Get text of a message to be displayed before installation of this plugin. It may contain any relevant user information.
    
    Specified by:
    
    getMessageBeforeInstall in interface Plugin
    
    Returns:
    
    message to be displayed before installation.
  - getMessageAfterInstall
```
public String getMessageAfterInstall()
```
    Description copied from interface: Plugin
    
    Get text of a message to be displayed after installation of this plugin. It may contain any relevant user information.
    
    Specified by:
    
    getMessageAfterInstall in interface Plugin
    
    Returns:
    
    message to be displayed after installation.
  - checkDependencies
```
public void checkDependencies(PluginManager manager)
                       throws DependencyMissingException
```
    Description copied from interface: Plugin
    
    Check whether the current product installation contains all dependencies (other plugins) required to install this plugin. This method is called before the plugin is installed and it should throw a DependencyMissingException if one or more dependencies are missing.
    
    Specified by:
    
    checkDependencies in interface Plugin
    
    Parameters:
    
    manager - shared instance of the plugin manager.
    
    Throws:
    
    DependencyMissingException - when one or more dependencies requested by this plugin is missing.
  - imageUpdate
```
public boolean imageUpdate(Image img,
                           int infoflags,
                           int x,
                           int y,
                           int width,
                           int height)
```
    Dummy method implementing the ImageObserver interface.
    
    Specified by:
    
    imageUpdate in interface ImageObserver
    
    Returns:
    
    always returns true.
  - getFailedPixels
```
public List<Point> getFailedPixels()
```
  - setTrackingOfFailedPixelsEnabled
```
public void setTrackingOfFailedPixelsEnabled(boolean enabled)
```
    Specified by:
    
    setTrackingOfFailedPixelsEnabled in interface ExtendedSearchCapabilities
  - isTrackingOfFailedPixelsSupported
```
public boolean isTrackingOfFailedPixelsSupported()
```
    Specified by:
    
    isTrackingOfFailedPixelsSupported in interface ExtendedSearchCapabilities
  - getRectangle
```
public Rectangle getRectangle()
```
    Specified by:
    
    getRectangle in interface ExtendedSearchCapabilities
  - getHits
```
public List<Rectangle> getHits()
```
    Specified by:
    
    getHits in interface ExtendedSearchCapabilities
  - getPreviewComponent
```
public Component getPreviewComponent(Window owner,
                                     File selectedFile,
                                     StringBuilder title)
```
    Description copied from interface: com.tplan.robot.gui.components.ComparisonModuleGuiSupport
    
    Get the preview component. This allows to customize the template and/or template collection thumbnail preview.
    
    Specified by:
    
    getPreviewComponent in interface com.tplan.robot.gui.components.ComparisonModuleGuiSupport
    
    Parameters:
    
    owner - the owning window.
    
    selectedFile - the selected template image file.
    
    title - optional output buffer for the preview title.
    
    Returns:
    
    the custom preview component.
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object
  - getResultMessage
```
public String getResultMessage(boolean useHtml,
                               StringBuilder title,
                               StringBuilder buttonLabel)
```
    Description copied from interface: com.tplan.robot.gui.components.ComparisonModuleGuiSupport
    
    Get the message describing results of the last performed image comparison.
    
    Specified by:
    
    getResultMessage in interface com.tplan.robot.gui.components.ComparisonModuleGuiSupport
    
    Parameters:
    
    useHtml - true should return the message in HTML, false in plain text.
    
    title - a buffer for the optional custom message title.
    
    buttonLabel - label (name) for the button in the intended pop up. The message mentions it.
    
    Returns:
    
    the message.

Class GoogleVisionOCR

Nested Class Summary

Nested classes/interfaces inherited from interface com.tplan.robot.imagecomparison.tesseractocr.OCRConstants

Field Summary

Fields inherited from interface com.tplan.robot.imagecomparison.ImageComparisonModule

Fields inherited from interface java.awt.image.ImageObserver

Fields inherited from interface com.tplan.robot.gui.components.ComparisonModuleGuiSupport

Fields inherited from interface com.tplan.robot.imagecomparison.tesseractocr.OCRConstants

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface com.tplan.robot.imagecomparison.ImageComparisonModule

Methods inherited from interface java.awt.image.ImageObserver

Methods inherited from interface com.tplan.robot.imagecomparison.ExtendedSearchCapabilities

Methods inherited from interface com.tplan.robot.gui.components.ComparisonModuleGuiSupport

Methods inherited from interface com.tplan.robot.imagecomparison.AdvancedImageComparisonModule

Methods inherited from interface com.tplan.robot.imagecomparison.TextRecognitionGUISupport

Methods inherited from interface com.tplan.robot.util.Stoppable

Methods inherited from interface com.tplan.robot.util.Measurable

Methods inherited from interface com.tplan.robot.plugin.Plugin

Constructor Detail

GoogleVisionOCR

Method Detail

compareToBaseImage

getMethodDescription

getDisplayName

getDisplayNameKey

getDescription

getUniqueId

getParameters

getParameterValues

setParameters

getVisualParameters

setConfiguration

getPreferences

getShortDescription

getLongDescription

setBaseImage

compare

getText

getHitDescription

getAllFailedPixels

usesPassRate

getPassRateName

getDefaultPassRate

getLineRects

getComparisonParams

getMatches

stop

isStopped

getProgress

isSecondImageRequired

isMethodParamsSupported

getCode

getMethodName

getVendorName

getSupportContact

getVersion

getImplementedInterface

requiresRestart

getVendorHomePage

getDate

getLowestSupportedVersion

getMessageBeforeInstall

getMessageAfterInstall

checkDependencies

imageUpdate

getFailedPixels

setTrackingOfFailedPixelsEnabled

isTrackingOfFailedPixelsSupported

getRectangle

getHits

getPreviewComponent

toString

getResultMessage