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/Medical 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