Back to Aurora Vision Library website

You are here: Start » Function Reference » Camera Support » OptoEngineeringHRAS » OptoEngineeringHRAS_COE71_StartAcquisition

OptoEngineeringHRAS_COE71_StartAcquisition


Header: ThirdPartySdk.h
Namespace: avl
Module: ThirdParty

Initializes and starts image acquisition in a camera.

Syntax

void avl::OptoEngineeringHRAS_COE71_StartAcquisition
(
	OptoEngineering_State& ioState,
	atl::Optional<const atl::String&> inDeviceID,
	int inInputQueueSize,
	avl::OptoEngineeringBitDepth::Type inBitDepth,
	atl::Optional<avl::OptoEngineering_COE71_StrobePolarity::Type> inStrobePolarity,
	avl::OptoEngineering_COE71_TriggerMode::Type inTriggerMode,
	atl::Optional<float> inDigitalGain,
	atl::Optional<int> inDigitalOffset,
	atl::Optional<int> inExposureTime,
	avl::OptoEngineeringExposureUnit::Type inExposureUnit
)

Parameters

Name Type Range Default Description
Input will be modified ioState OptoEngineering_State& Object used to maintain state of the function.
Input value inDeviceID Optional<const String&> NIL Device identifying number
Input value inInputQueueSize int 1 - 12 Capacity of output frames queue
Input value inBitDepth OptoEngineeringBitDepth::Type Number of pixel bits
Input value inStrobePolarity Optional<OptoEngineering_COE71_StrobePolarity::Type> NIL Polarity of strobe output signal
Input value inTriggerMode OptoEngineering_COE71_TriggerMode::Type Device triggering mode
Input value inDigitalGain Optional<float> 0.0 - 16.0 NIL Gain of source image in device raw unit
Input value inDigitalOffset Optional<int> -32767 - 32767 NIL Offset of source image in device raw unit
Input value inExposureTime Optional<int> 1 - 65535 NIL Camera frame exposition time
Input value inExposureUnit OptoEngineeringExposureUnit::Type Camera frame exposition time unit

Remarks

Camera driver software

This filter is intended to cooperate with a camera using its vendor SDK. To be able to connect to a camera, it is required to install eBUS software with camera dedicated drivers.

eBUS SDK can be downloaded from the following website: https://supportcenter.pleora.com/s/topic/0TO340000004X6dGAE/ebus-sdk?tabset-0c866=2&tabset-25adb=81d66 (registration may be required).

Recommended eBUS SDK version for Aurora Vision Studio usage is 5.1.10.4642.

Add DLL path to system environment variable may be required.

Camera identification

When there is only one camera connected to a computer, field inDeviceID can be set to Auto. In this case, first available camera will be found and connected.

inDeviceID field can be used to pick one of multiple cameras connected to computer. DeviceID can be set to:

  • Device unique id number - should be specified on device casing.
Camera parameters

To change other and more advanced internal camera parameters use configuration tool "Camera Control Application" available from the following website: https://www.opto-e.com/products/coe-area-scan#Downloads (registration may be required).

Other device settings can be changed also with eBUs Player available from the following website: https://www.pleora.com/products/ebus-sdk/ (registration may be required).

Supported devices

This filter support only COE HR AS 50, 71 and 29 series with USB interface. COE-71 devices have dedicated support.

Multithreaded environment

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

See Also