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

CreateCustomLut

Header:	FIL.h
Namespace:	fil
Module:	FoundationBasic

Creates Look Up Table for user provided operation on image pixels.

Syntax

void fil::CreateCustomLut
(
	const LutOperatorType& inLutFunction,
	const fil::PlainType::Type& inOutputType,
	ftl::Optional<void*> inUserData,
	fil::PixelLut& outLut
)

Parameters

Name	Type	Default	Description
inLutFunction	const LutOperatorType&
inOutputType	const PlainType::Type&
inUserData	Optional<void*>	NIL	Data passed as the second parameter to inLutFunction
outLut	PixelLut&

Description

This function creates custom Look Up Table from function provided by user in form of callable.

Function to use can be passed as pointer to function, callable object (object with operator() defined) or lambda expression. Only requirement for such callable is for it to accept single parameter of type float and return value of type float.

Value passed to provided function is value of pixel. Value returned from provided function is value demanded from LUT being created.

CreateCustomLut will apply provided function on all possible values of inOutputType type and cache them in internal structure. Such PixelLut object can be then passed to ApplyPixelLut.

CreateCustomLut can create Look Up Tables for the following types: 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

List of possible exceptions: