CogImageAverage.Add Method

CogImageAverage Add Method

Cognex VisionPro 9.7

Accumulate data from the supplied image.

Namespace: Cognex.VisionPro.ImageProcessing
Assembly: Cognex.VisionPro.ImageProcessing (in Cognex.VisionPro.ImageProcessing.dll) Version: 73.0.0.0

Syntax

C++

Copy to Clipboard Print

public void Add(
	CogImage8Grey inputImage,
	ICogRegion region
)

public void Add(
	CogImage8Grey inputImage,
	ICogRegion region
)

Public Sub Add ( 
	inputImage As CogImage8Grey,
	region As ICogRegion
)

Public Sub Add ( 
	inputImage As CogImage8Grey,
	region As ICogRegion
)

public:
void Add(
	CogImage8Grey^ inputImage, 
	ICogRegion^ region
)

public:
void Add(
	CogImage8Grey^ inputImage, 
	ICogRegion^ region
)

Parameters

inputImage: Type: Cognex.VisionPro CogImage8Grey
The InputImage to add to the average image and optional standard deviation image.

region: Type: Cognex.VisionPro ICogRegion
An optional CogImageAverage. By default, the tool uses the entire InputImage.

Events

Event Type	Reason
CogImageAverage Changed	Fires when this method executes. The following state flags may be affected: SfRegionMode SfStandardDeviationEnabled SfNumImages

Event Type

Reason

CogImageAverage Changed

Fires when this method executes.

The following state flags may be affected:

Exceptions

Exception	Condition
CogIPRegionSizeMismatchException	This is not the first call to CogImageAverage or the resulting number of pixels do not resolve to the same number of rows and columns as in previous calls to CogImageAverage.
CogOperatorNoInputImageException	inputImage is NULL.
CogImageNoPixelsException	inputImage is not allocated.
CogImageBadSelectedSpaceNameException	The selected space name of inputImage is not syntactically valid.
CogImageBadSelectedSpaceNameException	The selected space name of inputImage does not exist within its space tree.
CogImageBadSelectedSpaceNameException	The selected space name of inputImage is not unique within its space tree.
CogOperatorInvalidRegionException	The selected space name of region is not syntactically valid.
CogOperatorInvalidRegionException	The selected space name of region does not exist within its space tree.
CogOperatorInvalidRegionException	The selected space name of region is not unique within its space tree.
CogOperatorInvalidRegionException	region falls completely outside of inputImage. Clipping is allowed.
CogOperatorInvalidRegionException	region is not an CogRectangleAffine and RegionMode is AffineTransform.
CogOperatorInvalidRegionException	region is an CogRectangleAffine that is too close to the edge of inputImage.

Remarks

Adds the current InputImage and optional Region to the accumulator. If Region is Nothing then adds the entire image.