You are here: Start » Filter Reference » Image Look Up Tables » ApplyPixelLut
ApplyPixelLut
Applies previously created Look Up transformation to provided image.
| Name | Type | Description | |
|---|---|---|---|
 |
inImage | Image | Image to which LUT transformation will be applied |
|
inRoi | Region* | Range of pixels to be processed |
|
inLut | 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
This filter can throw an exception to report error. Read how to deal with errors here: Error Handling
| Error type | Description |
|---|---|
| RuntimeError | Not initialized PixelLut object passed to ApplyPixelLut. |
Complexity Level
This filter is available on Basic Complexity Level.
