eVision Python API
Loading...
Searching...
No Matches
eVision.EOCV Class Reference

Manages a complete context for the optical character verification tool implemented in EasyOCV. More...

Public Member Functions

None __init__ (self)
 Constructs an OCV context.
None Dump (self)
None ComputeDefaultTolerances (self, eVision.EROIBW8|None roi, int threshold)
 Computes or recomputes the default tolerances of the quality indicators currently in use for all characters of all texts from the given ROI and threshold.
None ComputeDefaultTolerances (self, eVision.EROIBW8|None roi)
 Computes or recomputes the default tolerances of the quality indicators currently in use for all characters of all texts from the given ROI and threshold.
None Save (self, str path)
 Saves the eVision.EOCV.
None Save (self, eVision.ESerializer|None serializer)
 Saves the eVision.EOCV.
None Load (self, str path)
 Loads the eVision.EOCV.
None Load (self, eVision.ESerializer|None serializer)
 Loads the eVision.EOCV.
bool AreAllFreeObjectsSelected (self)
None DrawTemplateObjects (self, eVision.EDrawAdapter|None graphicContext, eVision.ESelectionFlag objectsSelectionFlag, float zoomX, float zoomY, float originX, float originY)
 Draws the free objects as blobs.
None DrawTemplateObjects (self, eVision.EDrawAdapter|None graphicContext, eVision.ESelectionFlag objectsSelectionFlag, float zoomX, float zoomY, float originX)
 Draws the free objects as blobs.
None DrawTemplateObjects (self, eVision.EDrawAdapter|None graphicContext, eVision.ESelectionFlag objectsSelectionFlag, float zoomX, float zoomY)
 Draws the free objects as blobs.
None DrawTemplateObjects (self, eVision.EDrawAdapter|None graphicContext, eVision.ESelectionFlag objectsSelectionFlag, float zoomX)
 Draws the free objects as blobs.
None DrawTemplateObjects (self, eVision.EDrawAdapter|None graphicContext, eVision.ESelectionFlag objectsSelectionFlag)
 Draws the free objects as blobs.
None DrawTemplateObjects (self, eVision.EDrawAdapter|None graphicContext)
 Draws the free objects as blobs.
eVision.EOCVChar GetFreeChar (self, int index)
 Gets an individual free character of the OCV context.
None SetFreeChar (self, int index, eVision.EOCVChar freeChar)
 Sets an individual free character of the OCV context.
None DrawTemplateChars (self, eVision.EDrawAdapter|None graphicContext, eVision.ESelectionFlag charsSelectionFlag, float zoomX, float zoomY, float originX, float originY)
 Draws the free characters as bounding rectangles.
None DrawTemplateChars (self, eVision.EDrawAdapter|None graphicContext, eVision.ESelectionFlag charsSelectionFlag, float zoomX, float zoomY, float originX)
 Draws the free characters as bounding rectangles.
None DrawTemplateChars (self, eVision.EDrawAdapter|None graphicContext, eVision.ESelectionFlag charsSelectionFlag, float zoomX, float zoomY)
 Draws the free characters as bounding rectangles.
None DrawTemplateChars (self, eVision.EDrawAdapter|None graphicContext, eVision.ESelectionFlag charsSelectionFlag, float zoomX)
 Draws the free characters as bounding rectangles.
None DrawTemplateChars (self, eVision.EDrawAdapter|None graphicContext, eVision.ESelectionFlag charsSelectionFlag)
 Draws the free characters as bounding rectangles.
None DrawTemplateChars (self, eVision.EDrawAdapter|None graphicContext)
 Draws the free characters as bounding rectangles.
eVision.EOCVText GetText (self, int index)
 Returns an individual text of the OCV context.
None SetText (self, int index, eVision.EOCVText text)
 Modifies the individual text at the given index by the given value.
None DrawTemplateTexts (self, eVision.EDrawAdapter|None graphicContext, eVision.ESelectionFlag textsSelectionFlag, float zoomX, float zoomY, float originX, float originY)
 Draws the texts as bounding rectangles.
None DrawTemplateTexts (self, eVision.EDrawAdapter|None graphicContext, eVision.ESelectionFlag textsSelectionFlag, float zoomX, float zoomY, float originX)
 Draws the texts as bounding rectangles.
None DrawTemplateTexts (self, eVision.EDrawAdapter|None graphicContext, eVision.ESelectionFlag textsSelectionFlag, float zoomX, float zoomY)
 Draws the texts as bounding rectangles.
None DrawTemplateTexts (self, eVision.EDrawAdapter|None graphicContext, eVision.ESelectionFlag textsSelectionFlag, float zoomX)
 Draws the texts as bounding rectangles.
None DrawTemplateTexts (self, eVision.EDrawAdapter|None graphicContext, eVision.ESelectionFlag textsSelectionFlag)
 Draws the texts as bounding rectangles.
None DrawTemplateTexts (self, eVision.EDrawAdapter|None graphicContext)
 Draws the texts as bounding rectangles.
None DrawTemplateTextsChars (self, eVision.EDrawAdapter|None graphicContext, eVision.ESelectionFlag textsSelectionFlag, eVision.ESelectionFlag charsSelectionFlag, float zoomX, float zoomY, float originX, float originY)
 Draws the characters of the texts as bounding rectangles.
None DrawTemplateTextsChars (self, eVision.EDrawAdapter|None graphicContext, eVision.ESelectionFlag textsSelectionFlag, eVision.ESelectionFlag charsSelectionFlag, float zoomX, float zoomY, float originX)
 Draws the characters of the texts as bounding rectangles.
None DrawTemplateTextsChars (self, eVision.EDrawAdapter|None graphicContext, eVision.ESelectionFlag textsSelectionFlag, eVision.ESelectionFlag charsSelectionFlag, float zoomX, float zoomY)
 Draws the characters of the texts as bounding rectangles.
None DrawTemplateTextsChars (self, eVision.EDrawAdapter|None graphicContext, eVision.ESelectionFlag textsSelectionFlag, eVision.ESelectionFlag charsSelectionFlag, float zoomX)
 Draws the characters of the texts as bounding rectangles.
None DrawTemplateTextsChars (self, eVision.EDrawAdapter|None graphicContext, eVision.ESelectionFlag textsSelectionFlag, eVision.ESelectionFlag charsSelectionFlag)
 Draws the characters of the texts as bounding rectangles.
None DrawTemplateTextsChars (self, eVision.EDrawAdapter|None graphicContext, eVision.ESelectionFlag textsSelectionFlag)
 Draws the characters of the texts as bounding rectangles.
None DrawTemplateTextsChars (self, eVision.EDrawAdapter|None graphicContext)
 Draws the characters of the texts as bounding rectangles.
None SetTemplateImage2 (self, eVision.EROIBW8|None templateImage, eVision.EROIBW8|None objectsImage)
None SelectTemplateObjects (self, int originX, int originY, int width, int height, eVision.ESelectionFlag objectsSelectionFlag)
 Toggles selection of the objects whose bounding box intersects a given rectangle.
None SelectTemplateObjects (self, int originX, int originY, int width, int height)
 Toggles selection of the objects whose bounding box intersects a given rectangle.
None DeleteTemplateObjects (self, eVision.ESelectionFlag objectsSelectionFlag)
 Removes free objects from the OCV context.
None DeleteTemplateObjects (self)
 Removes free objects from the OCV context.
None CreateTemplateChars (self, eVision.ESelectionFlag objectsSelectionFlag, eVision.ECharCreationMode creationMode)
 Adds to the OCV context the characters formed from the list of free objects.
None CreateTemplateChars (self, eVision.ESelectionFlag objectsSelectionFlag)
 Adds to the OCV context the characters formed from the list of free objects.
None CreateTemplateChars (self)
 Adds to the OCV context the characters formed from the list of free objects.
None SelectTemplateChars (self, int originX, int originY, int width, int height, eVision.ESelectionFlag charsSelectionFlag)
 Toggles selection of the free characters whose bounding box intersects a given rectangle.
None SelectTemplateChars (self, int originX, int originY, int width, int height)
 Toggles selection of the free characters whose bounding box intersects a given rectangle.
None DeleteTemplateChars (self, eVision.ESelectionFlag charsSelectionFlag)
 Removes free characters from the OCV context.
None DeleteTemplateChars (self)
 Removes free characters from the OCV context.
None CreateTemplateTexts (self, eVision.ESelectionFlag charsSelectionFlag)
 Adds to the OCV context a piece of text formed from the list of free characters.
None CreateTemplateTexts (self)
 Adds to the OCV context a piece of text formed from the list of free characters.
None SelectTemplateTexts (self, int originX, int originY, int width, int height, eVision.ESelectionFlag textsSelectionFlag)
 Toggles selection of the template texts whose bounding box intersects a given rectangle.
None SelectTemplateTexts (self, int originX, int originY, int width, int height)
 Toggles selection of the template texts whose bounding box intersects a given rectangle.
None DeleteTemplateTexts (self, eVision.ESelectionFlag textsSelectionFlag)
 Removes template texts from the OCV context.
None DeleteTemplateTexts (self)
 Removes template texts from the OCV context.
None SelectSampleTexts (self, int originX, int originY, int width, int height, eVision.ESelectionFlag textsSelectionFlag)
 Toggles selection of the template texts whose bounding box intersects a given rectangle.
None SelectSampleTexts (self, int originX, int originY, int width, int height)
 Toggles selection of the template texts whose bounding box intersects a given rectangle.
None SelectSampleTextsChars (self, int originX, int originY, int width, int height, eVision.ESelectionFlag textsSelectionFlag, eVision.ESelectionFlag charsSelectionFlag)
 Toggles selection of the template text characters whose bounding box intersects a given rectangle.
None SelectSampleTextsChars (self, int originX, int originY, int width, int height, eVision.ESelectionFlag textsSelectionFlag)
 Toggles selection of the template text characters whose bounding box intersects a given rectangle.
None SelectSampleTextsChars (self, int originX, int originY, int width, int height)
 Toggles selection of the template text characters whose bounding box intersects a given rectangle.
None Learn (self, eVision.EROIBW8|None image, eVision.ESelectionFlag textsSelectionFlag, eVision.ESelectionFlag charsSelectionFlag)
 Pre-processes the model so that all required internal data structures are set up.
None Learn (self, eVision.EROIBW8|None image, eVision.ESelectionFlag textsSelectionFlag)
 Pre-processes the model so that all required internal data structures are set up.
None Learn (self, eVision.EROIBW8|None image)
 Pre-processes the model so that all required internal data structures are set up.
None GetTextParameters (self, eVision.EOCVText Text, int textIndex)
 Copies the parameters from the text of given index to the temporary text.
None SetTextParameters (self, eVision.EOCVText Text, int textIndex)
 Copies the desired parameters from the temporary text to the text of given index.
None GatherTextsParameters (self, eVision.EOCVText Text, eVision.ESelectionFlag textsSelectionFlag)
 Copies the parameters from the texts specified by the selection mode to the temporary text.
None ScatterTextsParameters (self, eVision.EOCVText Text, eVision.ESelectionFlag textsSelectionFlag)
 Copies the desired parameters from the temporary text to the texts specified by the selection mode.
int GetNumTextChars (self, int index)
 Returns the number of characters in this OCV context.
None GetTextCharParameters (self, eVision.EOCVChar ocvChar, int textIndex, int charIndex)
 Copies the parameters from the character of given index to the temporary character.
None SetTextCharParameters (self, eVision.EOCVChar ocvChar, int textIndex, int charIndex)
 Copies the desired parameters from the temporary character to the character of given index.
None GatherTextsCharsParameters (self, eVision.EOCVChar ocvChar, eVision.ESelectionFlag textsSelectionFlag, eVision.ESelectionFlag charsSelectionFlag)
 Copies the parameters from the characters specified by the selection modes to the temporary character.
None ScatterTextsCharsParameters (self, eVision.EOCVChar ocvChar, eVision.ESelectionFlag textsSelectionFlag, eVision.ESelectionFlag charsSelectionFlag)
 Copies the desired parameters from the temporary character to the characters specified by the selection mode.
None DrawText (self, eVision.EDrawAdapter|None graphicContext, eVision.EOCVText text, float zoomX, float zoomY, float originX, float originY)
 Draws a tight bounding box around a single text, possibly with the main diagonal where diagnostics occur.
None DrawText (self, eVision.EDrawAdapter|None graphicContext, eVision.EOCVText text, float zoomX, float zoomY, float originX)
 Draws a tight bounding box around a single text, possibly with the main diagonal where diagnostics occur.
None DrawText (self, eVision.EDrawAdapter|None graphicContext, eVision.EOCVText text, float zoomX, float zoomY)
 Draws a tight bounding box around a single text, possibly with the main diagonal where diagnostics occur.
None DrawText (self, eVision.EDrawAdapter|None graphicContext, eVision.EOCVText text, float zoomX)
 Draws a tight bounding box around a single text, possibly with the main diagonal where diagnostics occur.
None DrawText (self, eVision.EDrawAdapter|None graphicContext, eVision.EOCVText text)
 Draws a tight bounding box around a single text, possibly with the main diagonal where diagnostics occur.
None DrawTexts (self, eVision.EDrawAdapter|None graphicContext, eVision.ESelectionFlag textsSelectionFlag, float zoomX, float zoomY, float originX, float originY)
 Draws a tight bounding box around all texts, possibly with the main diagonal where diagnostics occur.
None DrawTexts (self, eVision.EDrawAdapter|None graphicContext, eVision.ESelectionFlag textsSelectionFlag, float zoomX, float zoomY, float originX)
 Draws a tight bounding box around all texts, possibly with the main diagonal where diagnostics occur.
None DrawTexts (self, eVision.EDrawAdapter|None graphicContext, eVision.ESelectionFlag textsSelectionFlag, float zoomX, float zoomY)
 Draws a tight bounding box around all texts, possibly with the main diagonal where diagnostics occur.
None DrawTexts (self, eVision.EDrawAdapter|None graphicContext, eVision.ESelectionFlag textsSelectionFlag, float zoomX)
 Draws a tight bounding box around all texts, possibly with the main diagonal where diagnostics occur.
None DrawTexts (self, eVision.EDrawAdapter|None graphicContext, eVision.ESelectionFlag textsSelectionFlag)
 Draws a tight bounding box around all texts, possibly with the main diagonal where diagnostics occur.
None DrawTexts (self, eVision.EDrawAdapter|None graphicContext)
 Draws a tight bounding box around all texts, possibly with the main diagonal where diagnostics occur.
None DrawTextChars (self, eVision.EDrawAdapter|None graphicContext, eVision.EOCVText text, eVision.ESelectionFlag charsSelectionFlag, float zoomX, float zoomY, float originX, float originY)
 Draws a tight bounding box around all characters of a single text, possibly with the main diagonal where diagnostics occur.
None DrawTextChars (self, eVision.EDrawAdapter|None graphicContext, eVision.EOCVText text, eVision.ESelectionFlag charsSelectionFlag, float zoomX, float zoomY, float originX)
 Draws a tight bounding box around all characters of a single text, possibly with the main diagonal where diagnostics occur.
None DrawTextChars (self, eVision.EDrawAdapter|None graphicContext, eVision.EOCVText text, eVision.ESelectionFlag charsSelectionFlag, float zoomX, float zoomY)
 Draws a tight bounding box around all characters of a single text, possibly with the main diagonal where diagnostics occur.
None DrawTextChars (self, eVision.EDrawAdapter|None graphicContext, eVision.EOCVText text, eVision.ESelectionFlag charsSelectionFlag, float zoomX)
 Draws a tight bounding box around all characters of a single text, possibly with the main diagonal where diagnostics occur.
None DrawTextChars (self, eVision.EDrawAdapter|None graphicContext, eVision.EOCVText text, eVision.ESelectionFlag charsSelectionFlag)
 Draws a tight bounding box around all characters of a single text, possibly with the main diagonal where diagnostics occur.
None DrawTextChars (self, eVision.EDrawAdapter|None graphicContext, eVision.EOCVText text)
 Draws a tight bounding box around all characters of a single text, possibly with the main diagonal where diagnostics occur.
None DrawTextsChars (self, eVision.EDrawAdapter|None graphicContext, eVision.ESelectionFlag textsSelectionFlag, eVision.ESelectionFlag charsSelectionFlag, float zoomX, float zoomY, float originX, float originY)
 Draws a tight bounding box around all characters of all texts.
None DrawTextsChars (self, eVision.EDrawAdapter|None graphicContext, eVision.ESelectionFlag textsSelectionFlag, eVision.ESelectionFlag charsSelectionFlag, float zoomX, float zoomY, float originX)
 Draws a tight bounding box around all characters of all texts.
None DrawTextsChars (self, eVision.EDrawAdapter|None graphicContext, eVision.ESelectionFlag textsSelectionFlag, eVision.ESelectionFlag charsSelectionFlag, float zoomX, float zoomY)
 Draws a tight bounding box around all characters of all texts.
None DrawTextsChars (self, eVision.EDrawAdapter|None graphicContext, eVision.ESelectionFlag textsSelectionFlag, eVision.ESelectionFlag charsSelectionFlag, float zoomX)
 Draws a tight bounding box around all characters of all texts.
None DrawTextsChars (self, eVision.EDrawAdapter|None graphicContext, eVision.ESelectionFlag textsSelectionFlag, eVision.ESelectionFlag charsSelectionFlag)
 Draws a tight bounding box around all characters of all texts.
None DrawTextsChars (self, eVision.EDrawAdapter|None graphicContext, eVision.ESelectionFlag textsSelectionFlag)
 Draws a tight bounding box around all characters of all texts.
None DrawTextsChars (self, eVision.EDrawAdapter|None graphicContext)
 Draws a tight bounding box around all characters of all texts.
None Inspect (self, eVision.EROIBW8|None sampleImage, int threshold)
 Inspection is the process that locates the template in the sample image using all allowed degrees of freedom, compares both images to detects and quantify defects.
None ClearStatistics (self)
 Resets the statistics accumulation.
None UpdateStatistics (self)
 Adds the parameters of the last inspection to the statistics.
None AdjustShiftTolerances (self, eVision.EROIBW8|None roi)
 Adjust the shift tolerances on texts from a provided ROI.
None AdjustTextsLocationRanges (self, float factor, eVision.ESelectionFlag selection)
 Adjusts the location ranges (i.e tolerances and bias) of texts using the results of the statistical training (minimum and maximum observed values).
None AdjustTextsLocationRanges (self, float factor)
 Adjusts the location ranges (i.e tolerances and bias) of texts using the results of the statistical training (minimum and maximum observed values).
None AdjustTextsLocationRanges (self)
 Adjusts the location ranges (i.e tolerances and bias) of texts using the results of the statistical training (minimum and maximum observed values).
None AdjustTextsQualityRanges (self, float factor, eVision.ESelectionFlag selection)
 Adjusts the allowed ranges for the text quality indicators (i.e.
None AdjustTextsQualityRanges (self, float factor)
 Adjusts the allowed ranges for the text quality indicators (i.e.
None AdjustTextsQualityRanges (self)
 Adjusts the allowed ranges for the text quality indicators (i.e.
None AdjustCharsLocationRanges (self, float factor, eVision.ESelectionFlag textSelection, eVision.ESelectionFlag charSelection)
 Adjusts the location ranges (i.e tolerances and bias) of the characters using the results of the statistical training (minimum and maximum observed values).
None AdjustCharsLocationRanges (self, float factor, eVision.ESelectionFlag textSelection)
 Adjusts the location ranges (i.e tolerances and bias) of the characters using the results of the statistical training (minimum and maximum observed values).
None AdjustCharsLocationRanges (self, float factor)
 Adjusts the location ranges (i.e tolerances and bias) of the characters using the results of the statistical training (minimum and maximum observed values).
None AdjustCharsLocationRanges (self)
 Adjusts the location ranges (i.e tolerances and bias) of the characters using the results of the statistical training (minimum and maximum observed values).
None AdjustCharsQualityRanges (self, float factor, eVision.ESelectionFlag textSelection, eVision.ESelectionFlag charSelection)
 Adjusts the allowed ranges for the character quality indicators (i.e.
None AdjustCharsQualityRanges (self, float factor, eVision.ESelectionFlag textSelection)
 Adjusts the allowed ranges for the character quality indicators (i.e.
None AdjustCharsQualityRanges (self, float factor)
 Adjusts the allowed ranges for the character quality indicators (i.e.
None AdjustCharsQualityRanges (self)
 Adjusts the allowed ranges for the character quality indicators (i.e.
int FreeCharCount (self)
 Return the number of free characters of the OCV context.
eVision.EROIBW8|None TemplateImage (self)
 Source template image associated to the OCV context during model edition.
 TemplateImage (self, eVision.EROIBW8|None value)
 Source template image associated to the OCV context during model edition.
int WhiteOnBlack (self)
 Flag indicating whether the learning and inspection steps use white characters on a black background, or black characters on a white background.
 WhiteOnBlack (self, int value)
 Flag indicating whether the learning and inspection steps use white characters on a black background, or black characters on a white background.
eVision.EBW8 TemplateThreshold (self)
 Threshold level applied to the template during learning.
 TemplateThreshold (self, eVision.EBW8 value)
 Threshold level applied to the template during learning.
float TemplateBackground (self)
 Reference background gray levels determined during learning of the template.
 TemplateBackground (self, float value)
 Reference background gray levels determined during learning of the template.
float TemplateForeground (self)
 Reference foreground gray levels determined during learning of the template.
 TemplateForeground (self, float value)
 Reference foreground gray levels determined during learning of the template.
eVision.EBW8 SampleThreshold (self)
 Threshold level applied to the sample during inspection.
 SampleThreshold (self, eVision.EBW8 value)
 Threshold level applied to the sample during inspection.
float SampleBackground (self)
 Reference background gray levels determined during inspection of the sample.
 SampleBackground (self, float value)
 Reference background gray levels determined during inspection of the sample.
float SampleForeground (self)
 Reference foreground gray levels determined during inspection of the sample.
 SampleForeground (self, float value)
 Reference foreground gray levels determined during inspection of the sample.
float SampleContrast (self)
 Global contrast of the last inspected image, or FLOAT32_UNDEFINED if it has not been computed.
float ContrastAverage (self)
 Average contrast of last images added to statistics, or FLOAT32_UNDEFINED if it cannot be computed.
float ContrastDeviation (self)
 Standard deviation of the contrast of the last images added to statistics, or FLOAT32_UNDEFINED if it cannot be computed.
float ContrastTolerance (self)
 Allowed tolerance on the global contrast (allowed difference between the sample and template values).
 ContrastTolerance (self, float value)
 Allowed tolerance on the global contrast (allowed difference between the sample and template values).
float TemplateContrast (self)
 Global contrast of the template image, or FLOAT32_UNDEFINED if it has not been computed.
eVision.ELocationMode LocationMode (self)
 Kind of pre-processing should be applied to the sample image, as defined by eVision.ELocationMode.
 LocationMode (self, eVision.ELocationMode value)
 Kind of pre-processing should be applied to the sample image, as defined by eVision.ELocationMode.
bool ReduceLocationScore (self)
 Current location score reduction mode.
 ReduceLocationScore (self, bool value)
 Current location score reduction mode.
bool NormalizeLocationScore (self)
 Current location score normalization mode.
 NormalizeLocationScore (self, bool value)
 Current location score normalization mode.
bool AccurateTextsLocationScores (self)
 Current texts location scoring mode.
 AccurateTextsLocationScores (self, bool value)
 Current texts location scoring mode.
int NumTexts (self)
 Number of texts in the current OCV context.
int UsedQualityIndicators (self)
 Choice of quality indicators.
 UsedQualityIndicators (self, int value)
 Choice of quality indicators.
bool ResampleChars (self)
 Character resampling mode.
 ResampleChars (self, bool value)
 Character resampling mode.
int Diagnostics (self)
 Logical combination (bitwise OR) of the defects found.
int StatisticsCount (self)
 Number of samples that have been taken into account in the statistics so far.

Detailed Description

Manages a complete context for the optical character verification tool implemented in EasyOCV.

Remarks:

License(s): EasyOCV

Deprecated
Deprecated in version 2.11. Scheduled to be removed in version 27.6.

Constructor & Destructor Documentation

◆ __init__()

None eVision.EOCV.__init__ ( self)

Constructs an OCV context.

Remarks:

Only the default constructor is needed.

Member Function Documentation

◆ AccurateTextsLocationScores() [1/2]

bool eVision.EOCV.AccurateTextsLocationScores ( self)

Current texts location scoring mode.

Remarks:

During text location, the text location score is computed before any individual character displacement is allowed. This results in lower location scores because the matching between undeformed template and sample texts is less accurate. When turned on, this property allows the score to be corrected, by taking into account the character displacements. This allows more robust diagnostics based on the location score. If no movement freedom is given to the characters (no ShiftTolerance), this option is irrelevant.

◆ AccurateTextsLocationScores() [2/2]

eVision.EOCV.AccurateTextsLocationScores ( self,
bool value )

Current texts location scoring mode.

Remarks:

During text location, the text location score is computed before any individual character displacement is allowed. This results in lower location scores because the matching between undeformed template and sample texts is less accurate. When turned on, this property allows the score to be corrected, by taking into account the character displacements. This allows more robust diagnostics based on the location score. If no movement freedom is given to the characters (no ShiftTolerance), this option is irrelevant.

◆ AdjustCharsLocationRanges() [1/4]

None eVision.EOCV.AdjustCharsLocationRanges ( self)

Adjusts the location ranges (i.e tolerances and bias) of the characters using the results of the statistical training (minimum and maximum observed values).

Remarks:

The method reassigns bias and tolerances values according to their minimum and maximum observed values in the X and Y directions (reported by statistics). The following adjustments are made on characters whose selection state matches textSelection and charSelection:

  • Shift Bias is assigned 1/2 *(Shift Max + Shift Min)
  • Shift Tolerance is assigned 1/2 * factor * (Shift Max - Shift Min) Defined this way, the allowed range is simply the observed range enlarged by the user-defined factor. The default value for factor is 1.2 (+20 % allowance).

◆ AdjustCharsLocationRanges() [2/4]

None eVision.EOCV.AdjustCharsLocationRanges ( self,
float factor )

Adjusts the location ranges (i.e tolerances and bias) of the characters using the results of the statistical training (minimum and maximum observed values).

Remarks:

The method reassigns bias and tolerances values according to their minimum and maximum observed values in the X and Y directions (reported by statistics). The following adjustments are made on characters whose selection state matches textSelection and charSelection:

  • Shift Bias is assigned 1/2 *(Shift Max + Shift Min)
  • Shift Tolerance is assigned 1/2 * factor * (Shift Max - Shift Min) Defined this way, the allowed range is simply the observed range enlarged by the user-defined factor. The default value for factor is 1.2 (+20 % allowance).
Parameters
factorSafety factor to use when re-computing the tolerances.

◆ AdjustCharsLocationRanges() [3/4]

None eVision.EOCV.AdjustCharsLocationRanges ( self,
float factor,
eVision.ESelectionFlag textSelection )

Adjusts the location ranges (i.e tolerances and bias) of the characters using the results of the statistical training (minimum and maximum observed values).

Remarks:

The method reassigns bias and tolerances values according to their minimum and maximum observed values in the X and Y directions (reported by statistics). The following adjustments are made on characters whose selection state matches textSelection and charSelection:

  • Shift Bias is assigned 1/2 *(Shift Max + Shift Min)
  • Shift Tolerance is assigned 1/2 * factor * (Shift Max - Shift Min) Defined this way, the allowed range is simply the observed range enlarged by the user-defined factor. The default value for factor is 1.2 (+20 % allowance).
Parameters
factorSafety factor to use when re-computing the tolerances.
textSelectionTells on which texts the adjustment should be applied, as defined by eVision.ESelectionFlag.

◆ AdjustCharsLocationRanges() [4/4]

None eVision.EOCV.AdjustCharsLocationRanges ( self,
float factor,
eVision.ESelectionFlag textSelection,
eVision.ESelectionFlag charSelection )

Adjusts the location ranges (i.e tolerances and bias) of the characters using the results of the statistical training (minimum and maximum observed values).

Remarks:

The method reassigns bias and tolerances values according to their minimum and maximum observed values in the X and Y directions (reported by statistics). The following adjustments are made on characters whose selection state matches textSelection and charSelection:

  • Shift Bias is assigned 1/2 *(Shift Max + Shift Min)
  • Shift Tolerance is assigned 1/2 * factor * (Shift Max - Shift Min) Defined this way, the allowed range is simply the observed range enlarged by the user-defined factor. The default value for factor is 1.2 (+20 % allowance).
Parameters
factorSafety factor to use when re-computing the tolerances.
textSelectionTells on which texts the adjustment should be applied, as defined by eVision.ESelectionFlag.
charSelectionTells on which chars the adjustment should be applied, as defined by eVision.ESelectionFlag.

◆ AdjustCharsQualityRanges() [1/4]

None eVision.EOCV.AdjustCharsQualityRanges ( self)

Adjusts the allowed ranges for the character quality indicators (i.e.

tolerances and bias) using the results of the statistical training (average and standard deviation of the observed values).

Remarks:

The method reassigns bias and tolerances values according to their average and standard deviation, as reported by statistics. The following adjustments are made on characters whose selection state matches textSelection and charSelection:

  • the bias parameter value is assigned the corresponding parameter average
  • the tolerance parameter value is assigned the product of factor by its corresponding standard deviation Please note that 3 is a minimum value for factor (3sigma rule).This value should be increased if deviations are computed from a small number of samples.

◆ AdjustCharsQualityRanges() [2/4]

None eVision.EOCV.AdjustCharsQualityRanges ( self,
float factor )

Adjusts the allowed ranges for the character quality indicators (i.e.

tolerances and bias) using the results of the statistical training (average and standard deviation of the observed values).

Remarks:

The method reassigns bias and tolerances values according to their average and standard deviation, as reported by statistics. The following adjustments are made on characters whose selection state matches textSelection and charSelection:

  • the bias parameter value is assigned the corresponding parameter average
  • the tolerance parameter value is assigned the product of factor by its corresponding standard deviation Please note that 3 is a minimum value for factor (3sigma rule).This value should be increased if deviations are computed from a small number of samples.
Parameters
factorSafety factor to use when re-computing the tolerances.

◆ AdjustCharsQualityRanges() [3/4]

None eVision.EOCV.AdjustCharsQualityRanges ( self,
float factor,
eVision.ESelectionFlag textSelection )

Adjusts the allowed ranges for the character quality indicators (i.e.

tolerances and bias) using the results of the statistical training (average and standard deviation of the observed values).

Remarks:

The method reassigns bias and tolerances values according to their average and standard deviation, as reported by statistics. The following adjustments are made on characters whose selection state matches textSelection and charSelection:

  • the bias parameter value is assigned the corresponding parameter average
  • the tolerance parameter value is assigned the product of factor by its corresponding standard deviation Please note that 3 is a minimum value for factor (3sigma rule).This value should be increased if deviations are computed from a small number of samples.
Parameters
factorSafety factor to use when re-computing the tolerances.
textSelectionTells on which texts the adjustment should be applied, as defined by eVision.ESelectionFlag.

◆ AdjustCharsQualityRanges() [4/4]

None eVision.EOCV.AdjustCharsQualityRanges ( self,
float factor,
eVision.ESelectionFlag textSelection,
eVision.ESelectionFlag charSelection )

Adjusts the allowed ranges for the character quality indicators (i.e.

tolerances and bias) using the results of the statistical training (average and standard deviation of the observed values).

Remarks:

The method reassigns bias and tolerances values according to their average and standard deviation, as reported by statistics. The following adjustments are made on characters whose selection state matches textSelection and charSelection:

  • the bias parameter value is assigned the corresponding parameter average
  • the tolerance parameter value is assigned the product of factor by its corresponding standard deviation Please note that 3 is a minimum value for factor (3sigma rule).This value should be increased if deviations are computed from a small number of samples.
Parameters
factorSafety factor to use when re-computing the tolerances.
textSelectionTells on which texts the adjustment should be applied, as defined by eVision.ESelectionFlag.
charSelectionTells on which chars the adjustment should be applied, as defined by eVision.ESelectionFlag.

◆ AdjustShiftTolerances()

None eVision.EOCV.AdjustShiftTolerances ( self,
eVision.EROIBW8 | None roi )

Adjust the shift tolerances on texts from a provided ROI.

Remarks:

The method performs the computation of texts shift tolerances, assuming that the specified ROI always contains the whole text (text cannot lie outside of the ROI). Other text location parameters (skew, scale, shear) are not taken in account, and this method should not be called if these parameters tolerances are not set to zero. The method also assumes texts always have the same displacement, and does not affect characters location tolerances.

Parameters
roiPointer on the ROI from which the shift tolerances will be computed.

◆ AdjustTextsLocationRanges() [1/3]

None eVision.EOCV.AdjustTextsLocationRanges ( self)

Adjusts the location ranges (i.e tolerances and bias) of texts using the results of the statistical training (minimum and maximum observed values).

Remarks:

The method reassigns bias and tolerances values according to their minimum and maximum observed values in the X and Y directions (reported by statistics). The following adjustments are made on texts whose selection state matches selection:

  • Shift Bias is assigned 1/2 * (Shift Max + Shift Min)
  • Shift Tolerance is assigned 1/2 * factor * (Shift Max - Shift Min) Defined this way, the allowed range is simply the observed range enlarged by the user-defined factor. The default value for factor is 1.2 (+20 % allowance).

◆ AdjustTextsLocationRanges() [2/3]

None eVision.EOCV.AdjustTextsLocationRanges ( self,
float factor )

Adjusts the location ranges (i.e tolerances and bias) of texts using the results of the statistical training (minimum and maximum observed values).

Remarks:

The method reassigns bias and tolerances values according to their minimum and maximum observed values in the X and Y directions (reported by statistics). The following adjustments are made on texts whose selection state matches selection:

  • Shift Bias is assigned 1/2 * (Shift Max + Shift Min)
  • Shift Tolerance is assigned 1/2 * factor * (Shift Max - Shift Min) Defined this way, the allowed range is simply the observed range enlarged by the user-defined factor. The default value for factor is 1.2 (+20 % allowance).
Parameters
factorSafety factor to use when re-computing the tolerances.

◆ AdjustTextsLocationRanges() [3/3]

None eVision.EOCV.AdjustTextsLocationRanges ( self,
float factor,
eVision.ESelectionFlag selection )

Adjusts the location ranges (i.e tolerances and bias) of texts using the results of the statistical training (minimum and maximum observed values).

Remarks:

The method reassigns bias and tolerances values according to their minimum and maximum observed values in the X and Y directions (reported by statistics). The following adjustments are made on texts whose selection state matches selection:

  • Shift Bias is assigned 1/2 * (Shift Max + Shift Min)
  • Shift Tolerance is assigned 1/2 * factor * (Shift Max - Shift Min) Defined this way, the allowed range is simply the observed range enlarged by the user-defined factor. The default value for factor is 1.2 (+20 % allowance).
Parameters
factorSafety factor to use when re-computing the tolerances.
selectionTells on which texts the adjustment should be applied, as defined by eVision.ESelectionFlag.

◆ AdjustTextsQualityRanges() [1/3]

None eVision.EOCV.AdjustTextsQualityRanges ( self)

Adjusts the allowed ranges for the text quality indicators (i.e.

tolerances and bias) using the results of the statistical training (average and standard deviation of the observed values).

Remarks:

The method reassigns bias and tolerances values according to their average and standard deviation, as reported by statistics. The following adjustments are made on texts whose selection state matches selection:

  • the bias parameter value is assigned the corresponding parameter average
  • the tolerance parameter value is assigned the product of factor by its corresponding standard deviation Please note that 3 is a minimum value for factor (3sigma rule).This value should be increased if deviations are computed from a small number of samples.

◆ AdjustTextsQualityRanges() [2/3]

None eVision.EOCV.AdjustTextsQualityRanges ( self,
float factor )

Adjusts the allowed ranges for the text quality indicators (i.e.

tolerances and bias) using the results of the statistical training (average and standard deviation of the observed values).

Remarks:

The method reassigns bias and tolerances values according to their average and standard deviation, as reported by statistics. The following adjustments are made on texts whose selection state matches selection:

  • the bias parameter value is assigned the corresponding parameter average
  • the tolerance parameter value is assigned the product of factor by its corresponding standard deviation Please note that 3 is a minimum value for factor (3sigma rule).This value should be increased if deviations are computed from a small number of samples.
Parameters
factorSafety factor to use when re-computing the tolerances.

◆ AdjustTextsQualityRanges() [3/3]

None eVision.EOCV.AdjustTextsQualityRanges ( self,
float factor,
eVision.ESelectionFlag selection )

Adjusts the allowed ranges for the text quality indicators (i.e.

tolerances and bias) using the results of the statistical training (average and standard deviation of the observed values).

Remarks:

The method reassigns bias and tolerances values according to their average and standard deviation, as reported by statistics. The following adjustments are made on texts whose selection state matches selection:

  • the bias parameter value is assigned the corresponding parameter average
  • the tolerance parameter value is assigned the product of factor by its corresponding standard deviation Please note that 3 is a minimum value for factor (3sigma rule).This value should be increased if deviations are computed from a small number of samples.
Parameters
factorSafety factor to use when re-computing the tolerances.
selectionTells on which texts the adjustment should be applied, as defined by eVision.ESelectionFlag.

◆ AreAllFreeObjectsSelected()

bool eVision.EOCV.AreAllFreeObjectsSelected ( self)

◆ ClearStatistics()

None eVision.EOCV.ClearStatistics ( self)

Resets the statistics accumulation.

Remarks:

This function must be called before a batch of inspections.

◆ ComputeDefaultTolerances() [1/2]

None eVision.EOCV.ComputeDefaultTolerances ( self,
eVision.EROIBW8 | None roi )

Computes or recomputes the default tolerances of the quality indicators currently in use for all characters of all texts from the given ROI and threshold.

Remarks:

An explicit call of this method is performed by method Learn at the end of the learning stage.

Parameters
roiPointer to the ROI from which the default tolerances should be computed.

◆ ComputeDefaultTolerances() [2/2]

None eVision.EOCV.ComputeDefaultTolerances ( self,
eVision.EROIBW8 | None roi,
int threshold )

Computes or recomputes the default tolerances of the quality indicators currently in use for all characters of all texts from the given ROI and threshold.

Remarks:

An explicit call of this method is performed by method Learn at the end of the learning stage.

Parameters
roiPointer to the ROI from which the default tolerances should be computed.
thresholdThreshold level to use during computation, as defined by eVision.EThresholdMode.

◆ ContrastAverage()

float eVision.EOCV.ContrastAverage ( self)

Average contrast of last images added to statistics, or FLOAT32_UNDEFINED if it cannot be computed.

Remarks:

The contrast is defined as the ratio of the reference gray-levels difference over their sum. This parameter is maximum (100 %) for a perfectly contrasted image (white on black).

◆ ContrastDeviation()

float eVision.EOCV.ContrastDeviation ( self)

Standard deviation of the contrast of the last images added to statistics, or FLOAT32_UNDEFINED if it cannot be computed.

Remarks:

The contrast is defined as the ratio of the reference gray-levels difference over their sum. This parameter is maximum (100 %) for a perfectly contrasted image (white on black).

◆ ContrastTolerance() [1/2]

float eVision.EOCV.ContrastTolerance ( self)

Allowed tolerance on the global contrast (allowed difference between the sample and template values).

Remarks:

The contrast is defined as the ratio of the reference gray-levels difference over their sum. This parameter is maximum (100 %) for a perfectly contrasted image (white on black).

◆ ContrastTolerance() [2/2]

eVision.EOCV.ContrastTolerance ( self,
float value )

Allowed tolerance on the global contrast (allowed difference between the sample and template values).

Remarks:

The contrast is defined as the ratio of the reference gray-levels difference over their sum. This parameter is maximum (100 %) for a perfectly contrasted image (white on black).

◆ CreateTemplateChars() [1/3]

None eVision.EOCV.CreateTemplateChars ( self)

Adds to the OCV context the characters formed from the list of free objects.

Remarks:

The free characters are sets of blobs taken from the free objects list. One step of the model definition is to specify which free objects will be handled by the OCV context and how they will be grouped to form characters. Grouping can be done automatically by using a overlapping criterion, or explicitly. When an object is added to a character, it is removed from the free objects list.

◆ CreateTemplateChars() [2/3]

None eVision.EOCV.CreateTemplateChars ( self,
eVision.ESelectionFlag objectsSelectionFlag )

Adds to the OCV context the characters formed from the list of free objects.

Remarks:

The free characters are sets of blobs taken from the free objects list. One step of the model definition is to specify which free objects will be handled by the OCV context and how they will be grouped to form characters. Grouping can be done automatically by using a overlapping criterion, or explicitly. When an object is added to a character, it is removed from the free objects list.

Parameters
objectsSelectionFlagSelection mode for the objects, as defined by eVision.ESelectionFlag. By default, only the selected objects are created.

◆ CreateTemplateChars() [3/3]

None eVision.EOCV.CreateTemplateChars ( self,
eVision.ESelectionFlag objectsSelectionFlag,
eVision.ECharCreationMode creationMode )

Adds to the OCV context the characters formed from the list of free objects.

Remarks:

The free characters are sets of blobs taken from the free objects list. One step of the model definition is to specify which free objects will be handled by the OCV context and how they will be grouped to form characters. Grouping can be done automatically by using a overlapping criterion, or explicitly. When an object is added to a character, it is removed from the free objects list.

Parameters
objectsSelectionFlagSelection mode for the objects, as defined by eVision.ESelectionFlag. By default, only the selected objects are created.
creationModeFree objects grouping criterion, as defined by eVision.ECharCreationMode. By default, the free objects whose bounding rectangle overlap are considered as belonging to the same character.

◆ CreateTemplateTexts() [1/2]

None eVision.EOCV.CreateTemplateTexts ( self)

Adds to the OCV context a piece of text formed from the list of free characters.

Remarks:

The template texts are sets of characters taken from the free characters list. One step of the model definition is to specify which free characters will be handled by the OCV context and how they will be grouped to form texts. Grouping must be done explicitly. When a character is added to a text, it is removed from the free characters list.

◆ CreateTemplateTexts() [2/2]

None eVision.EOCV.CreateTemplateTexts ( self,
eVision.ESelectionFlag charsSelectionFlag )

Adds to the OCV context a piece of text formed from the list of free characters.

Remarks:

The template texts are sets of characters taken from the free characters list. One step of the model definition is to specify which free characters will be handled by the OCV context and how they will be grouped to form texts. Grouping must be done explicitly. When a character is added to a text, it is removed from the free characters list.

Parameters
charsSelectionFlagSelection mode for the free characters, as defined by eVision.ESelectionFlag. By default, only the selected free characters are processed.

◆ DeleteTemplateChars() [1/2]

None eVision.EOCV.DeleteTemplateChars ( self)

Removes free characters from the OCV context.

Remarks:

The free characters are sets of blobs taken from the free objects list. One step of the model definition is to specify which free objects will be handled by the OCV context and how they will be grouped to form characters. Grouping can be done automatically by using a overlapping criterion, or explicitly. When an object is added to a character, it is removed from the free objects list.

◆ DeleteTemplateChars() [2/2]

None eVision.EOCV.DeleteTemplateChars ( self,
eVision.ESelectionFlag charsSelectionFlag )

Removes free characters from the OCV context.

Remarks:

The free characters are sets of blobs taken from the free objects list. One step of the model definition is to specify which free objects will be handled by the OCV context and how they will be grouped to form characters. Grouping can be done automatically by using a overlapping criterion, or explicitly. When an object is added to a character, it is removed from the free objects list.

Parameters
charsSelectionFlagSelection mode for the free characters, as defined by eVision.ESelectionFlag. By default, only the selected free characters are deleted.

◆ DeleteTemplateObjects() [1/2]

None eVision.EOCV.DeleteTemplateObjects ( self)

Removes free objects from the OCV context.

Remarks:

The free objects are blobs built using a separate coded image. One step of the model definition is to specify which objects will be handled by the OCV context.

◆ DeleteTemplateObjects() [2/2]

None eVision.EOCV.DeleteTemplateObjects ( self,
eVision.ESelectionFlag objectsSelectionFlag )

Removes free objects from the OCV context.

Remarks:

The free objects are blobs built using a separate coded image. One step of the model definition is to specify which objects will be handled by the OCV context.

Parameters
objectsSelectionFlagSelection mode for the objects, as defined by eVision.ESelectionFlag. By default, only the selected objects are deleted.

◆ DeleteTemplateTexts() [1/2]

None eVision.EOCV.DeleteTemplateTexts ( self)

Removes template texts from the OCV context.

Remarks:

The template texts are sets of characters taken from the free characters list. One step of the model definition is to specify which free characters will be handled by the OCV context and how they will be grouped to form texts. Grouping must be done explicitly. When a character is added to a text, it is removed from the free characters list.

◆ DeleteTemplateTexts() [2/2]

None eVision.EOCV.DeleteTemplateTexts ( self,
eVision.ESelectionFlag textsSelectionFlag )

Removes template texts from the OCV context.

Remarks:

The template texts are sets of characters taken from the free characters list. One step of the model definition is to specify which free characters will be handled by the OCV context and how they will be grouped to form texts. Grouping must be done explicitly. When a character is added to a text, it is removed from the free characters list.

Parameters
textsSelectionFlagSelection mode for the template texts, as defined by eVision.ESelectionFlag. By default, only the selected texts are deleted.

◆ Diagnostics()

int eVision.EOCV.Diagnostics ( self)

Logical combination (bitwise OR) of the defects found.

Remarks:

Inspection is the process that locates the template in the sample image, using all allowed degrees of freedom, and that compares both images to detects and quantify defects. After inspection, all defective texts and text characters are selected. Further, the diagnostics binary mask contain a detailed interpretation of the defects found.

◆ DrawTemplateChars() [1/6]

None eVision.EOCV.DrawTemplateChars ( self,
eVision.EDrawAdapter | None graphicContext )

Draws the free characters as bounding rectangles.

Remarks:

The template drawing methods are used to graphically represent the free objects, free characters, texts and text characters associated to the OCV context before learning. All drawing operations are done using the current pen attributes.

Parameters
graphicContextDevice context of the drawing window.

◆ DrawTemplateChars() [2/6]

None eVision.EOCV.DrawTemplateChars ( self,
eVision.EDrawAdapter | None graphicContext,
eVision.ESelectionFlag charsSelectionFlag )

Draws the free characters as bounding rectangles.

Remarks:

The template drawing methods are used to graphically represent the free objects, free characters, texts and text characters associated to the OCV context before learning. All drawing operations are done using the current pen attributes.

Parameters
graphicContextDevice context of the drawing window.
charsSelectionFlagSelection mode for the free characters, as defined by eVision.ESelectionFlag. By default, only the selected characters are drawn.

◆ DrawTemplateChars() [3/6]

None eVision.EOCV.DrawTemplateChars ( self,
eVision.EDrawAdapter | None graphicContext,
eVision.ESelectionFlag charsSelectionFlag,
float zoomX )

Draws the free characters as bounding rectangles.

Remarks:

The template drawing methods are used to graphically represent the free objects, free characters, texts and text characters associated to the OCV context before learning. All drawing operations are done using the current pen attributes.

Parameters
graphicContextDevice context of the drawing window.
charsSelectionFlagSelection mode for the free characters, as defined by eVision.ESelectionFlag. By default, only the selected characters are drawn.
zoomXZooming parameters.

◆ DrawTemplateChars() [4/6]

None eVision.EOCV.DrawTemplateChars ( self,
eVision.EDrawAdapter | None graphicContext,
eVision.ESelectionFlag charsSelectionFlag,
float zoomX,
float zoomY )

Draws the free characters as bounding rectangles.

Remarks:

The template drawing methods are used to graphically represent the free objects, free characters, texts and text characters associated to the OCV context before learning. All drawing operations are done using the current pen attributes.

Parameters
graphicContextDevice context of the drawing window.
charsSelectionFlagSelection mode for the free characters, as defined by eVision.ESelectionFlag. By default, only the selected characters are drawn.
zoomXZooming parameters.
zoomYZooming parameters.

◆ DrawTemplateChars() [5/6]

None eVision.EOCV.DrawTemplateChars ( self,
eVision.EDrawAdapter | None graphicContext,
eVision.ESelectionFlag charsSelectionFlag,
float zoomX,
float zoomY,
float originX )

Draws the free characters as bounding rectangles.

Remarks:

The template drawing methods are used to graphically represent the free objects, free characters, texts and text characters associated to the OCV context before learning. All drawing operations are done using the current pen attributes.

Parameters
graphicContextDevice context of the drawing window.
charsSelectionFlagSelection mode for the free characters, as defined by eVision.ESelectionFlag. By default, only the selected characters are drawn.
zoomXZooming parameters.
zoomYZooming parameters.
originXHorizontal panning value expressed in pixels. By default, no panning occurs.

◆ DrawTemplateChars() [6/6]

None eVision.EOCV.DrawTemplateChars ( self,
eVision.EDrawAdapter | None graphicContext,
eVision.ESelectionFlag charsSelectionFlag,
float zoomX,
float zoomY,
float originX,
float originY )

Draws the free characters as bounding rectangles.

Remarks:

The template drawing methods are used to graphically represent the free objects, free characters, texts and text characters associated to the OCV context before learning. All drawing operations are done using the current pen attributes.

Parameters
graphicContextDevice context of the drawing window.
charsSelectionFlagSelection mode for the free characters, as defined by eVision.ESelectionFlag. By default, only the selected characters are drawn.
zoomXZooming parameters.
zoomYZooming parameters.
originXHorizontal panning value expressed in pixels. By default, no panning occurs.
originYVertical panning value expressed in pixels. By default, no panning occurs.

◆ DrawTemplateObjects() [1/6]

None eVision.EOCV.DrawTemplateObjects ( self,
eVision.EDrawAdapter | None graphicContext )

Draws the free objects as blobs.

Remarks:

The associated coded image must be present. The template drawing methods are used to graphically represent the free objects, free characters, texts and text characters associated to the OCV context before learning. All drawing operations are done using the current pen attributes.

Parameters
graphicContextDevice context of the drawing window.

◆ DrawTemplateObjects() [2/6]

None eVision.EOCV.DrawTemplateObjects ( self,
eVision.EDrawAdapter | None graphicContext,
eVision.ESelectionFlag objectsSelectionFlag )

Draws the free objects as blobs.

Remarks:

The associated coded image must be present. The template drawing methods are used to graphically represent the free objects, free characters, texts and text characters associated to the OCV context before learning. All drawing operations are done using the current pen attributes.

Parameters
graphicContextDevice context of the drawing window.
objectsSelectionFlagSelection mode for the objects, as defined by eVision.ESelectionFlag. By default, only the selected objects are drawn.

◆ DrawTemplateObjects() [3/6]

None eVision.EOCV.DrawTemplateObjects ( self,
eVision.EDrawAdapter | None graphicContext,
eVision.ESelectionFlag objectsSelectionFlag,
float zoomX )

Draws the free objects as blobs.

Remarks:

The associated coded image must be present. The template drawing methods are used to graphically represent the free objects, free characters, texts and text characters associated to the OCV context before learning. All drawing operations are done using the current pen attributes.

Parameters
graphicContextDevice context of the drawing window.
objectsSelectionFlagSelection mode for the objects, as defined by eVision.ESelectionFlag. By default, only the selected objects are drawn.
zoomXZooming parameters.

◆ DrawTemplateObjects() [4/6]

None eVision.EOCV.DrawTemplateObjects ( self,
eVision.EDrawAdapter | None graphicContext,
eVision.ESelectionFlag objectsSelectionFlag,
float zoomX,
float zoomY )

Draws the free objects as blobs.

Remarks:

The associated coded image must be present. The template drawing methods are used to graphically represent the free objects, free characters, texts and text characters associated to the OCV context before learning. All drawing operations are done using the current pen attributes.

Parameters
graphicContextDevice context of the drawing window.
objectsSelectionFlagSelection mode for the objects, as defined by eVision.ESelectionFlag. By default, only the selected objects are drawn.
zoomXZooming parameters.
zoomYZooming parameters.

◆ DrawTemplateObjects() [5/6]

None eVision.EOCV.DrawTemplateObjects ( self,
eVision.EDrawAdapter | None graphicContext,
eVision.ESelectionFlag objectsSelectionFlag,
float zoomX,
float zoomY,
float originX )

Draws the free objects as blobs.

Remarks:

The associated coded image must be present. The template drawing methods are used to graphically represent the free objects, free characters, texts and text characters associated to the OCV context before learning. All drawing operations are done using the current pen attributes.

Parameters
graphicContextDevice context of the drawing window.
objectsSelectionFlagSelection mode for the objects, as defined by eVision.ESelectionFlag. By default, only the selected objects are drawn.
zoomXZooming parameters.
zoomYZooming parameters.
originXHorizontal panning value expressed in pixels. By default, no panning occurs.

◆ DrawTemplateObjects() [6/6]

None eVision.EOCV.DrawTemplateObjects ( self,
eVision.EDrawAdapter | None graphicContext,
eVision.ESelectionFlag objectsSelectionFlag,
float zoomX,
float zoomY,
float originX,
float originY )

Draws the free objects as blobs.

Remarks:

The associated coded image must be present. The template drawing methods are used to graphically represent the free objects, free characters, texts and text characters associated to the OCV context before learning. All drawing operations are done using the current pen attributes.

Parameters
graphicContextDevice context of the drawing window.
objectsSelectionFlagSelection mode for the objects, as defined by eVision.ESelectionFlag. By default, only the selected objects are drawn.
zoomXZooming parameters.
zoomYZooming parameters.
originXHorizontal panning value expressed in pixels. By default, no panning occurs.
originYVertical panning value expressed in pixels. By default, no panning occurs.

◆ DrawTemplateTexts() [1/6]

None eVision.EOCV.DrawTemplateTexts ( self,
eVision.EDrawAdapter | None graphicContext )

Draws the texts as bounding rectangles.

Remarks:

The template drawing methods are used to graphically represent the free objects, free characters, texts and text characters associated to the OCV context before learning. All drawing operations are done using the current pen attributes.

Parameters
graphicContextDevice context of the drawing window.

◆ DrawTemplateTexts() [2/6]

None eVision.EOCV.DrawTemplateTexts ( self,
eVision.EDrawAdapter | None graphicContext,
eVision.ESelectionFlag textsSelectionFlag )

Draws the texts as bounding rectangles.

Remarks:

The template drawing methods are used to graphically represent the free objects, free characters, texts and text characters associated to the OCV context before learning. All drawing operations are done using the current pen attributes.

Parameters
graphicContextDevice context of the drawing window.
textsSelectionFlagSelection mode for the free texts, as defined by eVision.ESelectionFlag. By default, only the selected texts are drawn.

◆ DrawTemplateTexts() [3/6]

None eVision.EOCV.DrawTemplateTexts ( self,
eVision.EDrawAdapter | None graphicContext,
eVision.ESelectionFlag textsSelectionFlag,
float zoomX )

Draws the texts as bounding rectangles.

Remarks:

The template drawing methods are used to graphically represent the free objects, free characters, texts and text characters associated to the OCV context before learning. All drawing operations are done using the current pen attributes.

Parameters
graphicContextDevice context of the drawing window.
textsSelectionFlagSelection mode for the free texts, as defined by eVision.ESelectionFlag. By default, only the selected texts are drawn.
zoomXZooming parameters.

◆ DrawTemplateTexts() [4/6]

None eVision.EOCV.DrawTemplateTexts ( self,
eVision.EDrawAdapter | None graphicContext,
eVision.ESelectionFlag textsSelectionFlag,
float zoomX,
float zoomY )

Draws the texts as bounding rectangles.

Remarks:

The template drawing methods are used to graphically represent the free objects, free characters, texts and text characters associated to the OCV context before learning. All drawing operations are done using the current pen attributes.

Parameters
graphicContextDevice context of the drawing window.
textsSelectionFlagSelection mode for the free texts, as defined by eVision.ESelectionFlag. By default, only the selected texts are drawn.
zoomXZooming parameters.
zoomYZooming parameters.

◆ DrawTemplateTexts() [5/6]

None eVision.EOCV.DrawTemplateTexts ( self,
eVision.EDrawAdapter | None graphicContext,
eVision.ESelectionFlag textsSelectionFlag,
float zoomX,
float zoomY,
float originX )

Draws the texts as bounding rectangles.

Remarks:

The template drawing methods are used to graphically represent the free objects, free characters, texts and text characters associated to the OCV context before learning. All drawing operations are done using the current pen attributes.

Parameters
graphicContextDevice context of the drawing window.
textsSelectionFlagSelection mode for the free texts, as defined by eVision.ESelectionFlag. By default, only the selected texts are drawn.
zoomXZooming parameters.
zoomYZooming parameters.
originXHorizontal panning value expressed in pixels. By default, no panning occurs.

◆ DrawTemplateTexts() [6/6]

None eVision.EOCV.DrawTemplateTexts ( self,
eVision.EDrawAdapter | None graphicContext,
eVision.ESelectionFlag textsSelectionFlag,
float zoomX,
float zoomY,
float originX,
float originY )

Draws the texts as bounding rectangles.

Remarks:

The template drawing methods are used to graphically represent the free objects, free characters, texts and text characters associated to the OCV context before learning. All drawing operations are done using the current pen attributes.

Parameters
graphicContextDevice context of the drawing window.
textsSelectionFlagSelection mode for the free texts, as defined by eVision.ESelectionFlag. By default, only the selected texts are drawn.
zoomXZooming parameters.
zoomYZooming parameters.
originXHorizontal panning value expressed in pixels. By default, no panning occurs.
originYVertical panning value expressed in pixels. By default, no panning occurs.

◆ DrawTemplateTextsChars() [1/7]

None eVision.EOCV.DrawTemplateTextsChars ( self,
eVision.EDrawAdapter | None graphicContext )

Draws the characters of the texts as bounding rectangles.

Remarks:

The template drawing methods are used to graphically represent the free objects, free characters, texts and text characters associated to the OCV context before learning. All drawing operations are done using the current pen attributes.

Parameters
graphicContextDevice context of the drawing window.

◆ DrawTemplateTextsChars() [2/7]

None eVision.EOCV.DrawTemplateTextsChars ( self,
eVision.EDrawAdapter | None graphicContext,
eVision.ESelectionFlag textsSelectionFlag )

Draws the characters of the texts as bounding rectangles.

Remarks:

The template drawing methods are used to graphically represent the free objects, free characters, texts and text characters associated to the OCV context before learning. All drawing operations are done using the current pen attributes.

Parameters
graphicContextDevice context of the drawing window.
textsSelectionFlagSelection mode for the texts, as defined by eVision.ESelectionFlag. By default, only characters from the selected texts are drawn.

◆ DrawTemplateTextsChars() [3/7]

None eVision.EOCV.DrawTemplateTextsChars ( self,
eVision.EDrawAdapter | None graphicContext,
eVision.ESelectionFlag textsSelectionFlag,
eVision.ESelectionFlag charsSelectionFlag )

Draws the characters of the texts as bounding rectangles.

Remarks:

The template drawing methods are used to graphically represent the free objects, free characters, texts and text characters associated to the OCV context before learning. All drawing operations are done using the current pen attributes.

Parameters
graphicContextDevice context of the drawing window.
textsSelectionFlagSelection mode for the texts, as defined by eVision.ESelectionFlag. By default, only characters from the selected texts are drawn.
charsSelectionFlagSelection mode for the characters, as defined by eVision.ESelectionFlag. By default, only the selected characters of the selected texts are drawn.

◆ DrawTemplateTextsChars() [4/7]

None eVision.EOCV.DrawTemplateTextsChars ( self,
eVision.EDrawAdapter | None graphicContext,
eVision.ESelectionFlag textsSelectionFlag,
eVision.ESelectionFlag charsSelectionFlag,
float zoomX )

Draws the characters of the texts as bounding rectangles.

Remarks:

The template drawing methods are used to graphically represent the free objects, free characters, texts and text characters associated to the OCV context before learning. All drawing operations are done using the current pen attributes.

Parameters
graphicContextDevice context of the drawing window.
textsSelectionFlagSelection mode for the texts, as defined by eVision.ESelectionFlag. By default, only characters from the selected texts are drawn.
charsSelectionFlagSelection mode for the characters, as defined by eVision.ESelectionFlag. By default, only the selected characters of the selected texts are drawn.
zoomXZooming parameters.

◆ DrawTemplateTextsChars() [5/7]

None eVision.EOCV.DrawTemplateTextsChars ( self,
eVision.EDrawAdapter | None graphicContext,
eVision.ESelectionFlag textsSelectionFlag,
eVision.ESelectionFlag charsSelectionFlag,
float zoomX,
float zoomY )

Draws the characters of the texts as bounding rectangles.

Remarks:

The template drawing methods are used to graphically represent the free objects, free characters, texts and text characters associated to the OCV context before learning. All drawing operations are done using the current pen attributes.

Parameters
graphicContextDevice context of the drawing window.
textsSelectionFlagSelection mode for the texts, as defined by eVision.ESelectionFlag. By default, only characters from the selected texts are drawn.
charsSelectionFlagSelection mode for the characters, as defined by eVision.ESelectionFlag. By default, only the selected characters of the selected texts are drawn.
zoomXZooming parameters.
zoomYZooming parameters.

◆ DrawTemplateTextsChars() [6/7]

None eVision.EOCV.DrawTemplateTextsChars ( self,
eVision.EDrawAdapter | None graphicContext,
eVision.ESelectionFlag textsSelectionFlag,
eVision.ESelectionFlag charsSelectionFlag,
float zoomX,
float zoomY,
float originX )

Draws the characters of the texts as bounding rectangles.

Remarks:

The template drawing methods are used to graphically represent the free objects, free characters, texts and text characters associated to the OCV context before learning. All drawing operations are done using the current pen attributes.

Parameters
graphicContextDevice context of the drawing window.
textsSelectionFlagSelection mode for the texts, as defined by eVision.ESelectionFlag. By default, only characters from the selected texts are drawn.
charsSelectionFlagSelection mode for the characters, as defined by eVision.ESelectionFlag. By default, only the selected characters of the selected texts are drawn.
zoomXZooming parameters.
zoomYZooming parameters.
originXHorizontal panning value expressed in pixels. By default, no panning occurs.

◆ DrawTemplateTextsChars() [7/7]

None eVision.EOCV.DrawTemplateTextsChars ( self,
eVision.EDrawAdapter | None graphicContext,
eVision.ESelectionFlag textsSelectionFlag,
eVision.ESelectionFlag charsSelectionFlag,
float zoomX,
float zoomY,
float originX,
float originY )

Draws the characters of the texts as bounding rectangles.

Remarks:

The template drawing methods are used to graphically represent the free objects, free characters, texts and text characters associated to the OCV context before learning. All drawing operations are done using the current pen attributes.

Parameters
graphicContextDevice context of the drawing window.
textsSelectionFlagSelection mode for the texts, as defined by eVision.ESelectionFlag. By default, only characters from the selected texts are drawn.
charsSelectionFlagSelection mode for the characters, as defined by eVision.ESelectionFlag. By default, only the selected characters of the selected texts are drawn.
zoomXZooming parameters.
zoomYZooming parameters.
originXHorizontal panning value expressed in pixels. By default, no panning occurs.
originYVertical panning value expressed in pixels. By default, no panning occurs.

◆ DrawText() [1/5]

None eVision.EOCV.DrawText ( self,
eVision.EDrawAdapter | None graphicContext,
eVision.EOCVText text )

Draws a tight bounding box around a single text, possibly with the main diagonal where diagnostics occur.

Remarks:

The sample drawing member functions are used to graphically represent the texts and text characters located in the image during inspection. All drawing operations are done using the current pen attributes. Normally, the characters and texts are drawn as a bounding box. However, when diagnostics have been raised on a character or text, the main diagonal (north-west to south-east) is drawn as well, indicating that the item is rejected.

Parameters
graphicContextDevice context of the drawing window.
textReference to the desired text can be obtained by using eVision.EOCV.GetText.

◆ DrawText() [2/5]

None eVision.EOCV.DrawText ( self,
eVision.EDrawAdapter | None graphicContext,
eVision.EOCVText text,
float zoomX )

Draws a tight bounding box around a single text, possibly with the main diagonal where diagnostics occur.

Remarks:

The sample drawing member functions are used to graphically represent the texts and text characters located in the image during inspection. All drawing operations are done using the current pen attributes. Normally, the characters and texts are drawn as a bounding box. However, when diagnostics have been raised on a character or text, the main diagonal (north-west to south-east) is drawn as well, indicating that the item is rejected.

Parameters
graphicContextDevice context of the drawing window.
textReference to the desired text can be obtained by using eVision.EOCV.GetText.
zoomXZooming parameters.

◆ DrawText() [3/5]

None eVision.EOCV.DrawText ( self,
eVision.EDrawAdapter | None graphicContext,
eVision.EOCVText text,
float zoomX,
float zoomY )

Draws a tight bounding box around a single text, possibly with the main diagonal where diagnostics occur.

Remarks:

The sample drawing member functions are used to graphically represent the texts and text characters located in the image during inspection. All drawing operations are done using the current pen attributes. Normally, the characters and texts are drawn as a bounding box. However, when diagnostics have been raised on a character or text, the main diagonal (north-west to south-east) is drawn as well, indicating that the item is rejected.

Parameters
graphicContextDevice context of the drawing window.
textReference to the desired text can be obtained by using eVision.EOCV.GetText.
zoomXZooming parameters.
zoomYZooming parameters.

◆ DrawText() [4/5]

None eVision.EOCV.DrawText ( self,
eVision.EDrawAdapter | None graphicContext,
eVision.EOCVText text,
float zoomX,
float zoomY,
float originX )

Draws a tight bounding box around a single text, possibly with the main diagonal where diagnostics occur.

Remarks:

The sample drawing member functions are used to graphically represent the texts and text characters located in the image during inspection. All drawing operations are done using the current pen attributes. Normally, the characters and texts are drawn as a bounding box. However, when diagnostics have been raised on a character or text, the main diagonal (north-west to south-east) is drawn as well, indicating that the item is rejected.

Parameters
graphicContextDevice context of the drawing window.
textReference to the desired text can be obtained by using eVision.EOCV.GetText.
zoomXZooming parameters.
zoomYZooming parameters.
originXHorizontal panning value expressed in pixels. By default, no panning occurs.

◆ DrawText() [5/5]

None eVision.EOCV.DrawText ( self,
eVision.EDrawAdapter | None graphicContext,
eVision.EOCVText text,
float zoomX,
float zoomY,
float originX,
float originY )

Draws a tight bounding box around a single text, possibly with the main diagonal where diagnostics occur.

Remarks:

The sample drawing member functions are used to graphically represent the texts and text characters located in the image during inspection. All drawing operations are done using the current pen attributes. Normally, the characters and texts are drawn as a bounding box. However, when diagnostics have been raised on a character or text, the main diagonal (north-west to south-east) is drawn as well, indicating that the item is rejected.

Parameters
graphicContextDevice context of the drawing window.
textReference to the desired text can be obtained by using eVision.EOCV.GetText.
zoomXZooming parameters.
zoomYZooming parameters.
originXHorizontal panning value expressed in pixels. By default, no panning occurs.
originYVertical panning value expressed in pixels. By default, no panning occurs.

◆ DrawTextChars() [1/6]

None eVision.EOCV.DrawTextChars ( self,
eVision.EDrawAdapter | None graphicContext,
eVision.EOCVText text )

Draws a tight bounding box around all characters of a single text, possibly with the main diagonal where diagnostics occur.

Remarks:

The sample drawing methods are used to graphically represent the texts and text characters located in the image during inspection. All drawing operations are done using the current pen attributes. Normally, the characters and texts are drawn as a bounding box. However, when diagnostics have been raised on a character or text, the main diagonal (north west to south east) is drawn as well, indicating that the item is rejected.

Parameters
graphicContextHandle to the device context of the destination window.
textReference to the desired text.

◆ DrawTextChars() [2/6]

None eVision.EOCV.DrawTextChars ( self,
eVision.EDrawAdapter | None graphicContext,
eVision.EOCVText text,
eVision.ESelectionFlag charsSelectionFlag )

Draws a tight bounding box around all characters of a single text, possibly with the main diagonal where diagnostics occur.

Remarks:

The sample drawing methods are used to graphically represent the texts and text characters located in the image during inspection. All drawing operations are done using the current pen attributes. Normally, the characters and texts are drawn as a bounding box. However, when diagnostics have been raised on a character or text, the main diagonal (north west to south east) is drawn as well, indicating that the item is rejected.

Parameters
graphicContextHandle to the device context of the destination window.
textReference to the desired text.
charsSelectionFlagCharacters selection mode, as defined by eVision.ESelectionFlag.

◆ DrawTextChars() [3/6]

None eVision.EOCV.DrawTextChars ( self,
eVision.EDrawAdapter | None graphicContext,
eVision.EOCVText text,
eVision.ESelectionFlag charsSelectionFlag,
float zoomX )

Draws a tight bounding box around all characters of a single text, possibly with the main diagonal where diagnostics occur.

Remarks:

The sample drawing methods are used to graphically represent the texts and text characters located in the image during inspection. All drawing operations are done using the current pen attributes. Normally, the characters and texts are drawn as a bounding box. However, when diagnostics have been raised on a character or text, the main diagonal (north west to south east) is drawn as well, indicating that the item is rejected.

Parameters
graphicContextHandle to the device context of the destination window.
textReference to the desired text.
charsSelectionFlagCharacters selection mode, as defined by eVision.ESelectionFlag.
zoomXZooming parameters.

◆ DrawTextChars() [4/6]

None eVision.EOCV.DrawTextChars ( self,
eVision.EDrawAdapter | None graphicContext,
eVision.EOCVText text,
eVision.ESelectionFlag charsSelectionFlag,
float zoomX,
float zoomY )

Draws a tight bounding box around all characters of a single text, possibly with the main diagonal where diagnostics occur.

Remarks:

The sample drawing methods are used to graphically represent the texts and text characters located in the image during inspection. All drawing operations are done using the current pen attributes. Normally, the characters and texts are drawn as a bounding box. However, when diagnostics have been raised on a character or text, the main diagonal (north west to south east) is drawn as well, indicating that the item is rejected.

Parameters
graphicContextHandle to the device context of the destination window.
textReference to the desired text.
charsSelectionFlagCharacters selection mode, as defined by eVision.ESelectionFlag.
zoomXZooming parameters.
zoomYZooming parameters.

◆ DrawTextChars() [5/6]

None eVision.EOCV.DrawTextChars ( self,
eVision.EDrawAdapter | None graphicContext,
eVision.EOCVText text,
eVision.ESelectionFlag charsSelectionFlag,
float zoomX,
float zoomY,
float originX )

Draws a tight bounding box around all characters of a single text, possibly with the main diagonal where diagnostics occur.

Remarks:

The sample drawing methods are used to graphically represent the texts and text characters located in the image during inspection. All drawing operations are done using the current pen attributes. Normally, the characters and texts are drawn as a bounding box. However, when diagnostics have been raised on a character or text, the main diagonal (north west to south east) is drawn as well, indicating that the item is rejected.

Parameters
graphicContextHandle to the device context of the destination window.
textReference to the desired text.
charsSelectionFlagCharacters selection mode, as defined by eVision.ESelectionFlag.
zoomXZooming parameters.
zoomYZooming parameters.
originXHorizontal panning value expressed in pixels. By default, no panning occurs.

◆ DrawTextChars() [6/6]

None eVision.EOCV.DrawTextChars ( self,
eVision.EDrawAdapter | None graphicContext,
eVision.EOCVText text,
eVision.ESelectionFlag charsSelectionFlag,
float zoomX,
float zoomY,
float originX,
float originY )

Draws a tight bounding box around all characters of a single text, possibly with the main diagonal where diagnostics occur.

Remarks:

The sample drawing methods are used to graphically represent the texts and text characters located in the image during inspection. All drawing operations are done using the current pen attributes. Normally, the characters and texts are drawn as a bounding box. However, when diagnostics have been raised on a character or text, the main diagonal (north west to south east) is drawn as well, indicating that the item is rejected.

Parameters
graphicContextHandle to the device context of the destination window.
textReference to the desired text.
charsSelectionFlagCharacters selection mode, as defined by eVision.ESelectionFlag.
zoomXZooming parameters.
zoomYZooming parameters.
originXHorizontal panning value expressed in pixels. By default, no panning occurs.
originYVertical panning value expressed in pixels. By default, no panning occurs.

◆ DrawTexts() [1/6]

None eVision.EOCV.DrawTexts ( self,
eVision.EDrawAdapter | None graphicContext )

Draws a tight bounding box around all texts, possibly with the main diagonal where diagnostics occur.

Remarks:

The sample drawing methods are used to graphically represent the texts and text characters located in the image during inspection. All drawing operations are done using the current pen attributes. Normally, the characters and texts are drawn as a bounding box. However, when diagnostics have been raised on a character or text, the main diagonal (north west to south east) is drawn as well, indicating that the item is rejected.

Parameters
graphicContextDevice context of the drawing window.

◆ DrawTexts() [2/6]

None eVision.EOCV.DrawTexts ( self,
eVision.EDrawAdapter | None graphicContext,
eVision.ESelectionFlag textsSelectionFlag )

Draws a tight bounding box around all texts, possibly with the main diagonal where diagnostics occur.

Remarks:

The sample drawing methods are used to graphically represent the texts and text characters located in the image during inspection. All drawing operations are done using the current pen attributes. Normally, the characters and texts are drawn as a bounding box. However, when diagnostics have been raised on a character or text, the main diagonal (north west to south east) is drawn as well, indicating that the item is rejected.

Parameters
graphicContextDevice context of the drawing window.
textsSelectionFlagTexts selection mode, as defined by eVision.ESelectionFlag.

◆ DrawTexts() [3/6]

None eVision.EOCV.DrawTexts ( self,
eVision.EDrawAdapter | None graphicContext,
eVision.ESelectionFlag textsSelectionFlag,
float zoomX )

Draws a tight bounding box around all texts, possibly with the main diagonal where diagnostics occur.

Remarks:

The sample drawing methods are used to graphically represent the texts and text characters located in the image during inspection. All drawing operations are done using the current pen attributes. Normally, the characters and texts are drawn as a bounding box. However, when diagnostics have been raised on a character or text, the main diagonal (north west to south east) is drawn as well, indicating that the item is rejected.

Parameters
graphicContextDevice context of the drawing window.
textsSelectionFlagTexts selection mode, as defined by eVision.ESelectionFlag.
zoomXZooming parameters.

◆ DrawTexts() [4/6]

None eVision.EOCV.DrawTexts ( self,
eVision.EDrawAdapter | None graphicContext,
eVision.ESelectionFlag textsSelectionFlag,
float zoomX,
float zoomY )

Draws a tight bounding box around all texts, possibly with the main diagonal where diagnostics occur.

Remarks:

The sample drawing methods are used to graphically represent the texts and text characters located in the image during inspection. All drawing operations are done using the current pen attributes. Normally, the characters and texts are drawn as a bounding box. However, when diagnostics have been raised on a character or text, the main diagonal (north west to south east) is drawn as well, indicating that the item is rejected.

Parameters
graphicContextDevice context of the drawing window.
textsSelectionFlagTexts selection mode, as defined by eVision.ESelectionFlag.
zoomXZooming parameters.
zoomYZooming parameters.

◆ DrawTexts() [5/6]

None eVision.EOCV.DrawTexts ( self,
eVision.EDrawAdapter | None graphicContext,
eVision.ESelectionFlag textsSelectionFlag,
float zoomX,
float zoomY,
float originX )

Draws a tight bounding box around all texts, possibly with the main diagonal where diagnostics occur.

Remarks:

The sample drawing methods are used to graphically represent the texts and text characters located in the image during inspection. All drawing operations are done using the current pen attributes. Normally, the characters and texts are drawn as a bounding box. However, when diagnostics have been raised on a character or text, the main diagonal (north west to south east) is drawn as well, indicating that the item is rejected.

Parameters
graphicContextDevice context of the drawing window.
textsSelectionFlagTexts selection mode, as defined by eVision.ESelectionFlag.
zoomXZooming parameters.
zoomYZooming parameters.
originXHorizontal panning value expressed in pixels. By default, no panning occurs.

◆ DrawTexts() [6/6]

None eVision.EOCV.DrawTexts ( self,
eVision.EDrawAdapter | None graphicContext,
eVision.ESelectionFlag textsSelectionFlag,
float zoomX,
float zoomY,
float originX,
float originY )

Draws a tight bounding box around all texts, possibly with the main diagonal where diagnostics occur.

Remarks:

The sample drawing methods are used to graphically represent the texts and text characters located in the image during inspection. All drawing operations are done using the current pen attributes. Normally, the characters and texts are drawn as a bounding box. However, when diagnostics have been raised on a character or text, the main diagonal (north west to south east) is drawn as well, indicating that the item is rejected.

Parameters
graphicContextDevice context of the drawing window.
textsSelectionFlagTexts selection mode, as defined by eVision.ESelectionFlag.
zoomXZooming parameters.
zoomYZooming parameters.
originXHorizontal panning value expressed in pixels. By default, no panning occurs.
originYVertical panning value expressed in pixels. By default, no panning occurs.

◆ DrawTextsChars() [1/7]

None eVision.EOCV.DrawTextsChars ( self,
eVision.EDrawAdapter | None graphicContext )

Draws a tight bounding box around all characters of all texts.

Remarks:

The sample drawing methods are used to graphically represent the texts and text characters located in the image during inspection. All drawing operations are done using the current pen attributes. Normally, the characters and texts are drawn as a bounding box. However, when diagnostics have been raised on a character or text, the main diagonal (north west to south east) is drawn as well, indicating that the item is rejected.

Parameters
graphicContextDevice context of the drawing window.

◆ DrawTextsChars() [2/7]

None eVision.EOCV.DrawTextsChars ( self,
eVision.EDrawAdapter | None graphicContext,
eVision.ESelectionFlag textsSelectionFlag )

Draws a tight bounding box around all characters of all texts.

Remarks:

The sample drawing methods are used to graphically represent the texts and text characters located in the image during inspection. All drawing operations are done using the current pen attributes. Normally, the characters and texts are drawn as a bounding box. However, when diagnostics have been raised on a character or text, the main diagonal (north west to south east) is drawn as well, indicating that the item is rejected.

Parameters
graphicContextDevice context of the drawing window.
textsSelectionFlagTexts selection mode, as defined by eVision.ESelectionFlag.

◆ DrawTextsChars() [3/7]

None eVision.EOCV.DrawTextsChars ( self,
eVision.EDrawAdapter | None graphicContext,
eVision.ESelectionFlag textsSelectionFlag,
eVision.ESelectionFlag charsSelectionFlag )

Draws a tight bounding box around all characters of all texts.

Remarks:

The sample drawing methods are used to graphically represent the texts and text characters located in the image during inspection. All drawing operations are done using the current pen attributes. Normally, the characters and texts are drawn as a bounding box. However, when diagnostics have been raised on a character or text, the main diagonal (north west to south east) is drawn as well, indicating that the item is rejected.

Parameters
graphicContextDevice context of the drawing window.
textsSelectionFlagTexts selection mode, as defined by eVision.ESelectionFlag.
charsSelectionFlagCharacters selection mode, as defined by eVision.ESelectionFlag.

◆ DrawTextsChars() [4/7]

None eVision.EOCV.DrawTextsChars ( self,
eVision.EDrawAdapter | None graphicContext,
eVision.ESelectionFlag textsSelectionFlag,
eVision.ESelectionFlag charsSelectionFlag,
float zoomX )

Draws a tight bounding box around all characters of all texts.

Remarks:

The sample drawing methods are used to graphically represent the texts and text characters located in the image during inspection. All drawing operations are done using the current pen attributes. Normally, the characters and texts are drawn as a bounding box. However, when diagnostics have been raised on a character or text, the main diagonal (north west to south east) is drawn as well, indicating that the item is rejected.

Parameters
graphicContextDevice context of the drawing window.
textsSelectionFlagTexts selection mode, as defined by eVision.ESelectionFlag.
charsSelectionFlagCharacters selection mode, as defined by eVision.ESelectionFlag.
zoomXZooming parameters.

◆ DrawTextsChars() [5/7]

None eVision.EOCV.DrawTextsChars ( self,
eVision.EDrawAdapter | None graphicContext,
eVision.ESelectionFlag textsSelectionFlag,
eVision.ESelectionFlag charsSelectionFlag,
float zoomX,
float zoomY )

Draws a tight bounding box around all characters of all texts.

Remarks:

The sample drawing methods are used to graphically represent the texts and text characters located in the image during inspection. All drawing operations are done using the current pen attributes. Normally, the characters and texts are drawn as a bounding box. However, when diagnostics have been raised on a character or text, the main diagonal (north west to south east) is drawn as well, indicating that the item is rejected.

Parameters
graphicContextDevice context of the drawing window.
textsSelectionFlagTexts selection mode, as defined by eVision.ESelectionFlag.
charsSelectionFlagCharacters selection mode, as defined by eVision.ESelectionFlag.
zoomXZooming parameters.
zoomYZooming parameters.

◆ DrawTextsChars() [6/7]

None eVision.EOCV.DrawTextsChars ( self,
eVision.EDrawAdapter | None graphicContext,
eVision.ESelectionFlag textsSelectionFlag,
eVision.ESelectionFlag charsSelectionFlag,
float zoomX,
float zoomY,
float originX )

Draws a tight bounding box around all characters of all texts.

Remarks:

The sample drawing methods are used to graphically represent the texts and text characters located in the image during inspection. All drawing operations are done using the current pen attributes. Normally, the characters and texts are drawn as a bounding box. However, when diagnostics have been raised on a character or text, the main diagonal (north west to south east) is drawn as well, indicating that the item is rejected.

Parameters
graphicContextDevice context of the drawing window.
textsSelectionFlagTexts selection mode, as defined by eVision.ESelectionFlag.
charsSelectionFlagCharacters selection mode, as defined by eVision.ESelectionFlag.
zoomXZooming parameters.
zoomYZooming parameters.
originXHorizontal panning value expressed in pixels. By default, no panning occurs.

◆ DrawTextsChars() [7/7]

None eVision.EOCV.DrawTextsChars ( self,
eVision.EDrawAdapter | None graphicContext,
eVision.ESelectionFlag textsSelectionFlag,
eVision.ESelectionFlag charsSelectionFlag,
float zoomX,
float zoomY,
float originX,
float originY )

Draws a tight bounding box around all characters of all texts.

Remarks:

The sample drawing methods are used to graphically represent the texts and text characters located in the image during inspection. All drawing operations are done using the current pen attributes. Normally, the characters and texts are drawn as a bounding box. However, when diagnostics have been raised on a character or text, the main diagonal (north west to south east) is drawn as well, indicating that the item is rejected.

Parameters
graphicContextDevice context of the drawing window.
textsSelectionFlagTexts selection mode, as defined by eVision.ESelectionFlag.
charsSelectionFlagCharacters selection mode, as defined by eVision.ESelectionFlag.
zoomXZooming parameters.
zoomYZooming parameters.
originXHorizontal panning value expressed in pixels. By default, no panning occurs.
originYVertical panning value expressed in pixels. By default, no panning occurs.

◆ Dump()

None eVision.EOCV.Dump ( self)

◆ FreeCharCount()

int eVision.EOCV.FreeCharCount ( self)

Return the number of free characters of the OCV context.

◆ GatherTextsCharsParameters()

None eVision.EOCV.GatherTextsCharsParameters ( self,
eVision.EOCVChar ocvChar,
eVision.ESelectionFlag textsSelectionFlag,
eVision.ESelectionFlag charsSelectionFlag )

Copies the parameters from the characters specified by the selection modes to the temporary character.

Remarks:

For each character parameter that has a unique value among the specified characters, the corresponding value is different from undefined. Always be sure to check that a returned parameter does not have such an undefined value assigned, otherwise its contents will appear meaningless.

Parameters
ocvCharTemporary EOCVChar object.
textsSelectionFlagSelection mode for the texts, as defined by eVision.ESelectionFlag.
charsSelectionFlagSelection mode for the text characters, as defined by eVision.ESelectionFlag.

◆ GatherTextsParameters()

None eVision.EOCV.GatherTextsParameters ( self,
eVision.EOCVText Text,
eVision.ESelectionFlag textsSelectionFlag )

Copies the parameters from the texts specified by the selection mode to the temporary text.

Remarks:

For each text parameter that has a unique value among the specified texts, the corresponding value is different from undefined. Always be sure to check that a returned parameter does not have such an undefined value assigned, otherwise its contents will appear meaningless.

Parameters
TextSelection mode for the texts, as defined by eVision.ESelectionFlag.
textsSelectionFlagTemporary eVision.EOCVText object.

◆ GetFreeChar()

eVision.EOCVChar eVision.EOCV.GetFreeChar ( self,
int index )

Gets an individual free character of the OCV context.

Remarks:

The free characters are sets of blobs taken from the free objects list. One step of the model definition is to specify which free objects will be handled by the OCV context, and how they will be grouped to form characters. Grouping can be done automatically by using a overlapping criterion, or explicitly. When an object is added to a character, it is removed from the free objects list.

Parameters
indexIndex of the individual free character.

◆ GetNumTextChars()

int eVision.EOCV.GetNumTextChars ( self,
int index )

Returns the number of characters in this OCV context.

Remarks:

The characters are numbered from 0 to NumTextChars excluded.

Parameters
indexIndex of the desired text, in range 0 to NumTexts-1.

◆ GetText()

eVision.EOCVText eVision.EOCV.GetText ( self,
int index )

Returns an individual text of the OCV context.

Parameters
indexIndex, between 0 and eVision.EOCV.NumTexts (excluded) of the text to be accessed.

◆ GetTextCharParameters()

None eVision.EOCV.GetTextCharParameters ( self,
eVision.EOCVChar ocvChar,
int textIndex,
int charIndex )

Copies the parameters from the character of given index to the temporary character.

Remarks:

For each character parameter retrieved, the corresponding value is different from undefined. Always be sure to check that a returned parameter does not have such an undefined value assigned, otherwise its contents will appear meaningless.

Parameters
ocvCharTemporary EOCVChar object.
textIndexCharacter index in range 0 to NumTexts-1.
charIndexCharacter index in range 0 to NumTextChars-1.

◆ GetTextParameters()

None eVision.EOCV.GetTextParameters ( self,
eVision.EOCVText Text,
int textIndex )

Copies the parameters from the text of given index to the temporary text.

Remarks:

For each text parameter retrieved, the corresponding value is different from undefined. Always be sure to check that a returned parameter does not have such an undefined value assigned, otherwise its contents will appear meaningless.

Parameters
TextText index in range 0 to NumTexts, excluded.
textIndexText index in range 0 to NumTexts, excluded.

◆ Inspect()

None eVision.EOCV.Inspect ( self,
eVision.EROIBW8 | None sampleImage,
int threshold )

Inspection is the process that locates the template in the sample image using all allowed degrees of freedom, compares both images to detects and quantify defects.

Remarks:

After inspection, all defective texts and text characters are selected. Further, the Diagnostics binary mask contain a detailed interpretation of the defects found. A few options can be tuned to speed up the inspection process (see Location Options and Inspection Options).

Parameters
sampleImagePointer to the image/ROI to be inspected. The center of this image serves as a reference point on which the center of the template image is aligned.
thresholdThreshold level suitable for the sample image. The same convention as that of ImgThreshold is used for automatic thresholding.

◆ Learn() [1/3]

None eVision.EOCV.Learn ( self,
eVision.EROIBW8 | None image )

Pre-processes the model so that all required internal data structures are set up.

Remarks:

After learning, the model may not be edited anymore. It can be saved for later use and becomes ready for the inspection task. Learning is the final step of the model editing.

Parameters
imagePointer to the template image/ROI.

◆ Learn() [2/3]

None eVision.EOCV.Learn ( self,
eVision.EROIBW8 | None image,
eVision.ESelectionFlag textsSelectionFlag )

Pre-processes the model so that all required internal data structures are set up.

Remarks:

After learning, the model may not be edited anymore. It can be saved for later use and becomes ready for the inspection task. Learning is the final step of the model editing.

Parameters
imagePointer to the template image/ROI.
textsSelectionFlagTexts selection mode, as defined by eVision.ESelectionFlag.

◆ Learn() [3/3]

None eVision.EOCV.Learn ( self,
eVision.EROIBW8 | None image,
eVision.ESelectionFlag textsSelectionFlag,
eVision.ESelectionFlag charsSelectionFlag )

Pre-processes the model so that all required internal data structures are set up.

Remarks:

After learning, the model may not be edited anymore. It can be saved for later use and becomes ready for the inspection task. Learning is the final step of the model editing.

Parameters
imagePointer to the template image/ROI.
textsSelectionFlagTexts selection mode, as defined by eVision.ESelectionFlag.
charsSelectionFlagCharacters selection mode, as defined by eVision.ESelectionFlag.

◆ Load() [1/2]

None eVision.EOCV.Load ( self,
eVision.ESerializer | None serializer )

Loads the eVision.EOCV.

The given eVision.ESerializer must have been created for reading.

Parameters
serializerThe serializer.

◆ Load() [2/2]

None eVision.EOCV.Load ( self,
str path )

Loads the eVision.EOCV.

The given eVision.ESerializer must have been created for reading.

Parameters
pathThe file path.

◆ LocationMode() [1/2]

eVision.ELocationMode eVision.EOCV.LocationMode ( self)

Kind of pre-processing should be applied to the sample image, as defined by eVision.ELocationMode.

Remarks:

The location process is an important phase of the inspection task. It allows the OCV context to accurately find the template position in the sample image, using all allowed degrees of freedom. This process can be tuned in several ways to trade speed for robustness.

◆ LocationMode() [2/2]

eVision.EOCV.LocationMode ( self,
eVision.ELocationMode value )

Kind of pre-processing should be applied to the sample image, as defined by eVision.ELocationMode.

Remarks:

The location process is an important phase of the inspection task. It allows the OCV context to accurately find the template position in the sample image, using all allowed degrees of freedom. This process can be tuned in several ways to trade speed for robustness.

◆ NormalizeLocationScore() [1/2]

bool eVision.EOCV.NormalizeLocationScore ( self)

Current location score normalization mode.

Remarks:

Location score normalization performs a score correction, using the sample and template reference gray levels. It is intended to correct potential contrast or intensity discrepancies between template and sample images. It acts as if the sample image had the same foreground and background reference gray levels than the template image. It is recommended to turn this option on if the acquisition conditions can change from one sample to another. However, the correction may have a bad effect if the image acquisition system (camera) uses gamma correction, or the acquired image is saturated. The location score normalization mode is independent of the location score reduction mode.

◆ NormalizeLocationScore() [2/2]

eVision.EOCV.NormalizeLocationScore ( self,
bool value )

Current location score normalization mode.

Remarks:

Location score normalization performs a score correction, using the sample and template reference gray levels. It is intended to correct potential contrast or intensity discrepancies between template and sample images. It acts as if the sample image had the same foreground and background reference gray levels than the template image. It is recommended to turn this option on if the acquisition conditions can change from one sample to another. However, the correction may have a bad effect if the image acquisition system (camera) uses gamma correction, or the acquired image is saturated. The location score normalization mode is independent of the location score reduction mode.

◆ NumTexts()

int eVision.EOCV.NumTexts ( self)

Number of texts in the current OCV context.

Remarks:

The texts are numbered from 0 to NumTexts-1.

◆ ReduceLocationScore() [1/2]

bool eVision.EOCV.ReduceLocationScore ( self)

Current location score reduction mode.

Remarks:

The location score is computed as a sum of gray-level values along the character contours. When the reduction mode is enabled (default), the location score is divided by the number of contour points, giving an average gray level, in range 0..255. The non-reduction mode is considered obsolete. The location score reduction mode is independent of the location score normalization mode.

◆ ReduceLocationScore() [2/2]

eVision.EOCV.ReduceLocationScore ( self,
bool value )

Current location score reduction mode.

Remarks:

The location score is computed as a sum of gray-level values along the character contours. When the reduction mode is enabled (default), the location score is divided by the number of contour points, giving an average gray level, in range 0..255. The non-reduction mode is considered obsolete. The location score reduction mode is independent of the location score normalization mode.

◆ ResampleChars() [1/2]

bool eVision.EOCV.ResampleChars ( self)

Character resampling mode.

Remarks:

Normally, when text is inspected with rotation, scaling and/or shearing, some resampling must be performed when computing the quality indicators on the separate characters. If the angles remain small and the scale factors remain very close to unity, this resampling can be avoided by setting this property to false.

◆ ResampleChars() [2/2]

eVision.EOCV.ResampleChars ( self,
bool value )

Character resampling mode.

Remarks:

Normally, when text is inspected with rotation, scaling and/or shearing, some resampling must be performed when computing the quality indicators on the separate characters. If the angles remain small and the scale factors remain very close to unity, this resampling can be avoided by setting this property to false.

◆ SampleBackground() [1/2]

float eVision.EOCV.SampleBackground ( self)

Reference background gray levels determined during inspection of the sample.

Remarks:

Image contrast is an important factor during both learning and inspection. The background and foreground information must be separated using an appropriate threshold, possibly determined automatically. After a threshold is given, the average gray level of the background and foreground areas are computed separately. These serve as reference gray levels to measure the image contrast and normalize the gray level quality indicators. The background and foreground reference gray levels are computed for both the template and sample images. They are used for contrast assessment as well as gray-level normalization.

◆ SampleBackground() [2/2]

eVision.EOCV.SampleBackground ( self,
float value )

Reference background gray levels determined during inspection of the sample.

Remarks:

Image contrast is an important factor during both learning and inspection. The background and foreground information must be separated using an appropriate threshold, possibly determined automatically. After a threshold is given, the average gray level of the background and foreground areas are computed separately. These serve as reference gray levels to measure the image contrast and normalize the gray level quality indicators. The background and foreground reference gray levels are computed for both the template and sample images. They are used for contrast assessment as well as gray-level normalization.

◆ SampleContrast()

float eVision.EOCV.SampleContrast ( self)

Global contrast of the last inspected image, or FLOAT32_UNDEFINED if it has not been computed.

Remarks:

The contrast is defined as the ratio of the reference gray-levels difference over their sum. This parameter is maximum (100 %) for a perfectly contrasted image (white on black).

◆ SampleForeground() [1/2]

float eVision.EOCV.SampleForeground ( self)

Reference foreground gray levels determined during inspection of the sample.

Remarks:

Image contrast is an important factor during both learning and inspection. The background and foreground information must be separated using an appropriate threshold, possibly determined automatically. After a threshold is given, the average gray level of the background and foreground areas are computed separately. These serve as reference gray levels to measure the image contrast and normalize the gray level quality indicators. The background and foreground reference gray levels are computed for both the template and sample images. They are used for contrast assessment as well as gray-level normalization.

◆ SampleForeground() [2/2]

eVision.EOCV.SampleForeground ( self,
float value )

Reference foreground gray levels determined during inspection of the sample.

Remarks:

Image contrast is an important factor during both learning and inspection. The background and foreground information must be separated using an appropriate threshold, possibly determined automatically. After a threshold is given, the average gray level of the background and foreground areas are computed separately. These serve as reference gray levels to measure the image contrast and normalize the gray level quality indicators. The background and foreground reference gray levels are computed for both the template and sample images. They are used for contrast assessment as well as gray-level normalization.

◆ SampleThreshold() [1/2]

eVision.EBW8 eVision.EOCV.SampleThreshold ( self)

Threshold level applied to the sample during inspection.

Remarks:

Image contrast is an important factor during both learning and inspection. The background and foreground information must be separated using an appropriate threshold, possibly determined automatically. After a threshold is given, the average gray level of the background and foreground areas are computed separately. These serve as reference gray levels to measure the image contrast and normalize the gray level quality indicators. The background and foreground reference gray levels are computed for both the template and sample images. They are used for contrast assessment as well as gray-level normalization.

◆ SampleThreshold() [2/2]

eVision.EOCV.SampleThreshold ( self,
eVision.EBW8 value )

Threshold level applied to the sample during inspection.

Remarks:

Image contrast is an important factor during both learning and inspection. The background and foreground information must be separated using an appropriate threshold, possibly determined automatically. After a threshold is given, the average gray level of the background and foreground areas are computed separately. These serve as reference gray levels to measure the image contrast and normalize the gray level quality indicators. The background and foreground reference gray levels are computed for both the template and sample images. They are used for contrast assessment as well as gray-level normalization.

◆ Save() [1/2]

None eVision.EOCV.Save ( self,
eVision.ESerializer | None serializer )

Saves the eVision.EOCV.

The given eVision.ESerializer must have been created for writing.

Parameters
serializerThe serializer.

◆ Save() [2/2]

None eVision.EOCV.Save ( self,
str path )

Saves the eVision.EOCV.

The given eVision.ESerializer must have been created for writing.

Parameters
pathThe file path.

◆ ScatterTextsCharsParameters()

None eVision.EOCV.ScatterTextsCharsParameters ( self,
eVision.EOCVChar ocvChar,
eVision.ESelectionFlag textsSelectionFlag,
eVision.ESelectionFlag charsSelectionFlag )

Copies the desired parameters from the temporary character to the characters specified by the selection mode.

Remarks:

Only the parameters for which the value is not undefined are copied. Before setting parameters, be sure to call the EOCVChar.ResetParameters member of the temporary EOCVChar object. This will reset all parameters to the undefined value, thus avoiding unwanted copy.

Parameters
ocvCharTemporary EOCVChar object.
textsSelectionFlagSelection mode for the texts, as defined by eVision.ESelectionFlag.
charsSelectionFlagSelection mode for the text characters, as defined by eVision.ESelectionFlag.

◆ ScatterTextsParameters()

None eVision.EOCV.ScatterTextsParameters ( self,
eVision.EOCVText Text,
eVision.ESelectionFlag textsSelectionFlag )

Copies the desired parameters from the temporary text to the texts specified by the selection mode.

Remarks:

Only the parameters for which the value is not undefined value are copied. Before setting parameters, be sure to call the eVision.EOCVText.ResetParameters member of the temporary eVision.EOCVText object. This will reset all parameters to the undefined value, thus avoiding unwanted copy.

Parameters
TextSelection mode for the texts, as defined by eVision.ESelectionFlag.
textsSelectionFlagTemporary eVision.EOCVText object.

◆ SelectSampleTexts() [1/2]

None eVision.EOCV.SelectSampleTexts ( self,
int originX,
int originY,
int width,
int height )

Toggles selection of the template texts whose bounding box intersects a given rectangle.

Remarks:

Unselected become selected and conversely. Reading or changing properties of the sample texts and the characters they contain can be done on basis of selection.

Parameters
originXAbsolute coordinates of the selection rectangle (relative to the topmost parent image).
originYAbsolute coordinates of the selection rectangle (relative to the topmost parent image).
widthLimits of the selection rectangle.
heightLimits of the selection rectangle.

◆ SelectSampleTexts() [2/2]

None eVision.EOCV.SelectSampleTexts ( self,
int originX,
int originY,
int width,
int height,
eVision.ESelectionFlag textsSelectionFlag )

Toggles selection of the template texts whose bounding box intersects a given rectangle.

Remarks:

Unselected become selected and conversely. Reading or changing properties of the sample texts and the characters they contain can be done on basis of selection.

Parameters
originXAbsolute coordinates of the selection rectangle (relative to the topmost parent image).
originYAbsolute coordinates of the selection rectangle (relative to the topmost parent image).
widthLimits of the selection rectangle.
heightLimits of the selection rectangle.
textsSelectionFlagSelection mode for the template texts, as defined by eVision.ESelectionFlag. By default, all texts are checked for intersection

◆ SelectSampleTextsChars() [1/3]

None eVision.EOCV.SelectSampleTextsChars ( self,
int originX,
int originY,
int width,
int height )

Toggles selection of the template text characters whose bounding box intersects a given rectangle.

Remarks:

Unselected become selected and conversely. Reading or changing properties of the sample texts and the characters they contain can be done on basis of selection.

Parameters
originXAbsolute coordinates of the selection rectangle (relative to the topmost parent image).
originYAbsolute coordinates of the selection rectangle (relative to the topmost parent image).
widthLimits of the selection rectangle.
heightLimits of the selection rectangle.

◆ SelectSampleTextsChars() [2/3]

None eVision.EOCV.SelectSampleTextsChars ( self,
int originX,
int originY,
int width,
int height,
eVision.ESelectionFlag textsSelectionFlag )

Toggles selection of the template text characters whose bounding box intersects a given rectangle.

Remarks:

Unselected become selected and conversely. Reading or changing properties of the sample texts and the characters they contain can be done on basis of selection.

Parameters
originXAbsolute coordinates of the selection rectangle (relative to the topmost parent image).
originYAbsolute coordinates of the selection rectangle (relative to the topmost parent image).
widthLimits of the selection rectangle.
heightLimits of the selection rectangle.
textsSelectionFlagSelection mode for the sample texts, as defined by eVision.ESelectionFlag. By default, all texts are checked for intersection

◆ SelectSampleTextsChars() [3/3]

None eVision.EOCV.SelectSampleTextsChars ( self,
int originX,
int originY,
int width,
int height,
eVision.ESelectionFlag textsSelectionFlag,
eVision.ESelectionFlag charsSelectionFlag )

Toggles selection of the template text characters whose bounding box intersects a given rectangle.

Remarks:

Unselected become selected and conversely. Reading or changing properties of the sample texts and the characters they contain can be done on basis of selection.

Parameters
originXAbsolute coordinates of the selection rectangle (relative to the topmost parent image).
originYAbsolute coordinates of the selection rectangle (relative to the topmost parent image).
widthLimits of the selection rectangle.
heightLimits of the selection rectangle.
textsSelectionFlagSelection mode for the sample texts, as defined by eVision.ESelectionFlag. By default, all texts are checked for intersection
charsSelectionFlagSelection mode for the sample text characters, as defined by eVision.ESelectionFlag. By default, all characters of all texts are checked for intersection.

◆ SelectTemplateChars() [1/2]

None eVision.EOCV.SelectTemplateChars ( self,
int originX,
int originY,
int width,
int height )

Toggles selection of the free characters whose bounding box intersects a given rectangle.

Remarks:

Unselected becomes selected and conversely. The free characters are sets of blobs taken from the free objects list. One step of the model definition is to specify which free objects will be handled by the OCV context and how they will be grouped to form characters. Grouping can be done automatically by using a overlapping criterion, or explicitly. When an object is added to a character, it is removed from the free objects list.

Parameters
originXAbsolute coordinates of the selection rectangle (relative to the topmost parent image).
originYAbsolute coordinates of the selection rectangle (relative to the topmost parent image).
widthLimits of the selection rectangle.
heightLimits of the selection rectangle.

◆ SelectTemplateChars() [2/2]

None eVision.EOCV.SelectTemplateChars ( self,
int originX,
int originY,
int width,
int height,
eVision.ESelectionFlag charsSelectionFlag )

Toggles selection of the free characters whose bounding box intersects a given rectangle.

Remarks:

Unselected becomes selected and conversely. The free characters are sets of blobs taken from the free objects list. One step of the model definition is to specify which free objects will be handled by the OCV context and how they will be grouped to form characters. Grouping can be done automatically by using a overlapping criterion, or explicitly. When an object is added to a character, it is removed from the free objects list.

Parameters
originXAbsolute coordinates of the selection rectangle (relative to the topmost parent image).
originYAbsolute coordinates of the selection rectangle (relative to the topmost parent image).
widthLimits of the selection rectangle.
heightLimits of the selection rectangle.
charsSelectionFlagSelection mode for the free characters, as defined by eVision.ESelectionFlag. By default, all free characters are processed.

◆ SelectTemplateObjects() [1/2]

None eVision.EOCV.SelectTemplateObjects ( self,
int originX,
int originY,
int width,
int height )

Toggles selection of the objects whose bounding box intersects a given rectangle.

Remarks:

Unselected becomes selected and conversely. The free objects are blobs built using a separate coded image. One step of the model definition is to specify which objects will be handled by the OCV context.

Parameters
originXAbsolute coordinates of the selection rectangle (relative to the topmost parent image).
originYAbsolute coordinates of the selection rectangle (relative to the topmost parent image).
widthLimits of the selection rectangle.
heightLimits of the selection rectangle.

◆ SelectTemplateObjects() [2/2]

None eVision.EOCV.SelectTemplateObjects ( self,
int originX,
int originY,
int width,
int height,
eVision.ESelectionFlag objectsSelectionFlag )

Toggles selection of the objects whose bounding box intersects a given rectangle.

Remarks:

Unselected becomes selected and conversely. The free objects are blobs built using a separate coded image. One step of the model definition is to specify which objects will be handled by the OCV context.

Parameters
originXAbsolute coordinates of the selection rectangle (relative to the topmost parent image).
originYAbsolute coordinates of the selection rectangle (relative to the topmost parent image).
widthLimits of the selection rectangle.
heightLimits of the selection rectangle.
objectsSelectionFlagSelection mode for the objects, as defined by eVision.ESelectionFlag. By default, all objects are processed.

◆ SelectTemplateTexts() [1/2]

None eVision.EOCV.SelectTemplateTexts ( self,
int originX,
int originY,
int width,
int height )

Toggles selection of the template texts whose bounding box intersects a given rectangle.

Remarks:

Unselected becomes selected and conversely. The template texts are sets of characters taken from the free characters list. One step of the model definition is to specify which free characters will be handled by the OCV context and how they will be grouped to form texts. Grouping must be done explicitly. When a character is added to a text, it is removed from the free characters list.

Parameters
originXAbsolute coordinates of the selection rectangle (relative to the topmost parent image).
originYAbsolute coordinates of the selection rectangle (relative to the topmost parent image).
widthLimits of the selection rectangle.
heightLimits of the selection rectangle.

◆ SelectTemplateTexts() [2/2]

None eVision.EOCV.SelectTemplateTexts ( self,
int originX,
int originY,
int width,
int height,
eVision.ESelectionFlag textsSelectionFlag )

Toggles selection of the template texts whose bounding box intersects a given rectangle.

Remarks:

Unselected becomes selected and conversely. The template texts are sets of characters taken from the free characters list. One step of the model definition is to specify which free characters will be handled by the OCV context and how they will be grouped to form texts. Grouping must be done explicitly. When a character is added to a text, it is removed from the free characters list.

Parameters
originXAbsolute coordinates of the selection rectangle (relative to the topmost parent image).
originYAbsolute coordinates of the selection rectangle (relative to the topmost parent image).
widthLimits of the selection rectangle.
heightLimits of the selection rectangle.
textsSelectionFlagSelection mode for the template texts, as defined by eVision.ESelectionFlag. By default, all texts are processed.

◆ SetFreeChar()

None eVision.EOCV.SetFreeChar ( self,
int index,
eVision.EOCVChar freeChar )

Sets an individual free character of the OCV context.

Remarks:

The free characters are sets of blobs taken from the free objects list. One step of the model definition is to specify which free objects will be handled by the OCV context, and how they will be grouped to form characters. Grouping can be done automatically by using a overlapping criterion, or explicitly. When an object is added to a character, it is removed from the free objects list.

Parameters
indexIndex of the individual free character.
freeCharNew free character.

◆ SetTemplateImage2()

None eVision.EOCV.SetTemplateImage2 ( self,
eVision.EROIBW8 | None templateImage,
eVision.EROIBW8 | None objectsImage )

◆ SetText()

None eVision.EOCV.SetText ( self,
int index,
eVision.EOCVText text )

Modifies the individual text at the given index by the given value.

Parameters
indexIndex, between 0 and eVision.EOCV.NumTexts (excluded) of the individual text to be modified.
textThe new text.

◆ SetTextCharParameters()

None eVision.EOCV.SetTextCharParameters ( self,
eVision.EOCVChar ocvChar,
int textIndex,
int charIndex )

Copies the desired parameters from the temporary character to the character of given index.

Remarks:

Only the parameters for which the value is not undefined are copied. Before setting parameters, be sure to call the EOCVChar.ResetParameters member of the temporary EOCVChar object. This will reset all parameters to the undefined value, thus avoiding unwanted copy.

Parameters
ocvCharTemporary EOCVChar object.
textIndexCharacter index in range 0 to NumTexts-1.
charIndexCharacter index in range 0 to NumTextChars-1.

◆ SetTextParameters()

None eVision.EOCV.SetTextParameters ( self,
eVision.EOCVText Text,
int textIndex )

Copies the desired parameters from the temporary text to the text of given index.

Remarks:

Only the parameters for which the value is not undefined value are copied. Before setting parameters, be sure to call the eVision.EOCVText.ResetParameters member of the temporary eVision.EOCVText object. This will reset all parameters to the undefined value, thus avoiding unwanted copy.

Parameters
TextText index in range 0 to NumTexts, excluded.
textIndexText index in range 0 to NumTexts, excluded.

◆ StatisticsCount()

int eVision.EOCV.StatisticsCount ( self)

Number of samples that have been taken into account in the statistics so far.

Remarks:

For averages to be computed, this member must amount to at least 1. For standard deviations to be computed, this member must amount to at least 2.

◆ TemplateBackground() [1/2]

float eVision.EOCV.TemplateBackground ( self)

Reference background gray levels determined during learning of the template.

Remarks:

Image contrast is an important factor during both learning and inspection. The background and foreground information must be separated using an appropriate threshold, possibly determined automatically. After a threshold is given, the average gray level of the background and foreground areas are computed separately. These serve as reference gray levels to measure the image contrast and normalize the gray level quality indicators. The background and foreground reference gray levels are computed for both the template and sample images. They are used for contrast assessment as well as gray-level normalization.

◆ TemplateBackground() [2/2]

eVision.EOCV.TemplateBackground ( self,
float value )

Reference background gray levels determined during learning of the template.

Remarks:

Image contrast is an important factor during both learning and inspection. The background and foreground information must be separated using an appropriate threshold, possibly determined automatically. After a threshold is given, the average gray level of the background and foreground areas are computed separately. These serve as reference gray levels to measure the image contrast and normalize the gray level quality indicators. The background and foreground reference gray levels are computed for both the template and sample images. They are used for contrast assessment as well as gray-level normalization.

◆ TemplateContrast()

float eVision.EOCV.TemplateContrast ( self)

Global contrast of the template image, or FLOAT32_UNDEFINED if it has not been computed.

Remarks:

The contrast is defined as the ratio of the reference gray-levels difference over their sum. This parameter is maximum (100 %) for a perfectly contrasted image (white on black).

◆ TemplateForeground() [1/2]

float eVision.EOCV.TemplateForeground ( self)

Reference foreground gray levels determined during learning of the template.

Remarks:

Image contrast is an important factor during both learning and inspection. The background and foreground information must be separated using an appropriate threshold, possibly determined automatically. After a threshold is given, the average gray level of the background and foreground areas are computed separately. These serve as reference gray levels to measure the image contrast and normalize the gray level quality indicators. The background and foreground reference gray levels are computed for both the template and sample images. They are used for contrast assessment as well as gray-level normalization.

◆ TemplateForeground() [2/2]

eVision.EOCV.TemplateForeground ( self,
float value )

Reference foreground gray levels determined during learning of the template.

Remarks:

Image contrast is an important factor during both learning and inspection. The background and foreground information must be separated using an appropriate threshold, possibly determined automatically. After a threshold is given, the average gray level of the background and foreground areas are computed separately. These serve as reference gray levels to measure the image contrast and normalize the gray level quality indicators. The background and foreground reference gray levels are computed for both the template and sample images. They are used for contrast assessment as well as gray-level normalization.

◆ TemplateImage() [1/2]

eVision.EROIBW8 | None eVision.EOCV.TemplateImage ( self)

Source template image associated to the OCV context during model edition.

Remarks:

This property must be set as a first step before any model edition operation. During edition, the source image should not be altered. Before learning, the OCV context must have access to the template image to pre-process it. After learning, the OCV context keeps an internal copy for comparison purposes.

◆ TemplateImage() [2/2]

eVision.EOCV.TemplateImage ( self,
eVision.EROIBW8 | None value )

Source template image associated to the OCV context during model edition.

Remarks:

This property must be set as a first step before any model edition operation. During edition, the source image should not be altered. Before learning, the OCV context must have access to the template image to pre-process it. After learning, the OCV context keeps an internal copy for comparison purposes.

◆ TemplateThreshold() [1/2]

eVision.EBW8 eVision.EOCV.TemplateThreshold ( self)

Threshold level applied to the template during learning.

Remarks:

Image contrast is an important factor during both learning and inspection. The background and foreground information must be separated using an appropriate threshold, possibly determined automatically. After a threshold is given, the average gray level of the background and foreground areas are computed separately. These serve as reference gray levels to measure the image contrast and normalize the gray level quality indicators. The background and foreground reference gray levels are computed for both the template and sample images. They are used for contrast assessment as well as gray-level normalization.

◆ TemplateThreshold() [2/2]

eVision.EOCV.TemplateThreshold ( self,
eVision.EBW8 value )

Threshold level applied to the template during learning.

Remarks:

Image contrast is an important factor during both learning and inspection. The background and foreground information must be separated using an appropriate threshold, possibly determined automatically. After a threshold is given, the average gray level of the background and foreground areas are computed separately. These serve as reference gray levels to measure the image contrast and normalize the gray level quality indicators. The background and foreground reference gray levels are computed for both the template and sample images. They are used for contrast assessment as well as gray-level normalization.

◆ UpdateStatistics()

None eVision.EOCV.UpdateStatistics ( self)

Adds the parameters of the last inspection to the statistics.

Remarks:

This function must be called explicitly for the current sample to be taken into account.

◆ UsedQualityIndicators() [1/2]

int eVision.EOCV.UsedQualityIndicators ( self)

Choice of quality indicators.

Remarks:

For efficiency reasons, the quality indicators can be computed on demand only. This property is the logical combination (bitwise OR) of the values in eVision.EQualityIndicator. When a bit is set in this mask, the corresponding feature is computed.

◆ UsedQualityIndicators() [2/2]

eVision.EOCV.UsedQualityIndicators ( self,
int value )

Choice of quality indicators.

Remarks:

For efficiency reasons, the quality indicators can be computed on demand only. This property is the logical combination (bitwise OR) of the values in eVision.EQualityIndicator. When a bit is set in this mask, the corresponding feature is computed.

◆ WhiteOnBlack() [1/2]

int eVision.EOCV.WhiteOnBlack ( self)

Flag indicating whether the learning and inspection steps use white characters on a black background, or black characters on a white background.

Remarks:

If true (default), the learning and inspection steps use white characters on a black background. If false, black characters on a white background are taken into account. It is important to note that this parameter affects the learning and the inspection steps. Moreover, the use of the "black characters on a white background" mode requires the choice of the correct ECodedImage class.

◆ WhiteOnBlack() [2/2]

eVision.EOCV.WhiteOnBlack ( self,
int value )

Flag indicating whether the learning and inspection steps use white characters on a black background, or black characters on a white background.

Remarks:

If true (default), the learning and inspection steps use white characters on a black background. If false, black characters on a white background are taken into account. It is important to note that this parameter affects the learning and the inspection steps. Moreover, the use of the "black characters on a white background" mode requires the choice of the correct ECodedImage class.