You are here: Start » Filter Reference » Camera Support » cxCam » cxCam_StartAcquisition

cxCam_StartAcquisition

Module:	ThirdParty

Initializes and starts image acquisition in a camera.

Name	Type	Range	Description
inDeviceID	String *		Device URI
inInputQueueSize	Integer	3 - 200	Capacity of output frames queue
inModeAndAlgorithm	CxCamModeAndAlgorithmConfiguration *		3D algorithm configuration.
inC6ComponentSelector	CxCamC6ComponentSelector *		Component selector for C6 family.
inPixel	CxCamImagePixel		Output pixel type.
inScannerMode	CxCamScannerMode		Scanner mode.
inAcquisitionMode	CxCamAcquisitionMode		AcquisitionMode.
inTriggerMode	CxCamTriggerMode *		Trigger mode.
inSequencerMode	CxCamTriggerSequencerMode *		Trigger sequencer mode.
inC6TriggerSetup	CxCamC6TriggerSetup Array		Trigger setup for C6 family.

Remarks

This filter is intended for establishing connection with a Automation Technology 3D camera device using cxCam Packager interface, to initialize image streaming. It is only needed when explicit image acquisition start is required in the initial phase of a program. For example, it can be used to prepare a camera, running in triggered mode, to be able to capture trigger signals before the first invoke of cxCam_GrabData or to start multiple cameras in sync before the acquisition phase.

The use of this filter is not obligatory. cxCam_GrabData or cxCam_GrabData_WithTimeout filters will initialize and start image acquisition upon their first invoke.

This filter has no effect when invoked for the second time and when invoked after image grabbing filters.

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 AT SolutionPackage Software (previously known as cxCam Support Package) with camera dedicated drivers.

Package can be downloaded from the following website: https://www.at-sensors.com/product-support/downloads/ (registration may be required).

It may also be required to install GigE Vision Transport Layer as described here.

Add DLL path to system environment variable may be required. The SDK is divided into several directories with shared libraries - you have to add them all.

You should install the transport layer from Common Vision Box Runtime. The lack of this component may cause the application to behave unexpectedly.

Installing special network transport transport layer from vendor may be required.

Recommended AT SolutionPackage Software version for Aurora Vision Studio usage is 2023.12.

32-bit platform is not supported.

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:

URI - should be specified on device casing.

Camera parameters

Setting inInputQueueSize parameter to 'Auto' will select four value as input queue size.

All the other parameters exposed by camera filters are optional, setting them to 'Auto' leaves related parameter unchanged in camera (device default or user set configuration).

To change other, more advanced camera parameters, use specific filters.

Complexity Level

This filter is available on Advanced Complexity Level.

Disabled in Lite Edition

This filter is disabled in Lite Edition. It is available only in full, Aurora Vision Studio Professional version.