The Optical Character Recognition feature provided by the OCR plugin is deprecated. It was removed from TestComplete in version 12.60 and is no longer available for later versions. Instead, TestComplete version 12.60 introduces the new Optical Character Recognition engine featuring Google Cloud Vision API. To learn more, see Optical Character Recognition. If you need to use the legacy feature, please contact our Customer Care team. |
Description
The OCROptions.SkipFragmentation
property lets you specify whether to reject fragmentation of an onscreen object's image during character recognition. To learn more about image fragmentation and its usage during character recognition in TestComplete, see Optical Character Recognition.
Declaration
OCROptionsObj.SkipFragmentation
Read-Write Property | Boolean |
OCROptionsObj | An expression, variable or parameter that specifies a reference to an OCROptions object |
Applies To
The property is applied to the following object:
Property Value
True if the image fragmentation is not used. False if the image fragmentation is used.
Example
The following example obtains an image of the Notepad window and recognizes the text without using the fragmentation. After that, it posts the recognized text to the test log.
JavaScript, JScript
{
var notepad, Window, Rect, OCRObj, OCROptions;
// Obtains the Notepad window
notepad = Sys.Process("notepad");
Window = notepad.Window("Notepad", "*").Window("Edit");
// Captures an image of the Notepad window
Rect = Window.Picture();
Log.Picture(Rect, "Region with the text to be recognized");
// Creates an OCR object
OCRObj = OCR.CreateObject(Rect);
// Creates an OCROptions object
OCROptions = OCRObj.CreateOptions();
// Specifies that the fragmentation of the image will not be used
OCROptions.SkipFragmentation = true;
// Recognizes the text and posts it to the test log
Log.Message("Recognized text:", OCRObj.GetText(OCROptions));
}
Python
def OCROptionsSample():
# Obtains the Notepad window
notepad = Sys.Process("notepad")
Window = notepad.Window("Notepad", "*").Window("Edit")
# Captures an image of the Notepad window
Rect = Window.Picture()
Log.Picture(Rect, "Region with the text to be recognized")
# Creates an OCR object
OCRObj = OCR.CreateObject(Rect)
# Creates an OCROptions object
OCROptions = OCRObj.CreateOptions()
# Specifies that the fragmentation of the image will not be used
OCROptions.SkipFragmentation = True
# Recognizes the text and posts it to the test log
Log.Message("Recognized text:", OCRObj.GetText(OCROptions))
VBScript
' Obtains the Notepad window
Set notepad = Sys.Process("notepad")
Set Window = notepad.Window("Notepad", "*").Window("Edit")
' Captures an image of the Notepad window
Set Rect = Window.Picture
Call Log.Picture(Rect, "Region with the text to be recognized")
' Creates an OCR object
Set OCRObj = OCR.CreateObject(Rect)
' Creates an OCROptions object
Set OCROptions = OCRObj.CreateOptions
' Specifies that the fragmentation of the image will not be used
OCROptions.SkipFragmentation = True
' Recognizes the text and posts it to the test log
Call Log.Message("Recognized text:", OCRObj.GetText(OCROptions))
End Sub
DelphiScript
var notepad, Window, Rect, OCRObj, OCROptions : OleVariant;
begin
// Obtains the Notepad window
notepad := Sys.Process('notepad');
Window := notepad.Window('Notepad', '*').Window('Edit');
// Captures an image of the Notepad window
Rect := Window.Picture;
Log.Picture(Rect, 'Region with the text to be recognized');
// Creates an OCR object
OCRObj := OCR.CreateObject(Rect);
// Creates an OCROptions object
OCROptions := OCRObj.CreateOptions;
// Specifies that the fragmentation of the image will not be used
OCROptions.SkipFragmentation := true;
// Recognizes the text and posts it to the test log
Log.Message('Recognized text:', OCRObj.GetText(OCROptions));
end;
C++Script, C#Script
{
var notepad, Window, Rect, OCRObj, OCROptions;
// Obtains the Notepad window
notepad = Sys["Process"]("notepad");
Window = notepad["Window"]("Notepad", "*")["Window"]("Edit");
// Captures an image of the Notepad window
Rect = Window["Picture"]();
Log["Picture"](Rect, "Region with the text to be recognized");
// Creates an OCR object
OCRObj = OCR["CreateObject"](Rect);
// Creates an OCROptions object
OCROptions = OCRObj["CreateOptions"]();
// Specifies that the fragmentation of the image will not be used
OCROptions["SkipFragmentation"] = true;
// Recognizes the text and posts it to the test log
Log["Message"]("Recognized text:", OCRObj["GetText"](OCROptions));
}
See Also
Optical Character Recognition
Using Optical Character Recognition - Tips