DataMatrixSearchOptions
Specifies the search options the function uses when searching for the Data Matrix barcode in the image.
Elements
| Name | Type | Description |
|---|---|---|
| rotationMode | DataMatrixRotationMode | Specifies the amount of Data Matrix barcode rotation the function should allow for. |
| skipLocation | int | If set to TRUE, specifies that the function should assume that the Data Matrix barcode occupies the entire image (or the entire search region). The function then skips the location phase, moving immediately to extraction and decoding. If FALSE, the function does not make any assumptions about the percentage of the image occupied by the Data Matrix barcode. |
| edgeThreshold | unsigned int | Specifies the minimum contrast a pixel must have in order to be considered part of a matrix cell edge. The lower this value, the more potential edge candidates the function will examine during the location phase. Setting this value too low will decrease the performance of the function because the function will examine too many potential edge candidates. Setting this value too high may also decrease the performance of the function by removing valid edge candidates, making location require more iterations. Setting this value too high may also cause the function to fail to identify the Data Matrix barcode because too many candidates are eliminated. |
| demodulationMode | DataMatrixDemodulationMode | Specifies the mode the function should use to demodulate (determine which cells are on and which cells are off) the Data Matrix barcode. |
| cellSampleSize | DataMatrixCellSampleSize | Specifies the sample size, in pixels, the function should take to determine if each cell is on or off. |
| cellFilterMode | DataMatrixCellFilterMode | Specifies the mode the function uses to determine the pixel value for each cell. If cellSampleSize is IMAQ_1x1, the value of the single sampled pixel always determines the pixel value for the cell and the function ignores this element. |
| skewDegreesAllowed | unsigned int | Specifies the amount of skew in the Data Matrix barcode the function should allow for. |
| maxIterations | unsigned int | Specifies the maximum number of iterations before the function stops looking for the Data Matrix barcode. |
| initialSearchVectorWidth | unsigned int | Specifies the number of pixels the function should average together to determine the location of an edge. You may need to increase this value when the Data Matrix has cells with a low fill percentage. |