CogCopyRegion.ComputeDestinationRegion Method

CogCopyRegion ComputeDestinationRegion Method

Cognex VisionPro 9.7

Computes the SourceClipped, DestinationClipped and DestinationRegion values that would be returned by the Execute method, but does not copy any pixels.

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 ComputeDestinationRegion(
	ICogImage inputImage,
	ICogRegion region,
	ICogImage destinationImage,
	out bool sourceClipped,
	out bool destinationClipped,
	out ICogRegion destinationRegion
)

public void ComputeDestinationRegion(
	ICogImage inputImage,
	ICogRegion region,
	ICogImage destinationImage,
	out bool sourceClipped,
	out bool destinationClipped,
	out ICogRegion destinationRegion
)

Public Sub ComputeDestinationRegion ( 
	inputImage As ICogImage,
	region As ICogRegion,
	destinationImage As ICogImage,
	<OutAttribute> ByRef sourceClipped As Boolean,
	<OutAttribute> ByRef destinationClipped As Boolean,
	<OutAttribute> ByRef destinationRegion As ICogRegion
)

Public Sub ComputeDestinationRegion ( 
	inputImage As ICogImage,
	region As ICogRegion,
	destinationImage As ICogImage,
	<OutAttribute> ByRef sourceClipped As Boolean,
	<OutAttribute> ByRef destinationClipped As Boolean,
	<OutAttribute> ByRef destinationRegion As ICogRegion
)

public:
void ComputeDestinationRegion(
	ICogImage^ inputImage, 
	ICogRegion^ region, 
	ICogImage^ destinationImage, 
	[OutAttribute] bool% sourceClipped, 
	[OutAttribute] bool% destinationClipped, 
	[OutAttribute] ICogRegion^% destinationRegion
)

public:
void ComputeDestinationRegion(
	ICogImage^ inputImage, 
	ICogRegion^ region, 
	ICogImage^ destinationImage, 
	[OutAttribute] bool% sourceClipped, 
	[OutAttribute] bool% destinationClipped, 
	[OutAttribute] ICogRegion^% destinationRegion
)

Parameters

inputImage: Type: Cognex.VisionPro ICogImage
The input image.

region: Type: Cognex.VisionPro ICogRegion
The portion of inputImage to use. If NULL, the entire inputImage is used. Otherwise RegionMode specifies how the region is used.

destinationImage: Type: Cognex.VisionPro ICogImage
The destination image.

sourceClipped: Type: System Boolean
True if the inputImage was clipped. False otherwise.

destinationClipped: Type: System Boolean
True if the destinationImage was clipped. False otherwise.

destinationRegion: Type: Cognex.VisionPro ICogRegion
The input region mapped into the pixel space of the destinationImage . This shape is not clipped.

Exceptions

Exception	Condition
NullReferenceException	destinationRegion is NULL .
ArgumentException	Either FillRegion or FillBoundingBox is True and the value of either FillRegionValue or FillBoundingBoxValue is outside the range of valid values for inputImage (for example 0 to 255 for CogImage8Grey).
CogOperatorNoInputImageException	inputImage is NULL and (FillRegion = False or region = NULL).
CogImageNoPixelsException	inputImage is not allocated and (FillRegion = False or region = NULL).
CogSpaceTreeNotInTreeException	inputImage is not NULL and the selected space of region is not a valid space name in inputImage.

Remarks

Computes the destinationClipped and destinationRegion values that would be returned by the Execute(ICogImage, ICogRegion, ICogImage, Boolean , Boolean , ICogRegion ) method, but does not copy any pixels.