L_ExpandRows

#include "l_bitmap.h"

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

L_UINT16 L_HUGE * pRun;

/* pointer to the input buffer */

L_UCHAR L_HUGE * pBuffer;

/* pointer to the output buffer */

L_UINT nWidth;

/* number of pixels in each row */

L_UINT nRows;

/* number of rows */

Does buffer-to-buffer decompression of RLE-compressed 1-bit image data. Use this function to process multiple lines of image data. This function is available in the Document/Medical Toolkits.

Parameter

Description

PRun

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

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.

NWidth

The number of pixels in each row.

NRows

The number of rows to process.

Returns

> 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.

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_CompressRow, L_ExpandRow, L_CompressRows, L_GetBitmapRowColCompressed, L_PutBitmapRowColCompressed, L_GetBitmapRowCompressed, L_PutBitmapRowCompressed

Topics:

Speeding Up 1-Bit Documents

Example

For an example,refer to L_GetBitmapRowCompressed.