LEADTOOLS Raster Imaging C DLL Help
| LEADTOOLS Raster Imaging C DLL Help > Function References > L_PutPixelData |
#include "l_bitmap.h"
L_LTKRN_API L_INT L_PutPixelData(pBitmap, pData, nRow, nCol, uBytes)
|
pBITMAPHANDLE pBitmap; |
/* pointer to the bitmap handle */ |
|
L_VOID* pData; |
/* pointer to a buffer */ |
|
L_INT nRow; |
/* row number of the pixel */ |
|
L_INT nCol; |
/* column number of the pixel */ |
|
L_SIZE_T uBytes; |
/* size of the buffer */ |
Changes the data of the specified pixel. No transformations are performed on the pixel data.
|
Parameter |
Description |
|
pBitmap |
Pointer to the bitmap handle referencing the bitmap. |
|
pData |
Pointer to a buffer that contains the pixel data to set. This buffer should be able to store uBytes bytes. |
|
nRow |
The row number of the pixel. This is a zero-based value. |
|
nCol |
The column number of the pixel. This is a zero-based value. |
|
uBytes |
Size of the buffer pointed to by pData. The size should be large enough to contain the data for the pixel. The minimum size can be calculated with the following formula: (pBitmap->BitsPerPixel + 7) / 8. |
Returns
|
SUCCESS |
The function was successful. |
|
< 1 |
An error occurred. Refer to Return Codes. |
Comments
The bitmap's memory must be locked when you use this function. Normally, call L_AccessBitmap to lock the memory before starting an operation that uses this function and then call L_ReleaseBitmap when the operation is finished.
This function should be called only for 8, 16, 24, 32, 48 and 64-bit bitmaps. For more information, refer to L_GetPixelData.
Required DLLs and Libraries
|
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
Win32, x64, Linux.
See Also
|
Functions: |
L_GetPixelData, L_GetPixelColor, L_AccessBitmap, L_ReleaseBitmap, L_GetBitmapRow, L_PutBitmapRow, L_GetBitmapRowCol, L_PutBitmapRowCol |
|
Topics: |
|
|
|
Example
For an example, refer to L_GetPixelData.
