L_AccessBitmap (original) (raw)

Summary

Provides exclusive access to the image data contained in a bitmap handle.

Syntax

#include "l_bitmap.h"

L_LTKRN_API L_VOID L_AccessBitmap(pBitmap)

Parameters

pBITMAPHANDLE pBitmap

Pointer to the bitmap handle that references the bitmap to lock.

Returns

None.

Comments

This call locks the memory. If you do not call this function before accessing the data with a low-level function such as L_GetBitmapRow or L_PutBitmapRow, the application will fail.

To make the most of available system resources, you should only keep a bitmap handle locked when you need to access the image data. Call L_ReleaseBitmap to unlock the bitmap data for more efficient use of Windows memory resources.

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

Win32, x64, Linux.

See Also

Functions

• L_ReleaseBitmap
• L_ClearBitmap
• L_GetBitmapRow
• L_PutBitmapRow
• L_GetBitmapRowCol
• L_PutBitmapRowCol
• L_GetPixelColor
• L_PutPixelColor

Topics

• Raster Image Functions: Getting and Setting Pixel Values

Example

For an example, refer to L_GetBitmapRow.
For complete sample code, refer to the GETROW
example.

LEADTOOLS Raster Imaging C API Help