Back to Adaptive Vision Library website

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

BitFlow_GrabImage_WithTimeout


Header:ThirdPartySdk.h
Namespace:avl

Captures a frame using BitFlow frame grabber.

Syntax

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

Parameters

Name Type Range Default Description
ioState BitFlow_BaseState& Object used to maintain state of the function.
inBoardNumber int Index of board
inCameraFileName const File& Camera file
inInputQueueSize int 1 - 200 4 Number of incoming frames that can be buffered before the application is able to process them
inTimeout int 1 - 3600000 5000 Capture timeout
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
outImage Conditional<Image>& Captured frame
outFrameID Conditional<int64>& Captured frame ID

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.30.

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