L_ConvertBuffer

#include "l_bitmap.h"

L_INT EXT_FUNCTION L_ConvertBuffer(pBuffer, nWidth, nBitsPerPixelSrc, nBitsPerPixelDst, nOrderSrc, nOrderDst, pPaletteSrc, pPaletteDst)

L_UCHAR, L_FAR * pBuffer;	/* pointer to the input buffer */
L_INT nWidth;	/* image width, in pixels */
L_INT nBitsPerPixelSrc;	/* input bits per pixel */
L_INT nBitsPerPixelDst;	/* output bits per pixel */
L_INT nOrderSrc;	/* input color order */
L_INT nOrderDst;	/* output color order */
LPRGBQUAD pPaletteSrc;	/* pointer to the palette for the existing data */
LPRGBQUAD pPaletteDst;	/* pointer to the palette for the converted data */

Converts data in the specified buffer to the specified bits per pixel and color order. You can convert from any bits per pixel to any bits per pixel.

Parameter	Description
pBuffer	Pointer to the input buffer.
nWidth	Image width, in pixels.
nBitsPerPixelSrc	Input bits per pixel. Possible values are 1, 2, 3, 4, 5, 6, 7, 8, 16, 24, 32, 48, and 64.
nBitsPerPixelDst	Output bits per pixel. Use 0 for 8-bit grayscale.
nOrderSrc	The input color order. Possible values are:
	Value	Meaning
	ORDER_RGB	[0] The input colors are in red-green-blue order.
	ORDER_BGR	[1] The input colors are in blue-green-red order.
	ORDER_GRAY	[2] 12 or 16-bit grayscale image. 12 and 16-bit grayscale images are only supported in the Document/Medical Imaging editions .
	0	The data is 8 bits per pixel or less.
	ORDER_ROMM	[5] The input colors are in ROMM order. ROMM only supports 24 and 48-bit images.
nOrderDst	The output color order. Possible values are:
	Value	Meaning
	ORDER_RGB	[0] The output colors are in red-green-blue order.
	ORDER_BGR	[1] The output colors are in blue-green-red order.
	ORDER_GRAY	[2] 12 or 16-bit grayscale image. 12 and 16-bit grayscale images are only supported in the Document/Medical Imaging editions .
	0	The data is 8 bits per pixel or less.
	ORDER_ROMM	[5] The output colors are in ROMM order. ROMM only supports 24 and 48-bit images.
pPaletteSrc	Pointer to the palette for the existing data, before conversion. If the data is converted from 16 or 24 bits per pixel, use NULL for no palette.
pPaletteDst	Pointer to the palette for the converted data. If the data is converted to 16 or 24 bits per pixel, use NULL for no palette.

Returns

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

Comments

Support for 12 and 16-bit grayscale images is only available in the Document/Medical Imaging editions .

The conversion uses only one buffer, which must be large enough to hold the data before and after conversion.

Image data that is 8 bits per pixel or less must use a palette, and this function can use such data as input, output, or both. Therefore, you may need to specify the palette for the input, or for the output, or both.

Required DLLs and Libraries

LTKRN

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Windows 95 / 98 / Me, Windows 2000 / XP, Windows CE.

See Also

Functions:	L_StartDithering, L_DitherLine, L_StopDithering,
	L_ConvertBufferExt
Topics:	Raster Image Functions: Doing Color Expansion or Reduction
	Raster Image Functions: Doing Color Space Conversions

Example

/* This example loads a temporary bitmap at 8 bits per pixel, creates a new
bitmap at 16 bits per pixel, and uses L_ConvertBuffer to convert data from
the temporary bitmap to the new one. */
BITMAPHANDLE LeadBitmap;   /* Bitmap handle for the final image */
void TestFunction(HWND hWnd)
{
   RGBQUAD FixedPalette[256]; /* Temporary palette */
   BITMAPHANDLE TmpBitmap;   /* Bitmap handle to hold the input image */
   L_UCHAR L_FAR *pBuf; /* Buffer to hold the row */
   HGLOBAL hBuf; /* Handle to the buffer */
   int i; /* Loop counter */
   /* Load the bitmap, at 8 bits per pixel */
   L_LoadBitmap (TEXT("IMAGE3.CMP"), &TmpBitmap, sizeof(BITMAPHANDLE), 8, 0, NULL, NULL);
   /* Create a new 16-bit bitmap */
   L_CreateBitmap(&LeadBitmap, sizeof(BITMAPHANDLE), TYPE_CONV, TmpBitmap.Width, TmpBitmap.Height,
                  16, ORDER_BGR, NULL, TmpBitmap.ViewPerspective, NULL, 0);
   /* Get the LEAD fixed palette for an 8-bit image */
   L_GetFixedPalette(FixedPalette, 8);
   /* Allocate and lock the buffer */
   hBuf = GlobalAlloc(GMEM_MOVEABLE,LeadBitmap.BytesPerLine);
   pBuf = (L_UCHAR L_FAR *)GlobalLock( hBuf );
   /* Process each row from TmpBitmap to LeadBitmap */
   L_AccessBitmap(&LeadBitmap);
   L_AccessBitmap(&TmpBitmap);
   for(i=0; i < TmpBitmap.Height; i++)
   {
      L_GetBitmapRow(&TmpBitmap, pBuf, i, TmpBitmap.BytesPerLine);
      L_ConvertBuffer(pBuf, TmpBitmap.Width,
         TmpBitmap.BitsPerPixel, LeadBitmap.BitsPerPixel,
         TmpBitmap.Order, LeadBitmap.Order, FixedPalette, NULL);
      L_PutBitmapRow(&LeadBitmap, pBuf, i, LeadBitmap.BytesPerLine);
   }
   L_ReleaseBitmap(&LeadBitmap);
   L_ReleaseBitmap(&TmpBitmap);
   /* Free memory that we no longer need */
   GlobalUnlock(hBuf);
   GlobalFree(hBuf);
   /* Free the temporary bitmap */
   L_FreeBitmap(&TmpBitmap);
   /* Force paint palette creation */
   SendMessage (hWnd, WM_QUERYNEWPALETTE, 0, 0L);
   return;
}