You are here: Start » AVL.NET » Function Reference » Image » Image Point Transforms » AVL.NegateImage

AVL.NegateImage

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

Namespace:AvlNet
Assembly:AVL.NET.dll

Syntax

C++
C#
 
public static void NegateImage
(
	AvlNet.Image inImage,
	NullableRef<AvlNet.Region> inRoi,
	AvlNet.Image outImage
)

Parameters

Name Type Range Default Description
inImageAvlNet.ImageInput image.
inRoiAvlNet.NullableRef<AvlNet.Region>Range of pixels to be processed. Default value: atl::NIL.
outImageAvlNet.ImageOutput image.

Description

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)

Examples

The NegateImage performed on the sample image.

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 Region exceeds an input image in NegateImage.

Function Overrides

See also