CogSobelEdge.Execute Method

CogSobelEdge Execute Method

Cognex VisionPro 9.21

Perform Sobel edge detection on the specified region of the input image. Optionally post-process the Sobel angle and/or magnitude images. Resulting images are contained in the output Result object.

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

Syntax

C++

Copy to Clipboard Print

public CogSobelEdgeResult Execute(
	CogImage8Grey inputImage,
	ICogRegion region
)

public CogSobelEdgeResult Execute(
	CogImage8Grey inputImage,
	ICogRegion region
)

Public Function Execute ( 
	inputImage As CogImage8Grey,
	region As ICogRegion
) As CogSobelEdgeResult

Public Function Execute ( 
	inputImage As CogImage8Grey,
	region As ICogRegion
) As CogSobelEdgeResult

public:
CogSobelEdgeResult^ Execute(
	CogImage8Grey^ inputImage, 
	ICogRegion^ region
)

public:
CogSobelEdgeResult^ Execute(
	CogImage8Grey^ inputImage, 
	ICogRegion^ region
)

Parameters

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

region: Type: Cognex.VisionPro ICogRegion
An optional CogRegion. If supplied, only the pixels which lie within this region (subject to the value of RegionMode) will be analyzed.

Return Value

Type: CogSobelEdgeResult

An CogSobelEdgeResult containing the results of the analysis.

Exceptions

Exception	Condition
CogSecurityViolationException	Security is not enabled for this vision tool. See Resolving Security-Related Error Messages for more information.
CogOperatorNoInputImageException	inputImage is NULL
CogImageNoPixelsException	inputImage is not allocated.
CogImageBadSelectedSpaceNameException	The selected space name of the inputImage is not a valid name.
CogImageBadSelectedSpaceNameException	The selected space name of inputImage does not exist in the inputImage's space tree.
CogImageBadSelectedSpaceNameException	The selected space name of inputImage is not unique within the inputImage's space tree
CogOperatorInvalidRegionException	The selected space of region is not a valid space of inputImage.
CogOperatorInvalidRegionException	The selected space name of region is a nonqualified space name and more than one instance of it exists in the space tree of inputImage.
CogOperatorInvalidRegionException	The selected space name of region is not a legal space name.
CogOperatorInvalidRegionException	region falls completely outside of inputImage. Clipping of region is allowed.
ArgumentException	region is some region other than an CogRectangleAffine and the RegionMode is AffineTransform.

Remarks

Perform Sobel edge detection on the specified region of the inputImage, creating a CogSobelEdgeResult object that contains the output images. Optionally post-process the Sobel angle and edge magnitude images.