Back to Aurora Vision Library Lite website

You are here: Start » Hardware Support » BitFlow » BitFlow_GrabImage_WithTimeout

BitFlow_GrabImage_WithTimeout


Header: ThirdPartySdk.h
Namespace: avl

Captures a frame using BitFlow frame grabber.

Applications: Use this filter if the trigger may be not coming for some time, while the application should be performing other operations continuously (e.g. processing HMI events).

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
Input will be modified ioState BitFlow_BaseState& Object used to maintain state of the function.
Input value inBoardNumber int Index of board
Input value inCameraFileName const File& Camera file
Input value inInputQueueSize int 1 - 200 4 Number of incoming frames that can be buffered before the application is able to process them
Input value inTimeout int 1 - 3600000 5000 Capture timeout
Input value inTriggerMode BitFlowTriggerMode::Type Trigger mode of the current camera
Input value inTriggerAssignments BitFlowTrigAssignments::Type Assign trigger to acquisition engine
Input value inTriggerAPolarity BitFlowTrigPolarity::Type Polarity for trigger B
Input value inTriggerBPolarity BitFlowTrigPolarity::Type Polarity for trigger A
Output value outImage Conditional<Image>& Captured frame
Output value 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 Aurora 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 Aurora 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 Aurora 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