CogAffineTransform.Execute Method

CogAffineTransform Execute Method

Cognex VisionPro

Transforms a portion of the input image defined by an affine rectangle into a rectangular output image with a relative size determined by the ScalingX, ScalingY properties. If the Region parameter is Nothing then the whole input image is transformed.

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

Syntax

C++

Copy to Clipboard Print

public ICogImage Execute(
	ICogImage inputImage,
	CogRectangleAffine region,
	out ICogImage outputImageMask
)

public ICogImage Execute(
	ICogImage inputImage,
	CogRectangleAffine region,
	out ICogImage outputImageMask
)

Public Function Execute ( 
	inputImage As ICogImage,
	region As CogRectangleAffine,
	<OutAttribute> ByRef outputImageMask As ICogImage
) As ICogImage

Public Function Execute ( 
	inputImage As ICogImage,
	region As CogRectangleAffine,
	<OutAttribute> ByRef outputImageMask As ICogImage
) As ICogImage

public:
ICogImage^ Execute(
	ICogImage^ inputImage, 
	CogRectangleAffine^ region, 
	[OutAttribute] ICogImage^% outputImageMask
)

public:
ICogImage^ Execute(
	ICogImage^ inputImage, 
	CogRectangleAffine^ region, 
	[OutAttribute] ICogImage^% outputImageMask
)

Parameters

inputImage: Type: Cognex.VisionPro ICogImage
The InputImage to analyze.

region: Type: Cognex.VisionPro CogRectangleAffine
A CogRectangleAffine that specifies the region to be transformed.

outputImageMask: Type: Cognex.VisionPro ICogImage
An optional OutputImageMask, the same size as the OutputImage.

Return Value

Type: ICogImage

An CogImage containing the results of the image transformation.

Exceptions

Exception	Condition
ArgumentException	inputImage is NULL.
CogImageBadTypeException	inputImage does not support CogImage8Grey.
CogImageNoPixelsException	inputImage is not allocated.
CogImageClippedException	region is partly or entirely outside the image and ClipMode is Error.
CogIPAffineTransformZeroSizeException	The calculated output image was less than 1 pixel in either direction.
CogIPAffineTransformOverSizeException	The calculated output image was greater than 32767 pixels in either direction.
CogImageBadSelectedSpaceNameException	The selected space of inputImage is not a valid space of the inputImage's coordinate space tree.
CogImageBadSelectedSpaceNameException	The selected space name of inputImage is a nonqualified space name and more than one instance of it exists in the space tree of inputImage.
CogImageBadSelectedSpaceNameException	The selected space name of inputImage is not a legal space name
CogOperatorInvalidRegionException	The selected space of the region is not a valid space of inputImage.
CogOperatorInvalidRegionException	The selected space name of the regionis a nonqualified space name and more than one instance of it exists in the space tree of inputImage.
CogOperatorInvalidRegionException	The selected space name of the regionis not a legal space name.

Remarks

Transforms a portion of the input image defined by an CogRectangleAffine into a rectangular output image with a relative size determined by the ScalingX, ScalingY properties. If the region parameter is Nothing then the whole input image is transformed.