L_ClrDlg

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

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

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.

Platforms

Win32, x64.

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

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

Help Version 19.0.2017.10.27

LEADTOOLS Color Conversion C API Help

Introduction

Version History

Getting Started with LEADTOOLS Color Space Conversion

Redistributables/Files To Be Included With Your Application

Quick Reference

Tutorials

Function References

Functions:	L_ClrInit
Topics:	Conversion Process
	Color Conversion C API Function Groups