Back to FabImage Library website

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

DilateAndErodeImage


Header: FIL.h
Namespace: fil
Module: FoundationPro

Calculates dilation and erosion simultaneously for faster execution.

Syntax

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

Parameters

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