LBitmapBase::PutRow

#include "ltwrappr.h"

virtual L_SSIZE_T LBitmapBase::PutRow(LBuff, nRow)

LBuffer & LBuff;

/* an LBuffer object */

L_INT nRow;

/* number of the row to update */

Copies a row of image data from an LBuffer object, to a bitmap. The data is copied exactly as it is stored in the buffer. The buffer contains uncompressed data.

Parameter

Description

LBuff

An LBuffer object that contains the row data.

nRow

The number of the row to update. The first row is 0, and the last row is 1 less than the bitmap height.

Returns

>=1

The number of bytes put.

< 1

An error occurred. Refer to Return Codes.

Comments

The bitmap memory must be locked when you use this function. Normally, you can call LBitmapBase::Access to lock the memory before starting an operation that uses this function, then call LBitmapBase::Release when the operation is finished.

You can use the bits per pixel of the image to determine the number of bytes to set the uBytes parameter. If the image is 8-bit then each byte is an index to the palette. If the image is a 24-bit image, then each three bytes represents one pixel element. Color order is determined by the LBitmapBase::GetColorOrder. This value can be either ORDER_RGB, ORDER_BGR, ORDER_GRAY, or ORDER_ROMM.

The LBuff parameter is passed by reference, and is a required parameter.

Required DLLs and Libraries

LTDIS
LTFIL

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

See Also

Functions:

LBitmapBase::PutRowCol, LBitmapBase::PutRowCompressed, LBitmapBase::GetRow, LBitmapBase::PutRowColCompressed, LBitmapBase::GetRowCol, LBitmapBase::GetRowColCompressed, Class Members

Topics:

Raster Image Functions: Getting and Setting Pixel Values

Example

For an example, refer to LBitmapBase::GetRow.