You are here: Start » Function Reference » Image » Image Point Transforms » SquareImage
Header: | FIL.h |
---|---|
Namespace: | fil |
Module: | FoundationLite |
Raises pixel values to the second power pixel by pixel.
Syntax
void fil::SquareImage ( const fil::Image& inImage, ftl::Optional<const fil::Region&> inRoi, fil::Image& outImage )
Parameters
Name | Type | Default | Description | |
---|---|---|---|---|
inImage | const Image& | Input image | ||
inRoi | Optional<const Region&> | NIL | Range of pixels to be processed | |
outImage | Image& | Output image |
In-place Processing
This function supports in-place data processing - you can pass the same reference to inImage and outImage
Read more about In-place Computation.
Description
The operation increases the brightness of an image by squaring each pixel value. Whenever the resulting value exceeds the range of pixel values, it is clipped to the nearest proper value. Note that the absolute change of pixel brightness is usually very big.
Examples
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.
Errors
List of possible exceptions:
Error type | Description |
---|---|
DomainError | Region exceeds an input image in SquareImage. |
See Also
- SquareRootImage – Transforms pixel values to their square roots pixel by pixel.