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]	Image	Handle of image object.
[out]	lActBoard	Number 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]	Image	Handle of image object.
[out]	lNumBoards	Number 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]	Image	Handle of image object.
[in]	lNewBoard	Board to be set active.
[out]	imgNew	New 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

CanBoardSelect2()

cvbbool_t CanBoardSelect2

(

IMG

Image

)

This function verifies whether the image supports the BoardSelect2 interface.

Parameters

[in]

Image

Handle 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)