L_ClrConvertToBitmap

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

L_LTCLR_API L_INT L_ClrConvertToBitmap(ClrHandle, pSrcBuf, pBitmap, uStructSize, nWidth, nHeight, nInAlign, nOutAlign)

L_HANDLE ClrHandle;	handle to the color conversion
L_UCHAR * pSrcBuf;	pointer to the input buffer
pBITMAPHANDLE pBitmap;	pointer to the output LEAD bitmap
L_UINT uStructSize;	size, in bytes of pBitmap
L_INT nWidth;	width of pixels to be processed
L_INT nHeight;	height of pixels to be processed
L_INT nInAlign;	each scanline in the input buffer is a multiple of nInAlign bytes
L_INT nOutAlign;	each scan line in the output buffer is a multiple of nOutAlign bytes

Converts image data in a buffer from one color conversion model to RGB\BGR, and sets it as a LEAD bitmap.

Parameter	Description
ClrHandle	Handle to an existing color conversion. This handle is obtained by calling the L_ClrInit function.
pSrcBuf	Pointer to the buffer holding the input data.
pBitmap	Pointer to the buffer that will hold the converted data bitmap.
uStructSize	Size in bytes, of the structure pointed to by pBitmap, for versioning. Use sizeof(BITMAPHANDLE).
nWidth	Width of pixels to be processed.
nHeight	Height of pixels to be processed.
nInAlign	Each scanline in the input buffer is a multiple of nInAlign bytes.
nOutAlign	Each scanline in the output buffer is a multiple of nOutAlign bytes.

Returns

SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

Conversion is done by setting the active method value specified in the CONVERSION_PARAMS structure when calling L_ClrInit. To change the active method, use L_ClrSetConversionParams. Only methods supported by the initialized converter should be specified.

The conversion is done if it was initialized with BGR or RGB Color Spaces as the destination.

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 converts a CMYK bitmap buffer into RGB bitmap.

L_INT ClrConvertToBitmapExample( 
L_UCHAR* pInput, 
pBITMAPHANDLE pBitmap, 
L_INT nWidth, 
L_INT nHeight) 
{ 
   L_INT nRet; 
   /* Color Handle */ 
   HANDLE ClrHandle = NULL; 
   /* initialize the color conversion */ 
   nRet = L_ClrInit(&ClrHandle, CCS_CMYK, CCS_RGB, NULL); 
   if(nRet != SUCCESS) 
      return nRet; 
   /* convert the image buffer */ 
   nRet = L_ClrConvertToBitmap(ClrHandle, pInput, pBitmap, sizeof(BITMAPHANDLE), nWidth, nHeight, 0, 0); 
   if(nRet != SUCCESS) 
      return nRet; 
   /* free the conversion */ 
   nRet = L_ClrFree(ClrHandle); 
   if(nRet != SUCCESS) 
      return nRet; 
   return SUCCESS; 
}

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