Match Color Pattern (G Dataflow)

Reference to the color image in which you want to locate the color template image.

Reference to the color template to search during the matching phase.

The template image is an output of the Learn Color Pattern node.

Four-element array that contains the left, top, right, and bottom coordinates of the region to process.

The right and bottom values are exclusive and lie outside the region. The node applies the operation to the entire image if optional rectangle is empty or not connected.

String that contains information obtained from the Setup Match Color Pattern node.

If this input is not connected, the node uses default parameters during the matching phase.

Error conditions that occur before this node runs.

The node responds to this input according to standard error behavior.

Standard Error Behavior

Many nodes provide an error in input and an error out output so that the node can respond to and communicate errors that occur while code is running. The value of error in specifies whether an error occurred before the node runs. Most nodes respond to values of error in in a standard, predictable way.

error in does not contain an error	error in contains an error
If no error occurred before the node runs, the node begins execution normally. If no error occurs while the node runs, it returns no error. If an error does occur while the node runs, it returns that error information as error out.	If an error occurred before the node runs, the node does not execute. Instead, it returns the error in value as error out.

Default: No error

Number of valid matches expected.

Smallest score a match can have to be considered valid.

The data range for a match is between 0 and 1000.

Reference to the source image.

Array of match clusters.

Position

Point-coordinate cluster corresponding to the center of the template.

Angle

Rotation angle of the template in the source image at the current match location.

Scale

Change in percentage size of the matched template from the original template.

This parameter is not used for pattern matching and is always set to 1.

Score

Match results ranked on a scale of 0 to 1000, where 0 equals no match and 1000 equals a perfect match.

Bounding Box

Array of points that define the boundary of the template pattern in the image.

Connect this array directly to the Overlay Multiple Lines node to overlay the location of a match on the image.

Number of template matches found in the inspection image based on the input settings.

Error information.

The node produces this output according to standard error behavior.

Standard Error Behavior

Many nodes provide an error in input and an error out output so that the node can respond to and communicate errors that occur while code is running. The value of error in specifies whether an error occurred before the node runs. Most nodes respond to values of error in in a standard, predictable way.

error in does not contain an error	error in contains an error
If no error occurred before the node runs, the node begins execution normally. If no error occurs while the node runs, it returns no error. If an error does occur while the node runs, it returns that error information as error out.	If an error occurred before the node runs, the node does not execute. Instead, it returns the error in value as error out.