Back to Adaptive Vision Library website

You are here: Start » Function Reference » BitFlow » BitFlow_GrabImage_WithTimeout

BitFlow_GrabImage_WithTimeout


Captures a frame using BitFlow frame grabber.

Syntax

bool avl::BitFlow_GrabImage_WithTimeout
(
	BitFlow_GrabImage_WithTimeoutState& ioState,
	int inBoardNumber,
	const atl::File& inCameraFileName,
	avl::BitFlowTriggerMode::Type inTriggerMode,
	avl::BitFlowTrigAssignments::Type inTriggerAssignments,
	avl::BitFlowTrigPolarity::Type inTriggerAPolarity,
	avl::BitFlowTrigPolarity::Type inTriggerBPolarity,
	int inTimeout,
	atl::Conditional<avl::Image>& outImage
)

Parameters

Name Type Range Default Description
ioState BitFlow_GrabImage_WithTimeoutState& Object used to maintain state of the function.
inBoardNumber int Index of board
inCameraFileName const File& Camera file
inTriggerMode BitFlowTriggerMode::Type Trigger mode of the current camera
inTriggerAssignments BitFlowTrigAssignments::Type Assign trigger to acquisition engine
inTriggerAPolarity BitFlowTrigPolarity::Type Polarity for trigger B
inTriggerBPolarity BitFlowTrigPolarity::Type Polarity for trigger A
inTimeout int 100 - 3600000 5000 Capture timeout
outImage Conditional<Image>& Captured frame

Remarks

Board driver software

This filter is intended to cooperate with board using its vendor SDK. To be able to connect with board it is required to install BitFlow SDK software. Currently Adaptive Vision Studio requires BitFlow SDK version 6.20.

BitFlow SDK can be downloaded from following website: http://www.bitflow.com (registration may be required).

Running application
This filter uses camera configuration files, which are loaded to register. To load this file to register you should use SysReg application from BitFlow SDK.
Camera identification

To identify the camera, configuration file should be loaded to Adaptive Vision Studio, using inCameraFileName input. Choosing index of board is too necessary.

Camera file must be located in configuration directory. Default configuration directory should be "C:\BitFlow SDK 5.90\Config". After that, correct directory should be used - it depends on type of board installed in system.

Camera parameters

To change trigger options or digital outputs, use Adaptive Vision Studio(see "See also" paragraph). Another parameters might be changed by creating new configuration file. Configuration tool "CamEd" available with BitFlow SDK 5.90 should be used.

Supported pixel formats
  • Mono8
  • Mono10
  • Mono12
  • Mono16
  • Rgb24
  • Rgb30
  • Rgb36
  • Rgb48

Multithreaded environment

This function is not guaranteed to be thread-safe. When used in multithreaded environment, it has to be manually synchronized.

See Also