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

DilateImage_Mask

Replaces each pixel with the maximum of pixels within a small rectangular kernel.

Syntax

void avl::DilateImage_Mask
(
	const avl::Image& inImage,
	atl::Optional<const avl::Region&> inRoi,
	avl::MorphologyKernel::Type inKernel,
	avl::Image& outImage
)

void DilateImage_Mask
(
	Image inImage,
	Region? inRoi,
	MorphologyKernel inKernel,
	out Image outImage
)

Parameters

Name	Type	Default	Description
inImage	const Image&		Input image
inRoi	Optional<const Region&>	NIL	Range of outImage pixels to be computed
inKernel	MorphologyKernel::Type		Selects a predefined kernel
outImage	Image&		Output image

Description

The operation replaces each pixel with the brightest pixel in its neighbourhood, thus shrinking dark areas in inImage and expanding the bright ones.

This filter is a simplified version of DilateImage. It is limited to only a few symmetric kernels and supports only basic ROI handling.

Please note that on some machines the filter execution time can be greater than execution time of the corresponding DilateImage filter.

Examples

DilateImage_Mask performed on the sample image with inKernel = Box3x3.

Hardware Acceleration

This operation is optimized for SSE2 technology for pixels of type: UINT8.