Represents the QR code reader, that is a context for the detection and decoding of QR codes, represented by EQRCode objects. More...


Public Member Functions | |
| EQRCodeReader () | |
| Creates an EQRCodeReader object. | |
| EQRCodeReader (eVision.EQRCodeReader other) | |
| Creates an EQRCodeReader object. | |
| eVision.EQRCodeGeometry[] | Detect () |
| eVision.EQRCode | Decode (eVision.EQRCodeGeometry geometry) |
| eVision.EQRCode[] | Read () |
| Detects and decodes all the QR codes in the search field. Returns them as EQRCode objects. | |
| eVision.EQRCode[] | Read (eVision.EROIBW8 roi) |
| Detects and decodes all the QR codes in the search field. Returns them as EQRCode objects. | |
| eVision.EQRCode[] | Read (eVision.EROIBW8 roi, eVision.ERegion region) |
| Detects and decodes all the QR codes in the search field. Returns them as EQRCode objects. | |
| eVision.EQRCode[] | Read (eVision.EROIBW8 roi, eVision.ERegion region, eVision.EFrame frame) |
| Detects and decodes all the QR codes in the search field. Returns them as EQRCode objects. | |
| eVision.EQRCode[] | Read (eVision.EROIBW8 roi, eVision.EFrame frame) |
| Detects and decodes all the QR codes in the search field. Returns them as EQRCode objects. | |
| eVision.EQRCodeGrid | Read (eVision.EROIBW8 roi, int numCellsX, int numCellsY, float extension) |
| Detects and decodes all the QR codes in the search field. Returns them as EQRCode objects. | |
| eVision.EQRCodeGrid | Read (eVision.EROIBW8 roi, int numCellsX, int numCellsY) |
| Detects and decodes all the QR codes in the search field. Returns them as EQRCode objects. | |
| eVision.EQRCodeGrid | Read (eVision.EROIBW8 roi, eVision.ERectangleRegion area, int numCellsX, int numCellsY, float extension) |
| Detects and decodes all the QR codes in the search field. Returns them as EQRCode objects. | |
| eVision.EQRCodeGrid | Read (eVision.EROIBW8 roi, eVision.ERectangleRegion area, int numCellsX, int numCellsY) |
| Detects and decodes all the QR codes in the search field. Returns them as EQRCode objects. | |
| eVision.EQRCodeGrid | Read (eVision.EROIBW8 roi, eVision.ERectangleRegion area, eVision.EQRCodeGrid grid, float extension) |
| Detects and decodes all the QR codes in the search field. Returns them as EQRCode objects. | |
| eVision.EQRCodeGrid | Read (eVision.EROIBW8 roi, eVision.ERectangleRegion area, eVision.EQRCodeGrid grid) |
| Detects and decodes all the QR codes in the search field. Returns them as EQRCode objects. | |
| eVision.EQRCodeGrid | Read (eVision.EROIBW8 roi, eVision.ERectangleRegion area, eVision.EFrame frame, int numCellsX, int numCellsY, float extension) |
| Detects and decodes all the QR codes in the search field. Returns them as EQRCode objects. | |
| eVision.EQRCodeGrid | Read (eVision.EROIBW8 roi, eVision.ERectangleRegion area, eVision.EFrame frame, int numCellsX, int numCellsY) |
| Detects and decodes all the QR codes in the search field. Returns them as EQRCode objects. | |
| eVision.EQRCodeGrid | Read (eVision.EROIBW8 roi, eVision.ERectangleRegion area, eVision.EFrame frame, eVision.EQRCodeGrid grid, float extension) |
| Detects and decodes all the QR codes in the search field. Returns them as EQRCode objects. | |
| eVision.EQRCodeGrid | Read (eVision.EROIBW8 roi, eVision.ERectangleRegion area, eVision.EFrame frame, eVision.EQRCodeGrid grid) |
| Detects and decodes all the QR codes in the search field. Returns them as EQRCode objects. | |
| eVision.EQRCodeGrid | Read (eVision.EROIBW8 roi, eVision.EGrid grid) |
| Detects and decodes all the QR codes in the search field. Returns them as EQRCode objects. | |
| eVision.EQRCodeGrid | Read (eVision.EROIBW8 roi, eVision.EGrid grid, eVision.EFrame frame) |
| Detects and decodes all the QR codes in the search field. Returns them as EQRCode objects. | |
| void | Load (string path) |
| Load the configuration for this EQRCodeReader instance. | |
| void | Load (eVision.ESerializer serializer) |
| Load the configuration for this EQRCodeReader instance. | |
| void | Save (string path) |
| Save the configuration for this EQRCodeReader instance. | |
| void | Save (eVision.ESerializer serializer) |
| Save the configuration for this EQRCodeReader instance. | |
Properties | |
| eVision.EROIBW8 | SearchField [set] |
| Search field for the QR code reader. | |
| eVision.EQRCodeScanPrecision | ScanPrecision [get, set] |
| Precision of the EQRCodeReader.EQRCodeReader when scanning the search field. | |
| eVision.EQRDetectionTradeOff | DetectionTradeOff [get, set] |
| This setting controls the trade-off between computation speed versus reliability of the algorithm and particularly of the detection methods. | |
| float | MinimumScore [get, set] |
| Minimum pattern finder score that must be reached to consider that a finder pattern has been found. | |
| float | MinimumIsotropy [get, set] |
| QR code minimum isotropy. | |
| eVision.EQRCodePerspectiveMode | PerspectiveMode [get, set] |
| int | DetectionMethod [get, set] |
| Sets the detection method for finding QR codes. The method can be any combination of the EQRDetectionMethod enums. | |
| int | ForegroundDetectionThreshold [get, set] |
| Foreground detection threshold. This parameter determines by how many grayscale-values a pixel should deviate from its local background to be considered part of the foreground. | |
| uint | AdaptiveThresholdHalfKernelSize [get, set] |
| Sets the half kernel size used to compute the threshold in EQRDetectionMethod.EQRDetectionMethod_AdaptiveThreshold. | |
| bool | ComputeAdaptiveThresholdHalfKernelSizeFromImage [get, set] |
| Sets whether the half kernel size used to compute the threshold in EQRDetectionMethod.EQRDetectionMethod_AdaptiveThreshold is computed from image size or set by EQRCodeReader.AdaptiveThresholdHalfKernelSize. | |
| bool | FilterOutUnreliablyDecodedQRCodes [get, set] |
| Activate or deactivate the filtering of unreliably decoded QR codes. | |
| float | CellPolarityConfidenceThreshold [get, set] |
| Sets the minimum cell polarity confidence threshold. | |
| bool | ComputeGrading [get, set] |
| Allows to choose whether the grading properties of the EQRCode object will be computed by the EQRCodeReader.Read method. The default setting for this property is false. | |
| eVision.EQRCodeModel[] | SearchedModels [get, set] |
| QR code models to be searched for. | |
| uint | MinimumVersion [get, set] |
| Minimum version of QR codes to be searched for. | |
| uint | MaximumVersion [get, set] |
| Maximum version of QR codes to be searched for. | |
| ulong | TimeOut [get, set] |
| Time-out for the EQRCodeReader.Read method. | |
| uint | MaxNumCodes [get, set] |
| Maximum number of QR codes to find in a single Image/ROI. | |
Represents the QR code reader, that is a context for the detection and decoding of QR codes, represented by EQRCode objects.
License(s): EasyQRCode
| eVision.EQRCodeReader.EQRCodeReader | ( | ) |
Creates an EQRCodeReader object.
| eVision.EQRCodeReader.EQRCodeReader | ( | eVision.EQRCodeReader | other | ) |
Creates an EQRCodeReader object.
| other | Another EQRCodeReader object to be copied in the new EQRCodeReader object. |
| eVision.EQRCode eVision.EQRCodeReader.Decode | ( | eVision.EQRCodeGeometry | geometry | ) |
| eVision.EQRCodeGeometry[] eVision.EQRCodeReader.Detect | ( | ) |
| void eVision.EQRCodeReader.Load | ( | eVision.ESerializer | serializer | ) |
Load the configuration for this EQRCodeReader instance.
| serializer | The given ESerializer, it must have been created for reading. |
| void eVision.EQRCodeReader.Load | ( | string | path | ) |
Load the configuration for this EQRCodeReader instance.
| path | The path from which to load the configuration. |
| eVision.EQRCode[] eVision.EQRCodeReader.Read | ( | ) |
Detects and decodes all the QR codes in the search field. Returns them as EQRCode objects.
The grid overload allows you to disable some cells of the grid if those cells are not supposed to contain QR Codes. See the EQRCodeGrid class documentation for more information.
Use the overload taking an EROIBW8 as parameter.
Deprecated in version 24.6. Scheduled to be removed in version 27.6.
| eVision.EQRCode[] eVision.EQRCodeReader.Read | ( | eVision.EROIBW8 | roi | ) |
Detects and decodes all the QR codes in the search field. Returns them as EQRCode objects.
| roi | The ROI in which the QR codes have to be found. |
The grid overload allows you to disable some cells of the grid if those cells are not supposed to contain QR Codes. See the EQRCodeGrid class documentation for more information.
| eVision.EQRCode[] eVision.EQRCodeReader.Read | ( | eVision.EROIBW8 | roi, |
| eVision.EFrame | frame ) |
Detects and decodes all the QR codes in the search field. Returns them as EQRCode objects.
| roi | The ROI in which the QR codes have to be found. |
| frame | Reference frame of the input image |
The grid overload allows you to disable some cells of the grid if those cells are not supposed to contain QR Codes. See the EQRCodeGrid class documentation for more information.
| eVision.EQRCodeGrid eVision.EQRCodeReader.Read | ( | eVision.EROIBW8 | roi, |
| eVision.EGrid | grid ) |
Detects and decodes all the QR codes in the search field. Returns them as EQRCode objects.
| roi | The ROI in which the QR codes have to be found. |
| grid | Grid with cell disabling capabilities |
The grid overload allows you to disable some cells of the grid if those cells are not supposed to contain QR Codes. See the EQRCodeGrid class documentation for more information.
| eVision.EQRCodeGrid eVision.EQRCodeReader.Read | ( | eVision.EROIBW8 | roi, |
| eVision.EGrid | grid, | ||
| eVision.EFrame | frame ) |
Detects and decodes all the QR codes in the search field. Returns them as EQRCode objects.
| roi | The ROI in which the QR codes have to be found. |
| grid | Grid with cell disabling capabilities |
| frame | Reference frame of the input image |
The grid overload allows you to disable some cells of the grid if those cells are not supposed to contain QR Codes. See the EQRCodeGrid class documentation for more information.
| eVision.EQRCodeGrid eVision.EQRCodeReader.Read | ( | eVision.EROIBW8 | roi, |
| eVision.ERectangleRegion | area, | ||
| eVision.EFrame | frame, | ||
| eVision.EQRCodeGrid | grid ) |
Detects and decodes all the QR codes in the search field. Returns them as EQRCode objects.
| roi | The ROI in which the QR codes have to be found. |
| area | Rectangular Region used as the full grid area |
| frame | Reference frame of the input image |
| grid | Grid with cell disabling capabilities |
The grid overload allows you to disable some cells of the grid if those cells are not supposed to contain QR Codes. See the EQRCodeGrid class documentation for more information.
Deprecated, use overloads taking an EGrid argument instead.
Deprecated in version 26.6. Scheduled to be removed in version 27.6.
| eVision.EQRCodeGrid eVision.EQRCodeReader.Read | ( | eVision.EROIBW8 | roi, |
| eVision.ERectangleRegion | area, | ||
| eVision.EFrame | frame, | ||
| eVision.EQRCodeGrid | grid, | ||
| float | extension ) |
Detects and decodes all the QR codes in the search field. Returns them as EQRCode objects.
| roi | The ROI in which the QR codes have to be found. |
| area | Rectangular Region used as the full grid area |
| frame | Reference frame of the input image |
| grid | Grid with cell disabling capabilities |
| extension | Extension of the grid cells to allow cell overlap. For instance, 0.0f means no extension and 0.1f means a 10% cell size extension. |
The grid overload allows you to disable some cells of the grid if those cells are not supposed to contain QR Codes. See the EQRCodeGrid class documentation for more information.
Deprecated, use overloads taking an EGrid argument instead.
Deprecated in version 26.6. Scheduled to be removed in version 27.6.
| eVision.EQRCodeGrid eVision.EQRCodeReader.Read | ( | eVision.EROIBW8 | roi, |
| eVision.ERectangleRegion | area, | ||
| eVision.EFrame | frame, | ||
| int | numCellsX, | ||
| int | numCellsY ) |
Detects and decodes all the QR codes in the search field. Returns them as EQRCode objects.
| roi | The ROI in which the QR codes have to be found. |
| area | Rectangular Region used as the full grid area |
| frame | Reference frame of the input image |
| numCellsX | Number of grid cells in the X direction |
| numCellsY | Number of grid cells in the Y direction |
The grid overload allows you to disable some cells of the grid if those cells are not supposed to contain QR Codes. See the EQRCodeGrid class documentation for more information.
Deprecated, use overloads taking an EGrid argument instead.
Deprecated in version 26.6. Scheduled to be removed in version 27.6.
| eVision.EQRCodeGrid eVision.EQRCodeReader.Read | ( | eVision.EROIBW8 | roi, |
| eVision.ERectangleRegion | area, | ||
| eVision.EFrame | frame, | ||
| int | numCellsX, | ||
| int | numCellsY, | ||
| float | extension ) |
Detects and decodes all the QR codes in the search field. Returns them as EQRCode objects.
| roi | The ROI in which the QR codes have to be found. |
| area | Rectangular Region used as the full grid area |
| frame | Reference frame of the input image |
| numCellsX | Number of grid cells in the X direction |
| numCellsY | Number of grid cells in the Y direction |
| extension | Extension of the grid cells to allow cell overlap. For instance, 0.0f means no extension and 0.1f means a 10% cell size extension. |
The grid overload allows you to disable some cells of the grid if those cells are not supposed to contain QR Codes. See the EQRCodeGrid class documentation for more information.
Deprecated, use overloads taking an EGrid argument instead.
Deprecated in version 26.6. Scheduled to be removed in version 27.6.
| eVision.EQRCodeGrid eVision.EQRCodeReader.Read | ( | eVision.EROIBW8 | roi, |
| eVision.ERectangleRegion | area, | ||
| eVision.EQRCodeGrid | grid ) |
Detects and decodes all the QR codes in the search field. Returns them as EQRCode objects.
| roi | The ROI in which the QR codes have to be found. |
| area | Rectangular Region used as the full grid area |
| grid | Grid with cell disabling capabilities |
The grid overload allows you to disable some cells of the grid if those cells are not supposed to contain QR Codes. See the EQRCodeGrid class documentation for more information.
Deprecated, use overloads taking an EGrid argument instead.
Deprecated in version 26.6. Scheduled to be removed in version 27.6.
| eVision.EQRCodeGrid eVision.EQRCodeReader.Read | ( | eVision.EROIBW8 | roi, |
| eVision.ERectangleRegion | area, | ||
| eVision.EQRCodeGrid | grid, | ||
| float | extension ) |
Detects and decodes all the QR codes in the search field. Returns them as EQRCode objects.
| roi | The ROI in which the QR codes have to be found. |
| area | Rectangular Region used as the full grid area |
| grid | Grid with cell disabling capabilities |
| extension | Extension of the grid cells to allow cell overlap. For instance, 0.0f means no extension and 0.1f means a 10% cell size extension. |
The grid overload allows you to disable some cells of the grid if those cells are not supposed to contain QR Codes. See the EQRCodeGrid class documentation for more information.
Deprecated, use overloads taking an EGrid argument instead.
Deprecated in version 26.6. Scheduled to be removed in version 27.6.
| eVision.EQRCodeGrid eVision.EQRCodeReader.Read | ( | eVision.EROIBW8 | roi, |
| eVision.ERectangleRegion | area, | ||
| int | numCellsX, | ||
| int | numCellsY ) |
Detects and decodes all the QR codes in the search field. Returns them as EQRCode objects.
| roi | The ROI in which the QR codes have to be found. |
| area | Rectangular Region used as the full grid area |
| numCellsX | Number of grid cells in the X direction |
| numCellsY | Number of grid cells in the Y direction |
The grid overload allows you to disable some cells of the grid if those cells are not supposed to contain QR Codes. See the EQRCodeGrid class documentation for more information.
Deprecated, use overloads taking an EGrid argument instead.
Deprecated in version 26.6. Scheduled to be removed in version 27.6.
| eVision.EQRCodeGrid eVision.EQRCodeReader.Read | ( | eVision.EROIBW8 | roi, |
| eVision.ERectangleRegion | area, | ||
| int | numCellsX, | ||
| int | numCellsY, | ||
| float | extension ) |
Detects and decodes all the QR codes in the search field. Returns them as EQRCode objects.
| roi | The ROI in which the QR codes have to be found. |
| area | Rectangular Region used as the full grid area |
| numCellsX | Number of grid cells in the X direction |
| numCellsY | Number of grid cells in the Y direction |
| extension | Extension of the grid cells to allow cell overlap. For instance, 0.0f means no extension and 0.1f means a 10% cell size extension. |
The grid overload allows you to disable some cells of the grid if those cells are not supposed to contain QR Codes. See the EQRCodeGrid class documentation for more information.
Deprecated, use overloads taking an EGrid argument instead.
Deprecated in version 26.6. Scheduled to be removed in version 27.6.
| eVision.EQRCode[] eVision.EQRCodeReader.Read | ( | eVision.EROIBW8 | roi, |
| eVision.ERegion | region ) |
Detects and decodes all the QR codes in the search field. Returns them as EQRCode objects.
| roi | The ROI in which the QR codes have to be found. |
| region | Region into the ROI where the qr codes have to be found. |
The grid overload allows you to disable some cells of the grid if those cells are not supposed to contain QR Codes. See the EQRCodeGrid class documentation for more information.
| eVision.EQRCode[] eVision.EQRCodeReader.Read | ( | eVision.EROIBW8 | roi, |
| eVision.ERegion | region, | ||
| eVision.EFrame | frame ) |
Detects and decodes all the QR codes in the search field. Returns them as EQRCode objects.
| roi | The ROI in which the QR codes have to be found. |
| region | Region into the ROI where the qr codes have to be found. |
| frame | Reference frame of the input image |
The grid overload allows you to disable some cells of the grid if those cells are not supposed to contain QR Codes. See the EQRCodeGrid class documentation for more information.
| eVision.EQRCodeGrid eVision.EQRCodeReader.Read | ( | eVision.EROIBW8 | roi, |
| int | numCellsX, | ||
| int | numCellsY ) |
Detects and decodes all the QR codes in the search field. Returns them as EQRCode objects.
| roi | The ROI in which the QR codes have to be found. |
| numCellsX | Number of grid cells in the X direction |
| numCellsY | Number of grid cells in the Y direction |
The grid overload allows you to disable some cells of the grid if those cells are not supposed to contain QR Codes. See the EQRCodeGrid class documentation for more information.
| eVision.EQRCodeGrid eVision.EQRCodeReader.Read | ( | eVision.EROIBW8 | roi, |
| int | numCellsX, | ||
| int | numCellsY, | ||
| float | extension ) |
Detects and decodes all the QR codes in the search field. Returns them as EQRCode objects.
| roi | The ROI in which the QR codes have to be found. |
| numCellsX | Number of grid cells in the X direction |
| numCellsY | Number of grid cells in the Y direction |
| extension | Extension of the grid cells to allow cell overlap. For instance, 0.0f means no extension and 0.1f means a 10% cell size extension. |
The grid overload allows you to disable some cells of the grid if those cells are not supposed to contain QR Codes. See the EQRCodeGrid class documentation for more information.
| void eVision.EQRCodeReader.Save | ( | eVision.ESerializer | serializer | ) |
Save the configuration for this EQRCodeReader instance.
| serializer | The given ESerializer, it must have been created for writing. |
| void eVision.EQRCodeReader.Save | ( | string | path | ) |
Save the configuration for this EQRCodeReader instance.
| path | The path to which to save the configuration. |
|
getset |
Sets the half kernel size used to compute the threshold in EQRDetectionMethod.EQRDetectionMethod_AdaptiveThreshold.
Default: 50.
Prior to eVision 26.10, this setting was computed from the image size, to get previous behavior, set EQRCodeReader.ComputeAdaptiveThresholdHalfKernelSizeFromImage to true.
|
getset |
Sets the minimum cell polarity confidence threshold.
When the cell confidence is under the threshold, additional processing is attempted to improve its polarity detection. The cell polarity confidence reflects the confidence in the cell digitization result, on a scale from 0 to 1. Increasing the threshold can improve reading of overprinted or underprinted QR codes. Default: 0.2f.
Large values can affect the speed and will increase the probability of false positive changes.
|
getset |
Sets whether the half kernel size used to compute the threshold in EQRDetectionMethod.EQRDetectionMethod_AdaptiveThreshold is computed from image size or set by EQRCodeReader.AdaptiveThresholdHalfKernelSize.
Default: false.
Prior to eVision 26.10, EQRCodeReader.AdaptiveThresholdHalfKernelSize was computed from the image size, to get previous behavior, set this to true.
|
getset |
Allows to choose whether the grading properties of the EQRCode object will be computed by the EQRCodeReader.Read method. The default setting for this property is false.
This setting is not available for Micro QR code symbols.
|
getset |
Sets the detection method for finding QR codes. The method can be any combination of the EQRDetectionMethod enums.
The default value is: 'EQRDetectionMethod.EQRDetectionMethod_Gradient | EQRDetectionMethod.EQRDetectionMethod_AdaptiveThreshold'.
|
getset |
This setting controls the trade-off between computation speed versus reliability of the algorithm and particularly of the detection methods.
Setting the trade-off will overwrite the current settings for EQRCodeScanPrecision and EQRDetectionMethod.
Available values are defined by EQRDetectionTradeOff. The default value is EQRDetectionTradeOff_Balanced.
|
getset |
Activate or deactivate the filtering of unreliably decoded QR codes.
By default, the QR code reader does not return unreliably decoded QR codes.
|
getset |
Foreground detection threshold. This parameter determines by how many grayscale-values a pixel should deviate from its local background to be considered part of the foreground.
In most cases, changing the value of this parameter is not required. A small threshold value may help to locate codes in low contrast images. If you think you might need to use this parameter, contact technical support for advice. The default value for this parameter is 10.
|
getset |
Maximum version of QR codes to be searched for.
This parameter value ranges from 1 to 40. Default value: 40.
|
getset |
Maximum number of QR codes to find in a single Image/ROI.
By default, this parameter is set to 1.
|
getset |
QR code minimum isotropy.
The isotropy of a QR code is defined as its short side divided by its long side.
This parameter value ranges from 0 to 1. Default value: 0.75.
|
getset |
Minimum pattern finder score that must be reached to consider that a finder pattern has been found.
The pattern finder score is based on a normalized correlation with a perfect finder pattern model.
A perfect match with the model would return a score of 1. This parameter value ranges from 0 to 1. Default value: 0.7.
|
getset |
Minimum version of QR codes to be searched for.
This parameter value ranges from 1 to 40. Default value: 1.
|
getset |
|
getset |
Precision of the EQRCodeReader.EQRCodeReader when scanning the search field.
Available values are defined by EQRCodeScanPrecision. The default value is EQRCodeScanPrecision_Automatic.
|
getset |
QR code models to be searched for.
By default, the QR code reader searches for EQRCodeModel.EQRCodeModel_Model1 and EQRCodeModel.EQRCodeModel_Model2.
|
set |
Search field for the QR code reader.
Use the EQRCodeReader.Read method taking an EROIBW8 as parameter.
Deprecated in version 24.6. Scheduled to be removed in version 27.6.
|
getset |
Time-out for the EQRCodeReader.Read method.
If the processing time of one of these functions becomes longer than the set time-out, the processing is stopped and an exception is thrown. In that case, the error code of the exception is EError.EError_TimeoutReached.
The time-out is set in microseconds.
This time-out is not a real time-out. The processing is stopped as soon as possible after the time-out has been reached. This means that the time elapsed effectively in the method can be greater than the time-out itself.