Back to Adaptive Vision Library website

You are here: Start » Function Reference » Image » Image Local Transforms » DilateAndErodeImage

DilateAndErodeImage


Header: AVL.h
Namespace: avl
Module: FoundationPro

Calculates dilation and erosion simultaneously for faster execution.

Syntax

C++
C#
 
void avl::DilateAndErodeImage
(
	const avl::Image& inImage,
	atl::Optional<const avl::Region&> inRoi,
	atl::Optional<const avl::Region&> inSourceRoi,
	atl::Optional<avl::Pixel> inBorderColor,
	avl::KernelShape::Type inKernel,
	int inRadiusX,
	atl::Optional<int> inRadiusY,
	avl::Image& outDilated,
	avl::Image& outEroded
)

Parameters

Name Type Range Default Description
inImage const Image& Input image
inRoi Optional<const Region&> NIL Range of outImage pixels to be computed
inSourceRoi Optional<const Region&> NIL Range of inImage pixels to be read
inBorderColor Optional<Pixel> NIL Color of the imaginary pixels outside the image boundaries
inKernel KernelShape::Type Kernel shape
inRadiusX int 0 - 1 Nearly half of the kernel's width (2*R+1)
inRadiusY Optional<int> 0 - NIL Nearly half of the kernel's height (2*R+1), or same as inRadiusX
outDilated Image&
outEroded Image&

Hardware Acceleration

This operation is optimized for SSE2 technology for pixels of types: all formats (when inSourceRoi = NIL and inBorderColor = NIL).

This operation supports automatic parallelization for multicore and multiprocessor systems.

Errors

List of possible exceptions:

Error type Description
DomainError inBorderColor is relevant only when inSourceRoi is set to Auto (NIL) in DilateAndErodeImage.
DomainError Not supported kernel on input in DilateAndErodeImage.
DomainError Region exceeds an input image in DilateAndErodeImage.