Back to Adaptive Vision Studio website

You are here: Start » Filter Reference » Image Local Transforms » DilateImage

DilateImage


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

Name Type Range Description
inImage Image Input image
inRoi Region* Range of outImage pixels to be computed
inSourceRoi Region* Range of inImage pixels to be considered in computations
inBorderColor Pixel* Color of the imaginary pixels outside the image boundaries
inKernel KernelShape Kernel shape
inRadiusX Integer 0 - Nearly half of the kernel's width (2*R+1)
inRadiusY Integer* 0 - Nearly half of the kernel's height (2*R+1), or same as inRadiusX
outImage Image Output image
diagKernel Region Kernel shape

Description

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

Examples

DilateImage performed on the sample image with inKernel = Box, inRadiusX = 1, inRadiusY = 1.

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

This filter can throw an exception to report error. Read how to deal with errors in Error Handling.

List of possible exceptions:

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

Complexity Level

This filter is available on Basic Complexity Level.

Filter Group

This filter is member of DilateImage filter group.

See Also

  • ErodeImage – Replaces each pixel with the minimum of pixels within a kernel.