LineMaxOperator.Execute Method (IImage, IRegion, Image8Grey, Int32, Int32)

LineMaxOperator Execute Method (IImage, IRegion, Image8Grey, Int32, Int32)

Cognex VisionPro 9.22

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(
	IImage inputImage,
	IRegion region,
	Image8Grey imageMask,
	int imageMaskOffsetX,
	int imageMaskOffsetY
)

public override LineMaxResults Execute(
	IImage inputImage,
	IRegion region,
	Image8Grey imageMask,
	int imageMaskOffsetX,
	int imageMaskOffsetY
)

Public Overrides Function Execute ( 
	inputImage As IImage,
	region As IRegion,
	imageMask As Image8Grey,
	imageMaskOffsetX As Integer,
	imageMaskOffsetY As Integer
) As LineMaxResults

Public Overrides Function Execute ( 
	inputImage As IImage,
	region As IRegion,
	imageMask As Image8Grey,
	imageMaskOffsetX As Integer,
	imageMaskOffsetY As Integer
) As LineMaxResults

public:
virtual LineMaxResults^ Execute(
	IImage^ inputImage, 
	IRegion^ region, 
	Image8Grey^ imageMask, 
	int imageMaskOffsetX, 
	int imageMaskOffsetY
) override

public:
virtual LineMaxResults^ Execute(
	IImage^ inputImage, 
	IRegion^ region, 
	Image8Grey^ imageMask, 
	int imageMaskOffsetX, 
	int imageMaskOffsetY
) override

Parameters

inputImage: Type: Cognex.Vision IImage
The input image to process. Must be a Image8Grey or a Image16Grey.

region: Type: Cognex.Vision IRegion
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.Vision Image8Grey
An optional Image8Grey. 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: 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	inputImage is null.
ImageException	inputImage is not a Image8Grey or a Image16Grey.
ImageException	inputImage is not allocated.
OperatorInvalidRegionException	The selected space of region is not a valid space in inputImage.
OperatorInvalidRegionException	region is completely outside of inputImage.
SpaceTreeException	ExpectedLineNormal has a SelectedSpaceName that is not in the inputImage coordinate space tree.
SpaceTreeException	ExpectedLineNormal has a SelectedSpaceName that is not unique in the inputImage coordinate space tree.
SpaceTreeException	ExpectedLineNormal has a SelectedSpaceName that is not a valid name format.
OperatorNoRunParamsException	EdgeDetectionParams is null.