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

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

Cognex VisionPro 9.20

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

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

Syntax

C++

Copy to Clipboard Print

public CogLineMaxResults Execute(
	IEnumerable<ICogImage> inputImages,
	IEnumerable<ICogRegion> regions,
	IEnumerable<CogImage8Grey> imageMasks,
	IEnumerable<int> imageMaskOffsetXs,
	IEnumerable<int> imageMaskOffsetYs
)

public CogLineMaxResults Execute(
	IEnumerable<ICogImage> inputImages,
	IEnumerable<ICogRegion> regions,
	IEnumerable<CogImage8Grey> imageMasks,
	IEnumerable<int> imageMaskOffsetXs,
	IEnumerable<int> imageMaskOffsetYs
)

Public Function Execute ( 
	inputImages As IEnumerable(Of ICogImage),
	regions As IEnumerable(Of ICogRegion),
	imageMasks As IEnumerable(Of CogImage8Grey),
	imageMaskOffsetXs As IEnumerable(Of Integer),
	imageMaskOffsetYs As IEnumerable(Of Integer)
) As CogLineMaxResults

Public Function Execute ( 
	inputImages As IEnumerable(Of ICogImage),
	regions As IEnumerable(Of ICogRegion),
	imageMasks As IEnumerable(Of CogImage8Grey),
	imageMaskOffsetXs As IEnumerable(Of Integer),
	imageMaskOffsetYs As IEnumerable(Of Integer)
) As CogLineMaxResults

public:
CogLineMaxResults^ Execute(
	IEnumerable<ICogImage^>^ inputImages, 
	IEnumerable<ICogRegion^>^ regions, 
	IEnumerable<CogImage8Grey^>^ imageMasks, 
	IEnumerable<int>^ imageMaskOffsetXs, 
	IEnumerable<int>^ imageMaskOffsetYs
)

public:
CogLineMaxResults^ Execute(
	IEnumerable<ICogImage^>^ inputImages, 
	IEnumerable<ICogRegion^>^ regions, 
	IEnumerable<CogImage8Grey^>^ imageMasks, 
	IEnumerable<int>^ imageMaskOffsetXs, 
	IEnumerable<int>^ imageMaskOffsetYs
)

Parameters

inputImages: Type: System.Collections.Generic IEnumerable ICogImage
The images to process. Must contain one or more images and all images must be of type CogImage8Grey or CogImage16Grey, exclusive.

regions: Type: System.Collections.Generic IEnumerable ICogRegion
The regions of the inputImages to process. A null collection means all pixels of all images are processed. A null collection item means all pixels of the corresponding image are processed.

imageMasks: Type: System.Collections.Generic IEnumerable CogImage8Grey
A collection of masks. A null collection means none of the images are masked. A null collection item means the image at the corresponding index is not masked. Mask pixels having value zero are considered "don't care"; those having a 255 value are considered "care". All other mask pixel values are undefined.

imageMaskOffsetXs: Type: System.Collections.Generic IEnumerable Int32
A collection of mask x offsets. Each x offset in imageMaskOffsetXs applies to the mask at the corresponding index in masks.

imageMaskOffsetYs: Type: System.Collections.Generic IEnumerable Int32
A collection of mask y offsets. Each y offset in imageMaskOffsetYs applies to the mask at the corresponding index in masks.

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	inputImages is null, empty, or contains a null image.
CogImageBadTypeException	inputImages are not all CogImage8Grey or are not all CogImage16Grey.
CogImageNoPixelsException	inputImages contains an unallocated image.
CogOperatorInvalidRegionException	The selected space of a regions clip region is not a valid space of the corresponding inputImages image.
CogOperatorInvalidRegionException	One or more regions items are completely outside of the corresponding inputImages item.
CogSpaceTreeNameNotInTreeException	ExpectedLineNormal has a SelectedSpaceName that is not in one or more of the inputImages coordinate space trees.
CogSpaceTreeNameNotUniqueException	ExpectedLineNormal has a SelectedSpaceName that is not unique in one or more of the inputImages coordinate space trees.
CogSpaceTreeInvalidNameSyntaxException	ExpectedLineNormal has a SelectedSpaceName that is not a valid name format.
CogOperatorNoRunParamsException	EdgeDetectionParams is null.