You are here: Start » Function Reference » Image Look Up Tables » ApplyPixelLut

ApplyPixelLut

Applies previously created Look Up transformation to provided image.

Syntax

void avl::ApplyPixelLut
(
	const avl::Image& inImage,
	atl::Optional<const avl::Region&> inRoi,
	const avl::PixelLut& inLut,
	avl::Image& outImage
)

void ApplyPixelLut
(
	AvlNet.Image inImage,
	AvlNet.Region inRoi,
	AvlNet.PixelLut inLut,
	out AvlNet.Image outImage
)

Parameters

Name	Type	Default	Description
inImage	const Image&		Image to which LUT transformation will be applied
inRoi	Optional<const Region&>	NIL	Range of pixels to be processed
inLut	const PixelLut&		LUT object, which defines transformation
outImage	Image&		Transformed image

Description

This filter will apply previously created (by i.e. CreatePixelLut or CreatePowerLut) LookUp Table transformation to inImage. Type and depth of resulting outImage are determined by properties of inLut, which were fixed during creation of LUT.

Generally speaking, LookUp transform should only be applied to monochromatic images. However, ApplyPixelLut allows for transformation of color images, under special conditions:

inLut has to be created for single channel output
inImage has to be multichannel (its depth has to be greater than 1)

If those conditions are met, processing steps are as follows: input image is being split into separate channels, every channel is processed by inLut, resulting processed channels are being merged into outImage.

ApplyPixelLut can work only with images of type: INT8, UINT8, INT16, UINT16.

Remarks

Standard operations like PowerImage, CorrectGamma and LogarithmImage for images of type Int32 and Real are available in Image Point Transforms category.

Errors