L_ClrConvertDirectToBitmap

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

L_LTCLR_API L_INT L_ClrConvertDirectToBitmap(nSrcFormat, nDstFormat, pSrcBuf, pBitmap, uStructSize, nWidth, nHeight, nInAlign, nOutAlign)

L_INT nSrcFormat;

/* format of the input data */

L_INT nDstFormat;

/* format of the output data */

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 directly using built in algorithms, and sets the output as a LEAD bitmap.

Parameter

Description

nSrcFormat

Format of the source data. Possible values are:

 

Value

Meaning

 

CCS_RGB

[0x00] Color conversion is RGB.

 

CCS_YUV

[0x01] Color conversion is YUV.

 

CCS_CMYK

[0x02] Color conversion is CMYK.

 

CCS_HSV

[0x03] Color conversion is HSV.

 

CCS_HLS

[0x04] Color conversion is HLS.

 

CCS_YIQ

[0x05] Color conversion is YIQ.

 

CCS_CMY

[0x06] Color conversion is CMY.

 

CCS_LAB

[0x07] Color conversion is CIELAB.

 

CCS_XYZ

[0x08] Color conversion is CIEXYZ.

 

CCS_YCCK

[0x0B] Color conversion is YCCK.

 

CCS_BGR

[0x0C] Color conversion is BGR.

 

CCS_UYVY

[0x0E] Color conversion is UYVY.

 

CCS_YUY2

[0x09] Color conversion is YUY2.

 

CCS_YVU9

[0x0A] Color conversion is YVU9.

 

CCS_YCC

[0x0F] Color conversion is YCC.

 

CCS_IHS

[0x10] Color conversion is IHS.

 

nDstFormat

Format of the output data. Possible values are:

 

Value

Meaning

 

CCS_RGB

[0x00] Color conversion is RGB.

 

CCS_BGR

[0x0C] Color conversion is BGR.

pSrcBuf

Pointer to the buffer holding the input data.

pBitmap

Pointer to the LEAD bitmap that will hold the converted data.

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

This function works only for conversion to BGR or RGB color space formats.

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:

Programming with LEADTOOLS Color Conversion Functions

 

Color Conversion C DLL Function Groups

Example

L_INT ClrConvertDirectToBitmapExample(
   L_UCHAR* pInput,
   BITMAPHANDLE* pBitmap,
   L_INT nWidth,
   L_INT nHeight)
{
   L_INT nRet;

   /* direct conversion using built in options */
   nRet = L_ClrConvertDirectToBitmap(CCS_CMYK, /* input color conversion  */
      CCS_RGB,    /* output color conversion */
      pInput,     /* input buffer            */
      pBitmap,    /* output bitmap           */
      sizeof(BITMAPHANDLE),
      nWidth,     /* pixels width            */
      nHeight,    /* pixels height           */
      0,          /* 0 bytes align           */
      0);         /* 0 bytes align           */

   return nRet;
}