L_ClrDlg

#include "ltkrn.h"
#include "ltclr.h"

L_LTCLR_API L_INT L_ClrDlg(nDlg, hWnd, pClrHandle, pPramas)

L_INT nDlg;

/* dialog constant */

L_HANDLE hWnd;

/* handle to the parent window */

L_HANDLE * pClrHandle;

/* pointer to the output color handle */

LPCONVERSION_PARAMS pParams;

/* pointer to the output conversion params */

Displays a color space dialog box to initialize, and creates a color handle and CONVERSION_PARAMS data.

Parameter

Description

nDlg

The color space dialog to display. Possible values are:

 

Value

Meaning

 

DLG_CMYK

CMYK dialog.

 

DLG_LAB

LAB dialog.

hWnd

Handle to parent window.

pClrHandle

Pointer to color handle to be set by the dialog. Pass NULL if it is not needed.

pParams

Pointer to a CONVERSION_PARAMS structure to be set by the dialog. Pass NULL if it is not needed.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

This is another way of initializing the toolkit without using L_ClrInit. You can use it to retrieve a Color handle and/or a CONVERSION_PARAMS structure, for use later in initialization or modification by L_ClrSetConversionParams.

Required DLLs and Libraries

LTCLR

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application

See Also

Functions:

L_ClrInit

Topics:

Conversion Process

 

COLOR Function Groups

Example

This example opens the CMYK dialog and creates a color handle and CONVERSION_PARAMS data.

L_INT ClrDlgExample(
   HWND hWnd,
   HANDLE* pClrHandle)
{
   L_INT nRet;
   CONVERSION_PARAMS convparams; /* conversion options */

   /* Conversion with options:
      The conversion will be done with the options specified in the convparams variable*/
   /* set the convparams size */
   convparams.uStructSize = sizeof(CONVERSION_PARAMS);
   
   /* we want to use the built in ICC conversion method and built in conversion */
   /* use built in conversion and LEAD ICC Engine*/
   convparams.nMethod = USE_BUILTIN | USE_ICC;
   
   /* set the active conversion method */
   convparams.nActiveMethod = USE_BUILTIN;
   
   /* allocate a D50 white point option */
   convparams.pWpoint = (LPWHITEPOINT)malloc(sizeof(WHITEPOINT));
   
   /* D50 white point */
   convparams.pWpoint->nWhitePoint = CIELAB_D50;
   
   /* allocate a cmyk option */
   convparams.pCmykParams = (LPCMYK_PARAMS)malloc(sizeof(CMYK_PARAMS));
   convparams.pCmykParams->uStructSize = sizeof(CMYK_PARAMS);
   convparams.pCmykParams->nMask = CMYK_GCR;
   
   /* 17.5 % GCR value */
   convparams.pCmykParams->nGcr_level = 175;

   nRet = L_ClrDlg(DLG_CMYK, hWnd, pClrHandle, &convparams);

   return nRet;
}