L_ExpandRows

#include "l_bitmap.h"

L_LTKRN_API L_INT L_ExpandRows(pRun, pBuffer, nWidth, nRows)

Does buffer-to-buffer decompression of RLE-compressed 1-bit image data. Use this function to process multiple lines of image data.

Parameters

L_UINT16* pRun

Pointer to the input buffer containing 1-bit compressed image data.

L_UCHAR* pBuffer

Pointer to the output buffer, which is to be filled with 1-bit image data. The size of each row must be rounded up to a multiple of 4 bytes. Use integer math to calculate the required size of this buffer as follows: bytes required = (((nWidth + 31) &~31)/ 8) * nRows.

L_UINT nWidth

The number of pixels in each row.

L_UINT nRows

The number of rows to process.

Returns

Value	Meaning
> 0	The number of pixels processed.
< 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.