Back to Adaptive Vision Library website

You are here: Start » Function Reference » SmartRay » SmartRay_StartAcquisition

SmartRay_StartAcquisition


Header:ThirdPartySdk.h
Namespace:avl

Start acquisition using SmartRay.

Syntax

void avl::SmartRay_StartAcquisition
(
	SmartRay_State& ioState,
	const atl::String& inAddress,
	int inPort,
	int inConnectionTimeout,
	int inInputQueueSize,
	float inTransportResolution,
	int inNumberOfProfiles,
	atl::Optional<const atl::File&> inCalibrationFile,
	avl::SmartRayImageAcquisitionType::Type inAcquisitionType,
	const avl::SmartRayDataTrigger& inDataTrigger,
	atl::Optional<bool> inSmartXccelerate,
	atl::Optional<const avl::SmartRayRegionOfInterest&> inRegionOfInterest,
	atl::Optional<const avl::SmartRayExposure&> inExposure,
	atl::Optional<const avl::SmartRayLaser&> inLaser,
	atl::Optional<const avl::SmartRayStartTrigger&> inStartTrigger,
	atl::Optional<const avl::SmartRayReflectionFilter&> inReflectionFilter,
	atl::Optional<const atl::Array<int>&> inLaserLineThreshold,
	atl::Optional<const avl::SmartRayZmapResolution&> inZmapResolution
)

Parameters

Name Type Range Default Description
ioState SmartRay_State& Object used to maintain state of the function.
inAddress const String& \"192.168.178.200\" Device identifying address
inPort int 40 Device identifying network port
inConnectionTimeout int 1 - 1000 60 Timeout in seconds
inInputQueueSize int 1 - 200 4 Capacity of output frames queue
inTransportResolution float 0.0 - 1.0f Defines x-axis step for every profile
inNumberOfProfiles int 10 Number of profiles to capture
inCalibrationFile Optional<const File&> NIL Do not set file to load data from device internal memory
inAcquisitionType SmartRayImageAcquisitionType::Type
inDataTrigger const SmartRayDataTrigger&
inSmartXccelerate Optional<bool> NIL
inRegionOfInterest Optional<const SmartRayRegionOfInterest&> NIL
inExposure Optional<const SmartRayExposure&> NIL
inLaser Optional<const SmartRayLaser&> NIL
inStartTrigger Optional<const SmartRayStartTrigger&> NIL
inReflectionFilter Optional<const SmartRayReflectionFilter&> NIL
inLaserLineThreshold Optional<const Array<int>&> NIL
inZmapResolution Optional<const SmartRayZmapResolution&> NIL

Remarks

Device identification

inAddress can be used to pick one of multiple devices connected to the computer. inAddress can be set to:

  • IP Address - SmartRay Device identifying IP address (e.g. "127.0.0.1")

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 SmartRay SDK software with camera dedicated drivers.

Add DLL path to system environment variable may be required.

Recommended SmartRay SDK version for Adaptive Vision Studio usage is 5.1.2.39.

Disable firewall software and set 192.168.178.100 static IP in your network interface may be needed.

SmartRay SDK may need Microsoft Visual C++ 2010 Redistributable Package for 64-bit architecture.

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.

Multithreaded environment

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

See Also