IMAQ Setup Match Color Pattern VI
Owning Palette: Searching and MatchingInstalled With: NI Vision Development ModuleSets parameters that are used during the color matching process. Run this VI before using the IMAQ Match Color Pattern VI.
Color Score Weight (between 0 and 1000) determines the percent contribution of the color score to the final color pattern matching score. The software uses the color score weight for the final match ranking. For example, if you use a weight of 1000, the algorithm finds each match by using both color and shape information and then ranks the matches based on their color scores. If the weight is 0, the matches are ranked based on their shape scores. The default is 500, indicating that the match score uses an equal combination of the color and shape scores. |
|||||||||
Minimum Contrast specifies the minimum expected difference between the maximum luminance value and the minimum luminance value of the color pixels in the inspection image. The default is 0, which allows the algorithm to compute the Minimum Contrast. |
|||||||||
Match Mode specifies the invariance mode to use when looking for the color template pattern in the inspection image. Choose from the following values:
|
|||||||||
Match Feature Mode specifies the features to use when looking for the color template pattern in the color image. The following values are valid:
|
|||||||||
Subpixel Accuracy determines whether to return the match results with subpixel accuracy. The default is FALSE. If Match Feature Mode is set to color, the VI ignores Subpixel Accuracy. |
|||||||||
Rotation Angle Ranges (degrees) is an array of angle ranges, where each range specifies how much you expect the color template to rotate in the inspection image. Specify a lower and upper angle, in degrees, for each range. |
|||||||||
error in (no error) describes the error status before this VI or function runs. The default is no error. If an error occurred before this VI or function runs, the VI or function passes the error in value to error out. This VI or function runs normally only if no error occurred before this VI or function runs. If an error occurs while this VI or function runs, it runs normally and sets its own error status in error out. Use the Simple Error Handler or General Error Handler VIs to display the description of the error code. Use error in and error out to check errors and to specify execution order by wiring error out from one node to error in of the next node.
|
|||||||||
Color Sensitivity specifies the sensitivity of the color information in the image. The default is Low. Set this option to High when you need to distinguish colors with close hue values. |
|||||||||
Search Strategy specifies how the color features of the image are used during the search phase. Choose from the following strategies:
|
|||||||||
Match Color Pattern Setup Data is a string that contains information about the setup parameters selected for the matching phase. Connect this output to the IMAQ Match Color Pattern VI. |
|||||||||
error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces. Right-click the error out indicator on the front panel and select Explain Error from the shortcut menu for more information about the error.
|
Examples
Refer to the following for examples that use this VI.
- LabVIEW\examples\Vision\2. Functions\Color Pattern Matching\Color Pattern Matching Example.llb
- LabVIEW\examples\Vision\3. Applications\Fusebox Inspection Example.llb