L_GetFunctionalLookupTable

#include "l_bitmap.h"

L_LTIMGEFX_API L_INT L_GetFunctionalLookupTable (pLookupTable, uLookupLen, nStart, nEnd, nFactor, uFlags)

Updates a range of entries in the lookup table, based on the specified mathematical function.

Returns

Comments

This function will update the lookup table array using the predefined function specified in the uFlags parameter. In most cases, this function is used with the L_RemapBitmapIntensity function.

If the value of (nEnd - nStart) exceeds the uLookupLen, the function returns ERROR_INV_PARAMETER error code.

The nFactor parameter is used for log, exp and sigmoid functions only. If nFactor = 0 the function performs a linear interpolation between the two points nStart and nEnd and stores the results in the lookup table, regardless of the value set in uFlags.

If uFlags is FLT_EXP the value of nFactor modifies the lookup table values (see figure below) according to the following equations:

where :

nYStart = The Lookup table value at nStart.

nYEnd = The Lookup table value at nEnd.

nFirstValue = exp(0).

nLastValue = exp(nFactor/10.0)

x = the intensity value of the selected point

If uFlags is FLT_LN the value of nFactor modifies the lookup table values (see figure below) according to the following equations:

where:

nYStart = The Lookup table value at nStart.

nYEnd = The Lookup table value at nEnd.

nFirstValue = 0.

nLastValue = ln(1 + nFactor/10.0)

x = the intensity value of the selected point

If uFlags is FLT_SIGMOID the value of nFactor modifies the lookup table values (see figure below) according to the following equations:

where:

nYStart = The Lookup table value at nStart.

nYEnd = The Lookup table value at nEnd.

nFirstValue = 1./(1+exp(2.*nFactor/10.*(nStart - Center)/ (nEnd- nStart))).

nLastValue = 1./(1+exp(2.*nFactor/10.*(nEnd - Center)/ (nEnd- nStart))).

Center = (nEnd + nStart)/2.

x = the intensity value of the selected point

If uFlags is FLT_LINEAR, nFactor is ignored. The function performs a linear interpolation between the two points (nStart, nYStart) and (nEnd, nYEnd) and stores the results in the lookup table. Where

• nYStart = The Lookup table value at nStart.

• nYEnd = The Lookup table value at nEnd.

As an example, suppose a user wants to select a point, change the intensity value of that point (x), and then perform two linear interpolations:

• from 0 to the intensity value x

• from intensity value x to the end of the range

To accomplish this, the user would proceed by doing the following:

• Select the point and get its intensity value (x)

• Change the intensity value of the selected point to some new value (newIntensity).

• Store the new intensity value in the Lookup table by assignment:

pLookupTable[0] = 0;
pLookupTable[x] = newIntensity;
 

• Call L_GetFunctionalLookupTable with nStart set to 0, nEnd set to x, and uFlags set to FLT_LINEAR.

• Store the new intensity value in the Lookup table by assignment:

pLookupTable[x] = newIntensity;//This can be ignored, because the lookup table should have the same value from the previous steps.
pLookupTable[nEnd] = uLookupLen;
 

• Call L_GetFunctionalLookupTable with nStart set to x, nEnd set to uLookupLen, and uFlags set to FLT_LINEAR. (For the example, assume the image is 8-bits per pixel.)

For another example, please refer to the example for L_RemapBitmapIntensity.

Required DLLs and Libraries

Platforms

Win32, x64.

See Also

Example

This example will darken loaded bitmap by using lookup table affected by exponential function.

 L_INT GetFunctionalLookupTableExample(L_VOID)
{
   L_INT nRet;
   L_UINT LookupTable[256];  /* Array to hold lookup table*/
   BITMAPHANDLE LeadBitmap;  /*Bitmap handle to hold the loaded image */

   /* Load the bitmap, force 24 bits per pixel */
   nRet = L_LoadBitmap (MAKE_IMAGE_PATH(TEXT("ImageProcessingDemo\\Image3.cmp")), &LeadBitmap, sizeof(BITMAPHANDLE), 24, ORDER_BGR, NULL, NULL); 
   if(nRet !=SUCCESS)
      return nRet;
   /*Get Lookup table where the array calculated by the exponential function for all the items of the array  from 0 - 255*/
   nRet = L_GetFunctionalLookupTable ((L_INT *)LookupTable, 256,0, 255, 5, FLT_EXP);
   if(nRet !=SUCCESS)
      return nRet;
   nRet = L_RemapBitmapIntensity (&LeadBitmap, (L_INT *)LookupTable, 256,CHANNEL_MASTER);
   if(nRet !=SUCCESS)
      return nRet;
   nRet = L_SaveBitmap(MAKE_IMAGE_PATH(TEXT("Result.BMP")), &LeadBitmap, FILE_BMP, 24, 0, NULL);
   if(nRet !=SUCCESS)
      return nRet;
   //free bitmap 
   if(LeadBitmap.Flags.Allocated)  
      L_FreeBitmap(&LeadBitmap);  
   return SUCCESS;
}