GetFunctionalLookupTable Method

public static void GetFunctionalLookupTable( 
   int[] lookupTable, 
   int start, 
   int end, 
   int factor, 
   FunctionalLookupTableFlags flags 
) 

+ (void)getFunctionalLookupTable:(int *)lookupTable 
               lookupTableLength:(NSUInteger)lookupTableLength 
                           start:(NSInteger)start 
                             end:(NSInteger)end 
                          factor:(NSInteger)factor 
                           flags:(LTFunctionalLookupTableFlags)flags 
                           error:(NSError **)error 

public static void getFunctionalLookupTable( 
   int[] lookupTable, 
   int start, 
   int end, 
   int factor, 
   FunctionalLookupTableFlags flags 
); 

public: 
static void GetFunctionalLookupTable(  
   array<int>^ lookupTable, 
   int start, 
   int end, 
   int factor, 
   FunctionalLookupTableFlags flags 
)  

def GetFunctionalLookupTable(self,lookupTable,start,end,factor,flags): 

Parameters

• This method will update the lookup table array using the predefined function specified in the  flags parameter. In most cases, this method is used with RemapIntensityCommand.
• The  factor parameter is used for logarithm, exponential and sigmoid functions only. If  factor = 0, the method performs a linear interpolation between the two points start and end and stores the results in the lookup table, regardless of the value set in  flags.

• If  flags parameter is set to FunctionalLookupTableFlags.Exponential, the value of  factor modifies the lookup table values (see figure below) according to the following equations:

  Y	=	YStart	+	(YEnd - YStart) * (Exp ((factor/10.0 * (x-start))/(end-start)) - firstValue)
  				(lastValue - firstValue)

  YStart = The  lookupTable value at start. YEnd = The  lookupTable value at end. firstValue = Exp(0). lastValue = Exp(factor) x = the intensity value of the selected point

  

• If the  flags parameter is set to FunctionalLookupTableFlags.Logarithm, the value of  factor modifies the lookup table values (see figure below) according to the following equations:

  Y	=	YStart	+	(YEnd - YStart) * (Log (1 + (factor/10.0 * (x-start))/(end- start)) - firstValue)
  				(lastValue - firstValue)

  YStart = The  lookupTable value at start. YEnd = The  lookupTable value at end. firstValue = 0. lastValue = Log(1 + nFactor). x = the intensity value of the selected point

  

• If the  flags parameter is set to FunctionalLookupTableFlags.Sigmoid, the value of  factor modifies the lookup table values (see figure below) according to the following equations:

  Y	=	YStart	+	(YEnd - YStart) * (1.0/ (1 + Exp(2*factor/10.0 * (x-center))/(end- start)) - firstValue)
  				(lastValue - firstValue)

  YStart = The  lookupTable value at start. YEnd = The  lookupTable value at end. firstValue = 1.0/(1 + Exp(2.0 * factor/10.0 *(start - center)/ (end- start))). lastValue = Log(1 + factor). x = the intensity value of the selected point

  

• If the  flags parameter is set to FunctionalLookupTableFlags.Linear,  factor is ignored. The method performs a linear interpolation between the two points (start, YStart) and (end, YEnd) and stores the results in the lookup table.

  where:

  YStart = The  lookupTable value at start.

  YEnd = The  lookupTable value at end.

• If the value of (end - start) exceed the  lookupTable length, the method will throw an exception.

• 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: lookupTable[0] = 0; lookupTable[x] = newIntensity;

  • Call GetFunctionalLookupTable with start set to 0, end set to x, and  flags set to FunctionalLookupTableFlags.Linear.

  • Call GetFunctionalLookupTable with start set to x, end set to 255, and  flags set to FunctionalLookupTableFlags.Linear. (For the example, assume the image is 8-bits per pixel.)
  • For another example, refer to the example for RemapIntensityCommand.

This example will darken the loaded image by using a lookup table created by using an exponential function.

using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.ImageProcessing; 
using Leadtools.ImageProcessing.Effects; 
using Leadtools.ImageProcessing.Color; 
 
 
public void GetFunctionalLookupTableExample() 
{ 
   // Load an image 
   RasterCodecs codecs = new RasterCodecs(); 
   codecs.ThrowExceptionsOnInvalidImages = true; 
 
   RasterImage image = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "Master.jpg")); 
 
   // Prepare the command 
   int[] LookupTable = new int[256]; 
   LookupTable[0] = 0; 
   LookupTable[255] = 255; 
   EffectsUtilities.GetFunctionalLookupTable(LookupTable, 0, 255, 5, FunctionalLookupTableFlags.Exponential); 
 
   RemapIntensityCommand command = new RemapIntensityCommand(); 
   command.Flags = RemapIntensityCommandFlags.Master; 
   command.LookupTable = LookupTable; 
   command.Run(image); 
   codecs.Save(image, Path.Combine(LEAD_VARS.ImagesDir, "Result.jpg"), RasterImageFormat.Jpeg, 24); 
 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\LEADTOOLS23\Resources\Images"; 
} 

 
import java.io.File; 
import java.io.IOException; 
 
import org.junit.*; 
import org.junit.runner.JUnitCore; 
import org.junit.runner.Result; 
import org.junit.runner.notification.Failure; 
import static org.junit.Assert.*; 
 
import leadtools.*; 
import leadtools.codecs.*; 
import leadtools.imageprocessing.color.*; 
import leadtools.imageprocessing.effects.*; 
 
 
public void getFunctionalLookupTableExample() { 
   final String LEAD_VARS_IMAGES_DIR = "C:\\LEADTOOLS23\\Resources\\Images"; 
 
   // Load an image 
   RasterCodecs codecs = new RasterCodecs(); 
   codecs.setThrowExceptionsOnInvalidImages(true); 
 
   RasterImage image = codecs.load(combine(LEAD_VARS_IMAGES_DIR, "Master.jpg")); 
 
   // Prepare the command 
   int[] lookupTable = new int[256]; 
   lookupTable[0] = 0; 
   lookupTable[255] = 255; 
   EffectsUtilities.getFunctionalLookupTable(lookupTable, 0, 255, 5, FunctionalLookupTableFlags.EXPONENTIAL); 
   assertTrue(lookupTable[0] == 0 && lookupTable[255] == 255); 
 
   RemapIntensityCommand command = new RemapIntensityCommand(); 
   command.setFlags(RemapIntensityCommandFlags.MASTER.getValue()); 
   command.setLookupTable(lookupTable); 
   int change = command.run(image); 
   assertTrue(change != RasterImageChangedFlags.NONE); 
 
   codecs.save(image, combine(LEAD_VARS_IMAGES_DIR, "Result.jpg"), RasterImageFormat.JPEG, 24); 
   System.out.println("Functional lookup table obtained, command run, and image saved to " 
         + combine(LEAD_VARS_IMAGES_DIR, "Result.jpg")); 
} 

Target Platforms

Reference

EffectsUtilities Class

EffectsUtilities Members

Leadtools.ImageProcessing.Color.RemapIntensityCommand

Leadtools.ImageProcessing.Core.ApplyVoiLookupTableCommand

Leadtools.ImageProcessing.Color.AdjustTintCommand

Leadtools.ImageProcessing.Color.GammaCorrectExtendedCommand