You are here: Start » AVL.NET » Function Reference » Image » Image Local Transforms » AVL.SmoothImage_Mean

AVL.SmoothImage_Mean

Smooths an image by averaging pixels within a rectangular kernel.

Namespace:AvlNet
Assembly:AVL.NET.dll

Syntax

C++
C#
 
public static void SmoothImage_Mean
(
	AvlNet.Image inImage,
	NullableRef<AvlNet.Region> inRoi,
	NullableRef<AvlNet.Region> inSourceRoi,
	AvlNet.Pixel? inBorderColor,
	AvlNet.KernelShape inKernel,
	int inRadiusX,
	int? inRadiusY,
	AvlNet.Image outImage
)

Parameters

Name Type Range Default Description
inImageAvlNet.ImageInput image.
inRoiAvlNet.NullableRef<AvlNet.Region>Range of outImage pixels to be computed. Default value: atl::NIL.
inSourceRoiAvlNet.NullableRef<AvlNet.Region>Range of inImage pixels to be read. Default value: atl::NIL.
inBorderColorAvlNet.Pixel?Color of the imaginary pixels outside the image boundaries. Default value: atl::NIL.
inKernelAvlNet.KernelShapeKernel shape.
inRadiusXint<0, INF>1Nearly half of the kernel's width (2*R+1). Default value: 1.
inRadiusYint?<0, INF>Nearly half of the kernel's height (2*R+1), or same as inRadiusX. Default value: atl::NIL.
outImageAvlNet.ImageOutput image.

Description

Replaces each pixel with the average of all pixels contained in a rectangular kernel. The width of the kernel is 2 * inRadiusX + 1, the height is 2 * inRadiusY + 1. When inRadiusY is set to Auto, then its value is implicitly copied from inRadiusX.

Examples

SmoothImage_Mean performed on a sample image with inRadiusX = 4.

Hardware Acceleration

This operation is optimized for PARALLEL SSE2 technology for pixels of types: UINT8, SINT8, SINT16, SINT32, REAL.

This operation is optimized for SSE41 technology for pixels of type: UINT16.

This operation is optimized for AVX2 technology for pixels of types: UINT8, SINT8, SINT16, SINT32, REAL, UINT16.

This operation is optimized for NEON technology for pixels of types: UINT8, UINT16.

Hardware acceleration settings may be manipulated with Settings class.

Errors

List of possible exceptions:

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

Function Overrides

See also