imaqCompareGoldenTemplate

NI Vision for LabWindows/CVI Function

imaqCompareGoldenTemplate

Usage

int imaqCompareGoldenTemplate(const Image* image, Image* goldenTemplate, Image* brightDefects, Image* darkDefects, const InspectionAlignment* alignment, const InspectionOptions* options);

Purpose

Compares the golden template to an image at a given alignment.

Image Types Supported

IMAQ_IMAGE_U8

Parameters

Name

Type

Description

image const Image* The image to inspect for defects.
goldenTemplate Image* The golden template to compare against image.
brightDefects Image* The destination image for bright defects, or both kinds of defects if the same image is also passed to darkDefects.
darkDefects Image* The destination image for dark defects.
alignment const InspectionAlignment* The alignment within image where the goldenTemplate is located. This parameter is required and cannot be NULL.
options const InspectionOptions* is a cluster specifying the golden template comparison.

Return Value

Type

Description

int On success, this function returns a non-zero value. On failure, this function returns 0. To get extended error information, call imaqGetLastError().

Parameter Discussion

options—Set options to NULL to use the default match options, as follows:

registrationMethod IMAQ_REGISTRATION_NONE
normalizationMethod IMAQ_NORMALIZATION_NONE
edgeThicknessToIgnore 0
brightThreshold 30
darkThreshold 30
binary TRUE