This object is provided by the legacy OCR plugin. In version 12.60, the plugin was replaced with the new Optical Character Recognition plugin powered by Google Cloud Vision API. To learn more, see Optical Character Recognition. The legacy OCR plugin was removed from TestComplete in version 12.60. If you need to use objects, methods, and properties provided by the legacy plugin with this version of TestComplete, please contact our Customer Care team. The legacy OCR plugin was restored in TestComplete version 14.0. To use the objects, methods, and properties with this or later TestComplete version, you need to install and enable the plugin manually. |
Description
The OCR
object provides a program interface to optical character recognition in your scripts. This is a top-level object that is available if the OCR plugin is installed.
Members
Example
The following example captures an image of the Windows Notepad window and uses it to create a new OCRObject
. After that, it recognizes the characters written in Notepad and posts them to the test log.
JavaScript, JScript
function OCROptionsSample()
{
var notepad, Window, Rect, OCRObj, s, X, Y;
// Obtain the Notepad window
notepad = Sys.Process("notepad");
Window = notepad.Window("Notepad", "*").Window("Edit");
// Capture an image of the Notepad window and post it to the test log
Rect = Window.Picture();
Log.Picture(Rect, "Region with the text to be recognized");
// Create an OCR object
OCRObj = OCR.CreateObject(Rect);
// Recognize the text
s = OCRObj.GetText();
// Post the recorgnized text to the test log
Log.Message("See the recognized text in the Details panel.", s);
}
{
var notepad, Window, Rect, OCRObj, s, X, Y;
// Obtain the Notepad window
notepad = Sys.Process("notepad");
Window = notepad.Window("Notepad", "*").Window("Edit");
// Capture an image of the Notepad window and post it to the test log
Rect = Window.Picture();
Log.Picture(Rect, "Region with the text to be recognized");
// Create an OCR object
OCRObj = OCR.CreateObject(Rect);
// Recognize the text
s = OCRObj.GetText();
// Post the recorgnized text to the test log
Log.Message("See the recognized text in the Details panel.", s);
}
Python
def OCROptionsSample():
# Obtain the Notepad window
notepad = Sys.Process("notepad")
Window = notepad.Window("Notepad", "*").Window("Edit")
# Capture an image of the Notepad window and post it to the test log
Rect = Window.Picture()
Log.Picture(Rect, "Region with the text to be recognized")
# Create an OCR object
OCRObj = OCR.CreateObject(Rect)
# Recognize the text
s = OCRObj.GetText()
# Post the recorgnized text to the test log
Log.Message("See the recognized text in the Details panel.", s)
VBScript
Sub OCROptionsSample
' Obtain the Notepad window
Set notepad = Sys.Process("notepad")
Set Window = notepad.Window("Notepad", "*").Window("Edit")
' Capture an image of the Notepad window and post it to the test log
Set Rect = Window.Picture
Call Log.Picture(Rect, "Region with the text to be recognized")
' Create an OCR object
Set OCRObj = OCR.CreateObject(Rect)
' Recognize the text
s = OCRObj.GetText()
' Post the recorgnized text to the test log
Call Log.Message("See the recognized text in the Details panel.", s)
End Sub
' Obtain the Notepad window
Set notepad = Sys.Process("notepad")
Set Window = notepad.Window("Notepad", "*").Window("Edit")
' Capture an image of the Notepad window and post it to the test log
Set Rect = Window.Picture
Call Log.Picture(Rect, "Region with the text to be recognized")
' Create an OCR object
Set OCRObj = OCR.CreateObject(Rect)
' Recognize the text
s = OCRObj.GetText()
' Post the recorgnized text to the test log
Call Log.Message("See the recognized text in the Details panel.", s)
End Sub
DelphiScript
procedure OCROptionsSample();
var notepad, Window, Rect, OCRObj, s, X, Y: OleVariant;
begin
// Obtain the Notepad window
notepad := Sys.Process('notepad');
Window := notepad.Window('Notepad', '*').Window('Edit');
// Capture an image of the Notepad window and post it to the test log
Rect := Window.Picture();
Log.Picture(Rect, 'Region with the text to be recognized');
// Create an OCR object
OCRObj := OCR.CreateObject(Rect);
// Recognize the text
s := OCRObj.GetText();
// Post the recorgnized text to the test log
Log.Message('See the recognized text in the Details panel.', s);
end;
var notepad, Window, Rect, OCRObj, s, X, Y: OleVariant;
begin
// Obtain the Notepad window
notepad := Sys.Process('notepad');
Window := notepad.Window('Notepad', '*').Window('Edit');
// Capture an image of the Notepad window and post it to the test log
Rect := Window.Picture();
Log.Picture(Rect, 'Region with the text to be recognized');
// Create an OCR object
OCRObj := OCR.CreateObject(Rect);
// Recognize the text
s := OCRObj.GetText();
// Post the recorgnized text to the test log
Log.Message('See the recognized text in the Details panel.', s);
end;
C++Script, C#Script
function OCROptionsSample()
{
var notepad, Window, Rect, OCRObj, s, X, Y;
// Obtain the Notepad window
notepad = Sys["Process"]("notepad");
Window = notepad["Window"]("Notepad", "*")["Window"]("Edit");
// Capture an image of the Notepad window and post it to the test log
Rect = Window["Picture"]();
Log["Picture"](Rect, "Region with the text to be recognized");
// Create an OCR object
OCRObj = OCR["CreateObject"](Rect);
// Recognize the text
s = OCRObj["GetText"]();
// Post the recorgnized text to the test log
Log["Message"]("See the recognized text in the Details panel.", s);
}
{
var notepad, Window, Rect, OCRObj, s, X, Y;
// Obtain the Notepad window
notepad = Sys["Process"]("notepad");
Window = notepad["Window"]("Notepad", "*")["Window"]("Edit");
// Capture an image of the Notepad window and post it to the test log
Rect = Window["Picture"]();
Log["Picture"](Rect, "Region with the text to be recognized");
// Create an OCR object
OCRObj = OCR["CreateObject"](Rect);
// Recognize the text
s = OCRObj["GetText"]();
// Post the recorgnized text to the test log
Log["Message"]("See the recognized text in the Details panel.", s);
}
See Also
Optical Character Recognition
Using Optical Character Recognition - Tips