You are here: Start » AVL.NET » AVL.DivideImage Method

AVL.DivideImage Method

Divides each pixel by a scalar value.

Namespace:AvlNet
Assembly:AVL.NET.dll

Syntax

public static void DivideImage(
	AvlNet.Image inImage,
	AvlNet.Region inRoi,
	float inValue,
	out AvlNet.Image outImage
)

Parameters

Name Type Range Default Description
inImageAvlNet.ImageInput image.
inRoiAvlNet.RegionRange of pixels to be processed. Default value: atl::NIL, or null.
inValuefloat2.0fDivisor. Default value: 2.0f.
outImageAvlNet.ImageOutput image.

Description

The operation decreases the brightness of the inImage dividing each of its pixels by a fixed value.

\forall_{i,j} \text{\textbf{OutImage} }_{i,j} = \frac{\text{\textbf{InImage} }_{i,j} }{\text{\textbf{inValue} } }

Whenever the resulting value exceeds the range of pixel values, it is clipped to the nearest proper value.

Examples

DivideImage performed on the sample image with inValue = 2.0.

Hardware Acceleration

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

This operation supports automatic parallelization for multicore and multiprocessor systems.

Hardware acceleration settings may be manipulated with Settings class.

Errors

Error type Description
DomainError Division by zero in DivideImage.

See also