Allocating image memory

When you are programming an application that

•requires direct access to the image data in stored in memory, or

•uses Bitmap mode (DIB) for display

use the following functions to allocate and manage image memories (see also Quick start: Image display).

is_AllocImageMem()	Allocates an image memory.
is_SetAllocatedImageMem()	The user provides pre-allocated memory for image capturing.
is_FreeImageMem()	Releases an allocated image memory.

An image memory has to be activated before each image capture:

Makes an image memory active.

To query image memory information and access the data in the image memories, you can use these functions:

is_CopyImageMem()	Copies the image to the user-defined memory.
is_CopyImageMemLines()	Copies selected image lines to the user-defined memory.
is_GetActiveImageMem()	Returns the number and address of the active image memory.
is_GetImageMem()	Returns the pointer to the starting address of the image memory.
is_GetImageMemPitch()	Returns the line offset used in the image memory.
is_InquireImageMem()	Returns the properties of an image memory.

Hinweis

Image memory sequences should be used for frame sequence capture.

Flowchart: Allocating memory

Icon_Cursorhand2

Fig. 146: Flowchart - Allocating memory using system functions

Icon_Cursorhand2

Fig. 147: Flowchart - Releasing memory

Suggestion for improvement? Send us your short Feedback on this chapter. Thank you very much!

For technical questions please contact you local distributor or use the support form on our website.

Home > C: Programming > How to proceed > Preparing image capture >	History back Previous chapter Next chapter Print
Allocating image memory