Sensoray 711 - Manual (Page 10)

Sensoray Model 711 Instruction Manual 11
When an image buffer is allocated, every frame is associated with a Windows DIB, and
corresponding data structure is created. This simplifies the display of acquired images using
Windows API. However, lpvbits could be used as a general purpose pointer to the frame
data. See Windows API Help for the description of bitmaps, related data structures, and
display functions.
Note: the BITMAPINFO structure is created even if the buffer is created as a "flat" buffer
(see the description of store member in MODE structure). In such a case Windows API
functions will display the image upside down.
BUFFER
typedef struct {
HBUF hbuf;
DWORD dwFrames;
FRAME frame[SYS_FRAMES];
} BUFFER;
The BUFFER structure contains information about the image buffer allocated by the system.
Image buffer may consist of one or more image frames. Acquisition functions always fill all
the frames of an image buffer with the data corresponding to consecutively grabbed video
frames.
Member Description
hbuf Handle to the image buffer.
dwFrames Number of frames in the image buffer.
frame[SYS_FRAMES] Array of FRAME structures.
The BUFFER structure is initialized by X11_AllocBuffer function.
MODE
typedef struct {
DWORD scale;
DWORD color;
DWORD store;
DWORD input;
MODE_ADVANCED advanced;
} MODE;
The MODE structure contains information about the operation mode of the frame grabber.
The settings that are not likely to be used frequently are hidden inside the advanced
member.
Member Description
scale Defines image scale. Can be one of the following:
Value Description
SCALE_ADVANCED Image scale is defined by the
settings in the MODE_ADVANCED
structure.
SCALE8 Full size image.