You are here: Start » AVL.NET » AVL.ConvertPixelType(AvlNet.Image, AvlNet.Region, AvlNet.PlainType, int, AvlNet.Image)

AVL.ConvertPixelType(AvlNet.Image, AvlNet.Region, AvlNet.PlainType, int, AvlNet.Image)

Changes the type of pixel components.

Namespace:	AvlNet
Assembly:	AVL.NET.dll

Syntax


public static void ConvertPixelType(
	AvlNet.Image inImage,
	AvlNet.Region inRoi,
	AvlNet.PlainType inNewType,
	int inDepthDelta,
	out AvlNet.Image outImage
)

Parameters

inImage: Type: AvlNet.Image
Input image
inRoi: Type: AvlNet.Region
Range of pixels to be processed, or null.
inNewType: Type: AvlNet.PlainType
Type of the output image
inDepthDelta: Type: System.Int32
Pixel values will be multiplied by 2^inDepthDelta. For example, use -4 to convert 12-bit to 8-bit images.
outImage: Type: AvlNet.Image
Output image

Description

The operation alters the pixel component format of the inImage. Available formats are listed in the documentation of the Image data type.

If the value of pixel component doesn't fit in the range of the new type, it is clipped to the nearest proper value, which can lead to the significant loss of information, as demonstrated in the example.

Examples

ConvertPixelType run on example image of UInt8 type with inNewType being Int8. Note that bright pixels suffered from clipping, while dark ones remained unaltered.

Hardware Acceleration

This operation supports automatic parallelization for multicore and multiprocessor systems.