CellFilterMode Property

NI Vision for Visual Basic

CellFilterMode Property

Syntax

CWIMAQDataMatrixSearchOptions.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

Specifies the mode the method uses to determine the pixel value for each cell.

Remarks

If CellSampleSize is cwimaqDataMatrixCellSampleSize1x1, the value of the single sampled pixel always determines the pixel value for the cell and the method ignores this property. The default value is cwimaqDataMatrixCellFilterModeAutoDetect.