Emulation Tables

The LEAD Color Conversion toolkit provides emulation tables as one of its conversion methods. This method however is provided only for the following conversions:

CMYK to RGB.

CIELab to RGB

and RGB to CIELab

The Emulation tables' method supports both built-in and custom options. For built-in emulation tables, use the USE_ET option. The custom emulation tables' option, USE_CUSTOM_ET, provides custom conversion using user-supplied images, converted from the source images distributed with the library, by any tool, as follows:

Conversion

Source

Convert to

CMYK to RGB

src_cmyk_image.tif

RGB image (i.e. dst_cmyk2rgb_image.tif)

RGB to Lab

src_rgb_image.tif

Lab image (i.e. dst_rgb2lab_image.tif)

Lab to RGB

src_lab_image.tif

RGB image (i.e. dst_lab2rgb_image.tif)

A set of images, already converted and ready for use (dst_cmyk2rgb_image.tif, dst_rgb2lab_image.tif, and dst_lab2rgb_image.tif), is provided. However, using the provided set of converted images will produce the same results as the built-in emulation tables.

The code below shows how a conversion can be done using the built-in tables:

L_VOID Tables_Convert_CMYKToRGB(L_UCHAR *pInput, L_UCHAR *pOutput, L_INT nWidth, L_INT nHeight) 
{
   LColor clr; /*Color Conversion object*/
   CONVERSION_PARAMS params; /*Conversion options*/
   
   /* Zero initialize, this step is important*/
   ZeroMemory ( &params, sizeof(CONVERSION_PARAMS)); 
   
   /*Conversion with options. 
   The conversion will be done with the options specified in the
   params variable*/
   
   /* Set the params size */
   params.uStructSize = sizeof(CONVERSION_PARAMS); 
   
   /* We want to use built-in emulation tables */
   params.nMethod = USE_ET; 
   
   /* set the active conversion method */
   params.nActiveMethod = USE_ET; 
   
   /* initialize the color conversion */
   clr.Initialize (CCS_CMYK, /*input color space*/
      CCS_RGB, /*output color space*/
      &params /*pointer to the initialization options*/
      ); 
   
   /* Convert the image buffer */
   clr.Convert (pInput, /* input buffer*/
      pOutput, /* output buffer*/
      nWidth, /*pixel's width*/
      nHeight, /*pixel's height*/
      0, /* 0 bytes align*/
      0); /*0 bytes align*/
   
   /* free the conversion */
   clr.Free ();

The code below shows how a conversion can be done using user-defined tables:

L_VOID Tables_Convert_CMYKToRGB(L_UCHAR *pInput, L_UCHAR *pOutput, L_INT nWidth, L_INT nHeight) 
{
   LColor clr; /*Color Conversion object*/
   CONVERSION_PARAMS params; /*Conversion options*/

   ZeroMemory(&params, sizeof(CONVERSION_PARAMS)); 

   /*Conversion with options. 
     The conversion will be done with the options specified in the 
     params variable*/

   /* set the params size */
   params.uStructSize = sizeof(CONVERSION_PARAMS); 

   /* we want to use custom emulation tables */
   params.nMethod = USE_CUSTOM_ET; 

   /* set the active conversion method */
   params.nActiveMethod = USE_CUSTOM_ET; 

   /* set the emulation tables */
   lstrcpy(params.sDstInputTable, TEXT("C:\\RGBImage.tif"));

   /* initialize the color conversion */
   clr.Initialize (CCS_CMYK, /*input color space*/
             CCS_RGB, /*output color space*/
             &params /*pointer to the initialization options*/
            ); 

   /* convert the image buffer */
   clr.Convert (pInput, /* input buffer */
                pOutput, /* output buffer */
                nWidth, /*pixel's width*/
                nHeight, /*pixel's height*/
                0, /* 0 bytes align*/
                0); /*0 bytes align*/

   /* free the conversion */
   clr.Free ();
}