CogLineMax.Execute Method (ICogImage, ICogRegion, CogImage8Grey, Int32, Int32)

CogLineMax Execute Method (ICogImage, ICogRegion, CogImage8Grey, Int32, Int32)

Cognex VisionPro 9.22 SR1

Performs line finding on the supplied image. The inspection results are stored in a CogLineMaxResults object.

Namespace: Cognex.VisionPro.LineMax
Assembly: Cognex.VisionPro.LineMax (in Cognex.VisionPro.LineMax.dll) Version: 87.1.0.0

Syntax

C++

Copy to Clipboard Print

public CogLineMaxResults Execute(
	ICogImage inputImage,
	ICogRegion region,
	CogImage8Grey imageMask,
	int imageMaskOffsetX,
	int imageMaskOffsetY
)

public CogLineMaxResults Execute(
	ICogImage inputImage,
	ICogRegion region,
	CogImage8Grey imageMask,
	int imageMaskOffsetX,
	int imageMaskOffsetY
)

Public Function Execute ( 
	inputImage As ICogImage,
	region As ICogRegion,
	imageMask As CogImage8Grey,
	imageMaskOffsetX As Integer,
	imageMaskOffsetY As Integer
) As CogLineMaxResults

Public Function Execute ( 
	inputImage As ICogImage,
	region As ICogRegion,
	imageMask As CogImage8Grey,
	imageMaskOffsetX As Integer,
	imageMaskOffsetY As Integer
) As CogLineMaxResults

public:
CogLineMaxResults^ Execute(
	ICogImage^ inputImage, 
	ICogRegion^ region, 
	CogImage8Grey^ imageMask, 
	int imageMaskOffsetX, 
	int imageMaskOffsetY
)

public:
CogLineMaxResults^ Execute(
	ICogImage^ inputImage, 
	ICogRegion^ region, 
	CogImage8Grey^ imageMask, 
	int imageMaskOffsetX, 
	int imageMaskOffsetY
)

Parameters

inputImage: Type: Cognex.VisionPro ICogImage
The input image to process. Must be a CogImage8Grey or a CogImage16Grey.

region: Type: Cognex.VisionPro ICogRegion
The region of inputImage to process. Only the pixels which lie within this region (subject to the value of RegionMode) will be considered. Supply null to process the entire image.

imageMask: Type: Cognex.VisionPro CogImage8Grey
An optional CogImage8Grey. If supplied, mask pixels having a zero value are considered "don't care"; those having a 255 value are considered "care". All other mask pixel values are undefined.

imageMaskOffsetX: Type: System Int32
The x offset used to align the imageMask pixels to the corresponding inputImage pixels.

imageMaskOffsetY: Type: System Int32
The y offset used to align the imageMask pixels to the corresponding inputImage pixels.

Return Value

Type: CogLineMaxResults
A CogLineMaxResults containing the found results.

Exceptions

Exception	Condition
CogSecurityViolationException	Required LineMax license not found. Required LineMax and LineMaxMulti licenses not found when MaxNumLines is greater than 1.
CogOperatorNoInputImageException	inputImage is null.
CogImageBadTypeException	inputImage is not a CogImage8Grey or a CogImage16Grey.
CogImageNoPixelsException	inputImage is not allocated.
CogOperatorInvalidRegionException	The selected space of region is not a valid space in inputImage.
CogOperatorInvalidRegionException	region is completely outside of inputImage.
CogSpaceTreeNameNotInTreeException	ExpectedLineNormal has a SelectedSpaceName that is not in the inputImage coordinate space tree.
CogSpaceTreeNameNotUniqueException	ExpectedLineNormal has a SelectedSpaceName that is not unique in the inputImage coordinate space tree.
CogSpaceTreeInvalidNameSyntaxException	ExpectedLineNormal has a SelectedSpaceName that is not a valid name format.
CogOperatorNoRunParamsException	EdgeDetectionParams is null.