L_PutBitmapRowCompressed

#include "l_bitmap.h"

L_LTKRN_API L_INT L_PutBitmapRowCompressed(pBitmap, pWorkBuffer, pRunBuffer, nRow, nLines)

pBITMAPHANDLE pBitmap;	/* pointer to the bitmap handle */
L_UCHAR* pWorkBuffer;	/* pointer to a work buffer */
L_UINT16* pRunBuffer;	/* pointer to the source buffer */
L_UINT nRow;	/* number of the first row to update */
L_UINT nLines;	/* number of the rows to update */

Puts one or more rows of 1-bit compressed data from a buffer to a bitmap that is maintained in its compressed format.

This function is available in the Document and Medical Imaging toolkits.

Parameter	Description
pBitmap	Pointer to the bitmap handle referencing the bitmap to copy the rows into.
pWorkBuffer	NULL or a pointer to an optional work buffer. Allocating the work buffer speeds processing if you call this function more than once, because if you do not allocate a work buffer, the function allocates and frees a temporary buffer each time it is called. The size of this buffer should be the same as the bitmap handle's BytesPerLine field.
pRunBuffer	Pointer to the input buffer, which contains 1-bit compressed image data.
nRow	Number of the first row to update.
nLines	Number of rows to update.

Returns

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

Comments

This function is useful for working with 1-bit images that are loaded in their compressed formats for faster loading and display. For more information, refer to Speeding Up 1-Bit Documents.

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 2000 / XP/Vista, Windows CE.

Functions:	L_ExpandRow, L_CompressRow, L_GetBitmapRowColCompressed, L_PutBitmapRowColCompressed, L_GetBitmapRowCompressed
Topics:	Speeding Up 1-Bit Documents