You are here: Start » AVL.NET » Function Reference » Image » Image Point Transforms » AVL.DivideImage
Divides each pixel by a scalar value.
Namespace: | AvlNet |
---|---|
Assembly: | AVL.NET.dll |
Syntax
C++
C#
public static void DivideImage ( AvlNet.Image inImage, NullableRef<AvlNet.Region> inRoi, float inValue, AvlNet.Image outImage )
Parameters
Name | Type | Range | Default | Description | |
---|---|---|---|---|---|
![]() | inImage | AvlNet.Image | Input image. | ||
![]() | inRoi | AvlNet.NullableRef<AvlNet.Region> | Range of pixels to be processed. Default value: atl::NIL. | ||
![]() | inValue | float | 2.0f | Divisor. Default value: 2.0f. | |
![]() | outImage | AvlNet.Image | Output 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} } }](../img/filters/DivideImage.png)
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
List of possible exceptions:
Error type | Description |
---|---|
DomainError | Division by zero in DivideImage. |
DomainError | Region exceeds an input image in DivideImage. |