General
Below is a description of the OCRMaxsettings found under the General tab of the OCRMax Property Sheet.
Parameter | Description | ||||||||||||||||||
Image |
This parameter must reference a spreadsheet cell that contains an Image data structure; by default, this parameter references A0, the cell containing the AcquireImage data structure. This parameter can also reference other Image data structures, such as those returned by the Image Vision Data Access Functions or Coordinate Transforms Functions. |
||||||||||||||||||
Fixture |
Defines the Region of Interest (ROI) relative to a Fixture input or the output of a Vision Tools function's image coordinate system. Setting the ROI relative to a Fixture ensures that if the Fixture is rotated or translated, the ROI will be rotated or translated in relation to the Fixture. The default setting is (0,0,0), the top leftmost corner of the image.
|
||||||||||||||||||
Region |
Also known as the Region of Interest (ROI), specifies the region of the image that undergoes analysis; creates an Interactive Graphics Mode that can be transformed and rotated. With this parameter selected, by pressing the Maximize Region button on the property sheet's Job Edit toolbar, the region will automatically be stretched to cover the entire image. The X-axis of the ROI should be parallel to the baseline of the text, and the Y-axis should be parallel to the vertical strokes of the characters; if there is no skew, the Y-axis is perpendicular to the X-axis. The positive direction of the X-axis corresponds to the reading direction. Note: The baseline of the text may have any angle (0-360) in the image, as long as the ROI is oriented at approximately the same angle.
The ROI should only contain one line of text to be read, and some surrounding background. The background can be noisy and have significant background gradients/shading. In images with text that are clearly printed and have little noise, the ROI may be significantly larger than the line of text. For noisy images, the ROI should be relatively tight around the line of text. Note: The ROI should not contain any other significant features in the image, other than the line of text. For example, the ROI should not partially enclose a different line of nearby text, or the edge of a label.
As an approximate rule of thumb, the ROI should be larger than the line of text by at least half a character width on all sides, if possible (i.e. unless a border that large would cause other features to be enclosed within the ROI).
|
||||||||||||||||||
Font |
Optionally, specifies a cell reference to a data structure output by another OCRMax function, containing a trained font. Note: If a reference is set, and the trained characters are edited in the function referencing the trained font, the changes to the trained characters will not be undone by Undo Graphic Change under the Edit menu or the Undo button on the standard toolbar.
|
||||||||||||||||||
External Settings |
Optionally, specifies a cell reference to a data structure output by an OCRMaxSettings or GetInternalSettings function from OCRMax Vision Data Access Functions. If the Export to Cell option has been utilized, this parameter will automatically be set as an absolute cell reference to the newly created OCRMaxSettings function's Settings data structure. Note:
|
||||||||||||||||||
Train Mode |
Specifies the font training behavior.
|
||||||||||||||||||
Train String |
Specifies the text string to be trained. Note: The OCRMax function only supports training ASCII characters.
|
||||||||||||||||||
Train Font |
Specifies the event on which to train the characters, based on the Train Mode parameter setting. |
||||||||||||||||||
Clear Font |
Specifies an event on which all of the characters in the font will be removed. Note: The Train Font and Clear Font parameters can reference the same event, which will initiate the removal of all the characters in the font, and retraining based on the current characters within the ROI.
|
||||||||||||||||||
Inspection Mode |
Specifies the inspection mode of the function during run-time.
|
||||||||||||||||||
Match String |
Specifies the text string that must be correctly matched when in Read/Verify Inspection Mode. Note: This parameter is only available when the Inspection Mode parameter is set to Read/Verify.
|
||||||||||||||||||
Field String |
Specifies the number of characters contained in the character string. Fielding is used to provide information about what characters are expected at different positions in the string. Note: This parameter is only available when the Inspection Mode parameter is set to Read.
|
||||||||||||||||||
Field Definitions |
Optionally, the Field Definitions setting can be used to create user-defined entries for the Field String. When included in the Field String, these entries restrict the list of valid characters at the positions in which they are inserted. Use the controls in the Fielding tab to construct the Field String and Field Definitions (if necessary). Note: This parameter is only available when the Inspection Mode parameter is set to Read.
|
||||||||||||||||||
Spaces |
Specifies how the function will account for spaces between characters, if necessary. The OCRMax function processes inter-character gaps by classifying them as space characters, and these are user-defined.
|
||||||||||||||||||
Accept Threshold |
Specifies the minimum acceptable match score (0 to 100; default = 80) for each character. Any character with a match score below the Accept Thresh will fail. |
||||||||||||||||||
Confusion Threshold |
Specifies the minimum difference required between the match scores of the highest scoring character and the second highest scoring character (0 to 40; default = 0). |
||||||||||||||||||
Use Subsampling |
A checkbox which specifies whether or not to enable image subsampling, which decreases character resolution to increase the reading speed of the function.
|
||||||||||||||||||
Timeout |
Specifies the amount of time, in milliseconds (0 to 30000; default = 5000), that the function will search for characters before execution is halted and an #ERR is returned. Setting the value to 0 will disable the setting and a timeout will not be applied. |
||||||||||||||||||
Output Image Graphic |
Specifies the type of output image that should be displayed.
|
||||||||||||||||||
Character Label Position |
Specifies where to display each character's label in relation to the character region.
Note: At this point, only the default Above Character Label Position is active. Other options will become available in a future release.
|
||||||||||||||||||
Show Diagnostics |
Specifies which type of graphical diagnostic data to display on the image.
|
||||||||||||||||||
Curved Region Position |
Specifies the X and Y coordinates for where the straightened Region will be placed in the image, when a curved Region is used. Note: This parameter is only enabled if the Region parameter Curve value is greater than 0.
|
||||||||||||||||||
Reset |
Specifies that the Segmentation tab parameters will be reset to their default settings, clear font information and remove any Auto-Tune record (.rec) files associated with the function. Note: This button is disabled if the External Settings parameter is set as a reference to a GetInternalSettings function fromOCRMax Vision Data Access Functions or OCRMaxSettings function.
|
||||||||||||||||||
Show |
Specifies which OCRMax graphics overlay the image.
|