Image Manager (CVCDriver.dll) 14.0
IBoardSelect2

Interface for selecting a board. More...

Functions

cvbres_t BS2GetBoard (IMG Image, cvbval_t &lActBoard)
 Returns the number of the currently selected image acquisition device. More...
 
cvbres_t BS2GetNumBoards (IMG Image, cvbval_t &lNumBoards)
 Detects the number of image acquisition devices installed in the system. More...
 
cvbres_t BS2SetBoard (IMG Image, cvbval_t lNewBoard, IMG &imgNew)
 Sets the current image acquisition device. More...
 
cvbbool_t CanBoardSelect2 (IMG Image)
 This function verifies whether the image supports the BoardSelect2 interface. More...
 

Detailed Description

Interface for selecting a board.

Function Documentation

◆ BS2GetBoard()

cvbres_t BS2GetBoard ( IMG  Image,
cvbval_t &  lActBoard 
)

Returns the number of the currently selected image acquisition device.

Parameters
[in]ImageHandle of image object.
[out]lActBoardNumber of the current image acquisition device.
Returns
0 : OK
<0 : an error occured
Supported platforms:
Win32
Win64
Linux
Examples:
Visual C++ - VC MDI Example (DLL only)

◆ BS2GetNumBoards()

cvbres_t BS2GetNumBoards ( IMG  Image,
cvbval_t &  lNumBoards 
)

Detects the number of image acquisition devices installed in the system.

Attention
In this case you can select a board within the range 0 to NumBoards-1 via the BS2SetBoard function.
If the value for NumBoards is 0 then the IBoardSelect2 Interface is not supported. Please check before with the CanBoardSelect2 function.
Parameters
[in]ImageHandle of image object.
[out]lNumBoardsNumber of image acquisition devices.
Returns
0 : OK
<0 : an error occured
Supported platforms:
Win32
Win64
Linux
Examples:
Visual C++ - VC MDI Example (DLL only)

◆ BS2SetBoard()

cvbres_t BS2SetBoard ( IMG  Image,
cvbval_t  lNewBoard,
IMG &  imgNew 
)

Sets the current image acquisition device.

Attention
A new image is returned. The old image still exists but all driver interfaces 'move' to the new image. The old image (Image) and the new Image (imgNew) have to be released with ReleaseObject when they are not needed anymore.
Parameters
[in]ImageHandle of image object.
[in]lNewBoardBoard to be set active.
[out]imgNewNew image representing the new image acquisition device. All driver interfaces are moving to this new image.
Returns
0 : OK
<0 : an error occured
Supported platforms:
Win32
Win64
Linux
Examples:
Visual C++ - VC MDI Example (DLL only)
Example Code in Visual Basic:

Parallel acquisition from two framegrabbers or cameras supporting the BoardSelect2 interface.
Dim tempImg As Long
CVimage1.LoadImageByDialog ' load driver for camera '
If CanBoardSelect2(CVimage1.Image) Then
'switch to Camera 1
BS2SetBoard(CVimage1.Image, 1, tempImg)
' assign to Image2 and Display2 '
CVimage2.Image = tempImg
ReleaseImage tempImg
CVimage2.Snap
CVdisplay2.Image = CVimage2.Image
'load driver for Camera 0 '
CVimage1.LoadImage (CVimage1.FileName)
CVdisplay1.Image = CVimage1.Image
Else
MsgBox "no BoardSelect2 Interface"
End If
cvbres_t BS2SetBoard(IMG Image, cvbval_t lNewBoard, IMG &imgNew)
Sets the current image acquisition device.
Definition: BoardSelect2Exports.cpp:145
cvbbool_t CanBoardSelect2(IMG Image)
This function verifies whether the image supports the BoardSelect2 interface.
Definition: BoardSelect2Exports.cpp:40
cvbres_t Snap(IMG Image)
Acquires a single image.
Definition: GrabberExports.cpp:135

◆ CanBoardSelect2()

cvbbool_t CanBoardSelect2 ( IMG  Image)

This function verifies whether the image supports the BoardSelect2 interface.

Parameters
[in]ImageHandle of image object.
Returns
TRUE if the image supports the BoardSelect2 interface, FALSE otherwise.
Supported platforms:
Win32
Win64
Linux
Examples:
Visual C++ - VC MDI Example (DLL only)