Back to Adaptive Vision Library website

You are here: Start » Function Reference » Image » Image Features » ImageRidges

ImageRidges


Header: AVL.h
Namespace: avl
Module: FoundationBasic

Finds ridge pixels in an image.

Syntax

C++
C#
 
void avl::ImageRidges
(
	const avl::Image& inImage,
	atl::Optional<const avl::Region&> inRoi,
	avl::Polarity::Type inPolarity,
	atl::Optional<float> inMinValue,
	atl::Optional<float> inMaxValue,
	const float inNoiseLevel,
	avl::Region& outRidges
)

Parameters

Name Type Range Default Description
inImage const Image& Input image
inRoi Optional<const Region&> NIL Range of pixels to be processed
inPolarity Polarity::Type Specifies the type of ridges to be detected (Bright, Dark or Any)
inMinValue Optional<float> NIL Minimal value of pixel to be considered
inMaxValue Optional<float> NIL Maximal value of pixel to be considered
inNoiseLevel const float 0.0 - Defines how much stronger a pixel has to be than its neighbors to be deemed a ridge pixel
outRidges Region& Region of ridges

Description

The operation finds region of pixels being local ridges on the image inImage within specific region inRoi. For a pixel to be deemed a ridge pixel it is necessary to be stronger than both its neighbor pixels in at least one from four main directions (horizontal, vertical and two diagonals) by at least inNoiseLevel. Furthermore, the pixel value must be between inMinValue and inMaxValue.

Errors

List of possible exceptions:

Error type Description
DomainError Region exceeds an input image in ImageRidges.

See Also

  • ImageLocalMinima – Finds image locations characterized by locally minimal pixel values.
  • ImageLocalMaxima – Finds image locations characterized by locally maximal pixel values.