You are here: Start » Function Reference » Ensenso » Ensenso_StartAcquisition

Ensenso_StartAcquisition

Starts capturing images from an Ensenso camera.

Syntax

void avl::Ensenso_StartAcquisition
(
	Ensenso_State& ioState,
	const atl::Optional<atl::String> inDeviceID,
	const atl::Optional<atl::File>& inSettingsFile,
	const atl::Optional<atl::File>& inCalibrationFile,
	const bool inSoftwareTriggered
)

Parameters

Name	Type	Default	Description
ioState	Ensenso_State&		Object used to maintain state of the function.
inDeviceID	const Optional<String>	NIL	Device identifying string
inSettingsFile	const Optional<File>&	NIL	Initial JSON encoded parameters for camera
inCalibrationFile	const Optional<File>&	NIL	Initial JSON encoded parameters for camera
inSoftwareTriggered	const bool	False	When true, capture will wait for GenerateSoftwareTrigger

Remarks

Initial parameters

Initial parameters are only set during capture start. To change parameters either restart the stream, or use appropriate Set/Get filters.

Camera driver software

This filter is intended to cooperate with cameras using their vendor's SDK. In order to connect with the camera, it is required to install Ensenso SDK software, and uEye driver (same as in IDS camera filters)

Ensenso SDK can be downloaded from the following website: https://www.ensenso.com/support/sdk-download/

uEye driver can be downloaded from the following website: https://en.ids-imaging.com/download-ueye.html

Recommended Ensenso SDK version for Adaptive Vision Studio usage is 2.0 and uEye driver 4.90.

Camera identification

When there is only one Ensenso camera connected, the field inDeviceID can be set to Auto. In this situation, the first available camera will be used.

inDeviceID can be used to pick one of multiple cameras connected to the computer. inDeviceID should be set to camera ID.

Multithreaded environment

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