You are here: Start » AVL.NET » AVL.ColorizeImage(AvlNet.ColorizeImageState, AvlNet.Image, AvlNet.Region, AvlNet.ColorPalette, bool, int?, int?, AvlNet.Image)

AVL.ColorizeImage(AvlNet.ColorizeImageState, AvlNet.Image, AvlNet.Region, AvlNet.ColorPalette, bool, int?, int?, AvlNet.Image)

Shows a monochromatic image in false colors.

Namespace:AvlNet
Assembly:AVL.NET.dll

Syntax


public static void ColorizeImage(
	ref AvlNet.ColorizeImageState ioState,
	AvlNet.Image inImage,
	AvlNet.Region inRoi,
	AvlNet.ColorPalette inPalette,
	bool inNegate,
	int? inMinValue,
	int? inMaxValue,
	out AvlNet.Image outImage
)

Parameters

ioState
Type: AvlNet.ColorizeImageState
inImage
Type: AvlNet.Image
Input image
inRoi
Type: AvlNet.Region
Range of pixels to be processed, or null.
inPalette
Type: AvlNet.ColorPalette
Palette of colors which is used to replace pixels
inNegate
Type: System.Boolean
Reversing palette colors
inMinValue
Type: System.Nullable<System.Int32>
Minimal value of pixel that will be replaced by color from palette otherwise black pixel will be set, or null.
inMaxValue
Type: System.Nullable<System.Int32>
Maximal value that will be replaced using color from value otherwise last color from palette will be set, or null.
outImage
Type: AvlNet.Image
Output image

Description

This filter is especially useful for visualization purposes. Hue and RedBlue pallets are useful for scientific visualization and the Iron palette is prepared for showing infrared images in thermo-graphic appliances.

Parameters inMinValue and inMaxValue defines the scale that should be applied to image pixels. Pixels outside this range are reduced to minimal or maximal value in range.

If parameters inMinValue or inMaxValue is set to Auto the filter will find the maximal or minimal pixel value.

This filter works only with single channel images.

Examples

The ColorizeImage performed on the result of LenaImage with inPalette set to Iron.

Remarks

Filter pre-computes after changing its parameter which can affect the filter's execution speed. Try to avoid changing filter's parameter during program execution.

Errors

Error type Description
DomainError Input image must have 1xUInt8 or 1xUInt16 format in ColorizeImage.
DomainError inMinValue is bigger than inMaxValue in ColorizeImage.

See also