USB 2.0 USB 3.0 GigE	USB 2.0 USB 3.0 GigE

Syntax

INT is_SetAllocatedImageMem (HIDS hCam, INT width, INT height, INT bitspixel, char* pcImgMem, int* pid)

Beschreibung

is_SetAllocatedImageMem() setzt einen vom Benutzer allozierten Speicher als aktiven Speicher, in den digitalisiert werden kann. Der Speicher muss groß genug alloziert werden und muss unbedingt global gesperrt sein.

Je nach eingestelltem Bildformat wird für den Speicher mehr als ein Byte pro Pixel verbraucht:

unsigned int uBytesPerPixel = (bitspixel+7)/8
unsigned int uImageSize = width * height * uBytesPerPixel;

Ein mit is_SetAllocatedImageMem() angegebener Speicher kann mit is_AddToSequence() in eine Sequenz eingebaut werden.

Die Adresse des Speichers wird an den uEye-Treiber übergeben. Dies geschieht mit der Funktion is_SetAllocatedImageMem(). Zusätzlich muss wie bei is_AllocImageMem() die Größe des Bildes angegeben werden. Die zurückgegebene Speicher-ID wird von anderen Funktionen benötigt, um auf den Speicher zuzugreifen.

Der Speicherbereich muss mit der Funktion is_FreeImageMem() wieder aus der Treiberverwaltung genommen werden. Hierbei wird der Speicher jedoch nicht freigegeben. Der Benutzer muss dafür sorgen, dass der Speicher freigegeben wird.

Nach is_SetAllocatedImageMem muss immer ein is_SetImageMem oder is_AddToSequence aufgerufen werden, damit die Bildaufnahme in den Bildspeicher erfolgen kann.

Übergabeparameter

Rückgabewert

Verwandte Funktionen

•is_AllocImageMem()

•is_FreeImageMem()

•is_AddToSequence()

•is_SetImageMem()

•is_GetColorDepth()

•is_GetImgMemPitch()

Beispiel Windows

HANDLE hMem = GlobalAlloc(0, uImageSize);

char* pcMem = (char*)GlobalLock(hMem);

INT nRet = is_SetAllocatedImageMem(hCam, uWidth, uHeight, uBitspixel, pcMem, &iMemID);

[…]

nRet = is_FreeImageMem(hCam, pcMem, iMemID);

GlobalUnlock(hMem);

GlobalFree(hMem);

Beispiel Linux

char* pcMem = (char*)malloc(uImageSize);

int iRet = mlock(pcMem, uImageSize);

INT nRet = is_SetAllocatedImageMem(hCam, uWidth, uHeight, uBitspixel, pcMem, &iMemID);

[…]

nRet = is_FreeImageMem(hCam, pcMem, iMemID);

iRet = munlock(pcMem, uImageSize);

free(pcMem);