NegateImage

Module:	FoundationLite

Reverts the pixel value range (unsigned) or applies numeric negation (signed).

Name	Type	Description
inImage	Image	Input image
inRoi	Region *	Range of pixels to be processed
outImage	Image	Output image

The operation negates the pixel values of the inImage. Depending on the pixel type, the negation is defines as follows:

For the signed pixel types: $\forall_{i,j} \text{\textbf{OutImage} }_{i,j} = -\text{\textbf{InImage} }_{i,j}$
For the unsigned pixel types: $\forall_{i,j} \text{\textbf{OutImage} }_{i,j} = \text{\textbf{MaximalValue} } - \text{\textbf{InImage} }_{i,j}$ (which can be thought of as mirroring the pixel values around the center of the pixel values range)

Description of usage of this filter can be found in examples and tutorial: Image Modification Using the HMI.

The NegateImage performed on the sample image.

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

This operation supports automatic parallelization for multicore and multiprocessor systems.

This filter can throw an exception to report error. Read how to deal with errors in Error Handling.

List of possible exceptions:

Error type	Description
DomainError	Region exceeds an input image in NegateImage.

This filter is available on Basic Complexity Level.