Back to Adaptive Vision Library Lite website
You are here: Start » Image Point Transforms » AddToImage
![](../../img/icon/AddToImage.png)
AddToImage
Adds a scalar value to each pixel.
Syntax
void avl::AddToImage ( const avl::Image& inImage, atl::Optional<const avl::Region&> inRoi, float inValue, avl::Image& outImage )
Parameters
Name | Type | Default | Description | |
---|---|---|---|---|
![]() |
inImage | const Image& | Input image | |
![]() |
inRoi | Optional<const Region&> | NIL | Range of pixels to be processed |
![]() |
inValue | float | 50.0f | Value to be added |
![]() |
outImage | Image& | Output image |
Description
The operation increases the brightness of the inImage by adding a fixed value to each of its pixels.
![\forall_{i,j} \text{\textbf{OutImage} }_{i,j} = \text{\textbf{InImage} }_{i,j} + \text{\textbf{inValue} }](../../img/filters/AddToImage.png)
Whenever the resulting value exceeds the range of pixel values, it is clipped to the nearest proper value.
Examples
![]() |
![]() |
The AddToImage performed on the sample image with inValue = 50.0.
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: UINT8, SINT8, SINT16, REAL.
This operation supports automatic parallelization for multicore and multiprocessor systems.