Home > C: Programming > Function Descriptions > | History back Previous chapter Next chapter Print |
is_AllocImageMem |
uEye Camera Manual Version 3.80
is_AllocImageMem
USB 2.0 GigE |
USB 2.0 GigE |
Syntax
INT is_AllocImageMem (HIDS hCam,
INT width, INT height, INT bitspixel,
char** ppcImgMem, INT* pid)
Description
is_AllocImageMem() allocates an image memory for an image having its dimensions defined by width and height and its color depth defined by bitspixel. The memory size is at least:
size = [width * ((bitspixel + 1) / 8) + adjust] * height (for details on adjust, see below)
The line increment is calculated as:
line = width * [(bitspixel + 1) / 8]
lineinc = line + adjust.
adjust = 0, if line can be divided by 4 without remainder
adjust = 4 - rest(line / 4), if line cannot be divided by 4 without remainder
To read out the line increment, you can use the is_GetImgMemPitch() function.
The starting address of the memory area is returned in ppcImgMem.
pid returns an ID for the allocated memory. A newly allocated memory is not directly active, i.e. digitised images will not be stored immediately in this new memory. It must first be made active using is_SetImageMem().
The returned pointer must be write-protected and may not be altered because it will be used for all further ImageMem functions. To release the memory, you can use is_FreeImageMem().
|
|
|
Input Parameters
hCam |
Camera handle |
width |
Image width |
height |
Image height |
bitspixel |
Image bit depth (bits per pixel). |
ppcImgMem |
Returns the pointer to the memory starting address |
pid |
Returns the ID of this memory |
Return Values
IS_SUCCESS |
Function executed successfully |
IS_NO_SUCCESS |
General error message |
Related Functions
Sample Programs
• | uEyeRotationDemo (C++) |