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

CloseImage

Removes small dark structures from an image (or fills in bright ones) by applying consecutive dilation and erosion.

Header:	AVL.h

Syntax

void avl::CloseImage
(
	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& outImage,
	avl::Region& diagKernel
)

void CloseImage
(
	Image inImage,
	Region? inRoi,
	Region? inSourceRoi,
	Pixel? inBorderColor,
	KernelShape inKernel,
	int inRadiusX,
	int? inRadiusY,
	out Image outImage,
	out Region diagKernel
)

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 considered in computations
inBorderColor	Optional<Pixel>		NIL	Color of the imaginary pixels outside the image boundaries
inKernel	KernelShape::Type			Selects 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
outImage	Image&			Output image
diagKernel	Region&			Kernel shape

Examples

CloseImage used to remove dark scratches from an image.

In-place Processing

This function supports in-place data processing - you can pass the same reference to inImage and outImage

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.