eVision Python API
Loading...
Searching...
No Matches
eVision.ECannyEdgeDetector Class Reference

Manages a complete context for the Canny edge detector. More...

Public Member Functions

None __init__ (self)
 Constructs a eVision.ECannyEdgeDetector object initialized to its default values.
None ResetSmoothingScale (self)
 Prevents the smoothing of the source image by a Gaussian filter.
None Apply (self, eVision.EROIBW8 source, eVision.EROIBW8 result)
 Apply the Canny edge detector on an image/ROI.
None Apply (self, eVision.EROIBW8 source, eVision.ERegion region, eVision.EROIBW8 result)
 Apply the Canny edge detector on an image/ROI.
None Apply (self, eVision.EROIBW8 source, eVision.ERegion region, eVision.EFrame frame, eVision.EROIBW8 result)
 Apply the Canny edge detector on an image/ROI.

Properties

 SmoothingScale = property(_SmoothingScale__getter, _SmoothingScale__setter)
 The scale of the features of interest.
 ThresholdingMode = property(_ThresholdingMode__getter, _ThresholdingMode__setter)
 Returns the mode of the hysteresis thresholding.
 LowThreshold = property(_LowThreshold__getter, _LowThreshold__setter)
 Returns the low hysteresis threshold for a pixel to be considered as an edge.
 HighThreshold = property(_HighThreshold__getter, _HighThreshold__setter)
 Returns the high hysteresis threshold for a pixel to be considered as an edge.

Detailed Description

Manages a complete context for the Canny edge detector.

Remarks:

The Canny edge detector operates on a grayscale BW8 image and delivers a black-and-white BW8 image where pixels have only 2 possible values: 0 and 255. Pixels corresponding to edges in the source image are set to value 255 in the output image; The other pixels are set to value 0.

License(s): EasyImage

Constructor & Destructor Documentation

◆ __init__()

None eVision.ECannyEdgeDetector.__init__ ( self)

Constructs a eVision.ECannyEdgeDetector object initialized to its default values.

Member Function Documentation

◆ Apply() [1/3]

None eVision.ECannyEdgeDetector.Apply ( self,
eVision.EROIBW8 source,
eVision.ERegion region,
eVision.EFrame frame,
eVision.EROIBW8 result )

Apply the Canny edge detector on an image/ROI.

Remarks:

The output ROI must have the same size than the input ROI.

Parameters
sourceThe source image/ROI.
regionThe region on which to apply the method.
frameThe reference frame of the region.
resultThe output image/ROI.

◆ Apply() [2/3]

None eVision.ECannyEdgeDetector.Apply ( self,
eVision.EROIBW8 source,
eVision.ERegion region,
eVision.EROIBW8 result )

Apply the Canny edge detector on an image/ROI.

Remarks:

The output ROI must have the same size than the input ROI.

Parameters
sourceThe source image/ROI.
regionThe region on which to apply the method.
resultThe output image/ROI.

◆ Apply() [3/3]

None eVision.ECannyEdgeDetector.Apply ( self,
eVision.EROIBW8 source,
eVision.EROIBW8 result )

Apply the Canny edge detector on an image/ROI.

Remarks:

The output ROI must have the same size than the input ROI.

Parameters
sourceThe source image/ROI.
resultThe output image/ROI.

◆ ResetSmoothingScale()

None eVision.ECannyEdgeDetector.ResetSmoothingScale ( self)

Prevents the smoothing of the source image by a Gaussian filter.

Remarks:

Calling this method is equivalent to set eVision.ECannyEdgeDetector.SmoothingScale to zero. It disables the use of the Gaussian filter.

Property Documentation

◆ HighThreshold

eVision.ECannyEdgeDetector.HighThreshold = property(_HighThreshold__getter, _HighThreshold__setter)
static

Returns the high hysteresis threshold for a pixel to be considered as an edge.

◆ LowThreshold

eVision.ECannyEdgeDetector.LowThreshold = property(_LowThreshold__getter, _LowThreshold__setter)
static

Returns the low hysteresis threshold for a pixel to be considered as an edge.

◆ SmoothingScale

eVision.ECannyEdgeDetector.SmoothingScale = property(_SmoothingScale__getter, _SmoothingScale__setter)
static

The scale of the features of interest.

Remarks:

This scale corresponds to the standard deviation of the Gaussian filter that is used to smooth the source image before the computation of the gradient, hereby selecting the scale of the features of interest.

If this scale is set to zero, no smoothing is achieved: The gradient is computed directly on the raw source image, speeding up the detector, but making the process much less reliable.

◆ ThresholdingMode

eVision.ECannyEdgeDetector.ThresholdingMode = property(_ThresholdingMode__getter, _ThresholdingMode__setter)
static

Returns the mode of the hysteresis thresholding.