L_ClrIsValid

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

L_LTCLR_API L_INT L_ClrIsValid(ClrHandle)

L_HANDLE ClrHandle;

/* handle to the color conversion */

Determines whether the color conversion is valid to the conversion process.

Parameter

Description

ClrHandle

Handle to an existing color conversion. This handle is obtained by calling the L_ClrInit function.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

This function is useful for checking the validity of some conversion handle when using multiple converters.

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_ClrConvert

Topics:

Conversion Process

 

Color Conversion C DLL Function Groups

Example

L_INT ClrIsValidExample(
   HANDLE ClrHandle,
   L_UCHAR* pInput,
   L_UCHAR* pOutput,
   L_INT nWidth,
   L_INT nHeight)
{
   L_INT nRet;

   /* Check first the handle*/
   nRet = L_ClrIsValid(ClrHandle);
   if(nRet != SUCCESS)
      return nRet;

   /* Convert the image buffer */
   nRet = L_ClrConvert(ClrHandle, /* conversion handle */
      pInput,     /* input buffer      */
      pOutput,    /* output buffer     */
      nWidth,     /* pixels width      */
      nHeight,    /* pixels height     */
      0,          /* 0 bytes align     */
      0);         /* 0 bytes align     */

   return nRet;
}