LineMaxOperator.Execute Method (IImageCollection, IRegionCollection, Image8GreyCollection, Int32Collection, Int32Collection)

LineMaxOperator Execute Method (IImageCollection, IRegionCollection, Image8GreyCollection, Int32Collection, Int32Collection)

Cognex VisionPro 9.22 SR1

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

Namespace: Cognex.Vision.LineMax
Assembly: Cognex.Vision.LineMax.Net (in Cognex.Vision.LineMax.Net.dll) Version: 9.22.2.0

Syntax

C++

Copy to Clipboard Print

public override LineMaxResults Execute(
	IImageCollection inputImages,
	IRegionCollection regions,
	Image8GreyCollection imageMasks,
	Int32Collection imageMaskOffsetXs,
	Int32Collection imageMaskOffsetYs
)

public override LineMaxResults Execute(
	IImageCollection inputImages,
	IRegionCollection regions,
	Image8GreyCollection imageMasks,
	Int32Collection imageMaskOffsetXs,
	Int32Collection imageMaskOffsetYs
)

Public Overrides Function Execute ( 
	inputImages As IImageCollection,
	regions As IRegionCollection,
	imageMasks As Image8GreyCollection,
	imageMaskOffsetXs As Int32Collection,
	imageMaskOffsetYs As Int32Collection
) As LineMaxResults

Public Overrides Function Execute ( 
	inputImages As IImageCollection,
	regions As IRegionCollection,
	imageMasks As Image8GreyCollection,
	imageMaskOffsetXs As Int32Collection,
	imageMaskOffsetYs As Int32Collection
) As LineMaxResults

public:
virtual LineMaxResults^ Execute(
	IImageCollection^ inputImages, 
	IRegionCollection^ regions, 
	Image8GreyCollection^ imageMasks, 
	Int32Collection^ imageMaskOffsetXs, 
	Int32Collection^ imageMaskOffsetYs
) override

public:
virtual LineMaxResults^ Execute(
	IImageCollection^ inputImages, 
	IRegionCollection^ regions, 
	Image8GreyCollection^ imageMasks, 
	Int32Collection^ imageMaskOffsetXs, 
	Int32Collection^ imageMaskOffsetYs
) override

Parameters

inputImages: Type: Cognex.Vision IImageCollection
The input images to process. Must be an IImageCollection of Image8Grey or a Image16Grey images.

regions: Type: Cognex.Vision IRegionCollection
The regions of inputImages to process. Only the pixels which lie within these regions (subject to the value of RegionMode ) will be considered. Supply null to process the entire image.

imageMasks: Type: Cognex.Vision Image8GreyCollection
An optional Image8GreyCollection. 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.

imageMaskOffsetXs: Type: Cognex.Vision Int32Collection
The x offsets used to align the imageMask pixels to the corresponding inputImage pixels.

imageMaskOffsetYs: Type: Cognex.Vision Int32Collection
The y offsets used to align the imageMask pixels to the corresponding inputImage pixels.

Return Value

Type: LineMaxResults

A LineMaxResults containing the found results.

Exceptions

Exception	Condition
SecurityViolationException	Required LineMax license not found. Required LineMax and LineMaxMulti licenses not found when MaxNumLines is greater than 1.
OperatorNoInputImageException	inputImages is null.
ImageException	inputImages is not an IImageCollection of Image8Grey or Image16Grey images.
ImageException	inputImages are not allocated.
OperatorInvalidRegionException	The selected space of region is not a valid space in inputImages.
OperatorInvalidRegionException	regions is completely outside of inputImages.
SpaceTreeException	ExpectedLineNormal has a SelectedSpaceName that is not in the inputImages coordinate space tree.
SpaceTreeException	ExpectedLineNormal has a SelectedSpaceName that is not unique in the inputImages coordinate space tree.
SpaceTreeException	ExpectedLineNormal has a SelectedSpaceName that is not a valid name format.
OperatorNoRunParamsException	EdgeDetectionParams is null.