CellFilterMode Property

NI Vision for Visual Basic

CellFilterMode Property

Syntax

CWIMAQDataMatrixReport.CellFilterMode

Data Type

CWIMAQDataMatrixCellFilterModes

You can use the following constants with this data type:

  • cwimaqDataMatrixCellFilterModeAll—The method tries each filter mode, starting with cwimaqDataMatrixCellFilterModeAverage and ending with cwimaqDataMatrixCellFilterModeVeryLowAverage, stopping once a filter mode decodes correctly.
  • cwimaqDataMatrixCellFilterModeAutoDetect—The method will try all filter modes and uses the one that decodes the Data Matrix barcode within the fewest iterations and utilizing the least amount of error correction.
  • cwimaqDataMatrixCellFilterModeAverage—The method sets the pixel value for the cell to the average of the sampled pixels.
  • cwimaqDataMatrixCellFilterModeCentralAverage—The method sets the pixel value for the cell to the average of the pixels in the center of the cell sample.
  • cwimaqDataMatrixCellFilterModeHighAverage—The method sets the pixel value for the cell to the average value of the half of the sampled pixels with the highest pixel values.
  • cwimaqDataMatrixCellFilterModeLowAverage—The method sets the pixel value for the cell to the average value of the half of the sampled pixels with the lowest pixel values.
  • cwimaqDataMatrixCellFilterModeMedian—The method sets the pixel value for the cell to the median of the sampled pixels.
  • cwimaqDataMatrixCellFilterModeVeryHighAverage—The method sets the pixel value for the cell to the average value of the ninth of the sampled pixels with the highest pixel values.
  • cwimaqDataMatrixCellFilterModeVeryLowAverage—The method sets the pixel value for the cell to the average value of the ninth of the sampled pixels with the lowest pixel values.

Purpose

The cell filter mode the method used to locate the Data Matrix barcode.

Remarks

If CellFilterMode is set to cwimaqDataMatrixCellFilterModeAutoDetect in the DataMatrixSearchOptions input parameter, this property indicates the recommended cell filter mode for this image.