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: |
|
Topics: |
|
|
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; }