Back to Adaptive Vision Studio website

You are here: Start » Filter Reference » Camera Support » SmartRay » SmartRay_GrabImage


Module: ThirdParty

Captures a live image using SmartRay.

Name Type Range Description
inAddress String Device identifying address
inPort Integer Device identifying network port
inConnectionTimeout Integer 1 - 1000 Timeout in seconds
inInputQueueSize Integer 1 - 200 Capacity of output frames queue
inDataTrigger SmartRayDataTrigger
inSmartXccelerate Bool*
inRegionOfInterest SmartRayRegionOfInterest*
inExposure SmartRayExposure*
inLaser SmartRayLaser*
inStartTrigger SmartRayStartTrigger*
inReflectionFilter SmartRayReflectionFilter*
inLaserLineThreshold IntegerArray*
outImage Image Captured live image


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. "")

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

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

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

ECCO 35 and ECCO 55 series

Using SmartRay_LoadParameterSet before start acquisition or grab filter for this devices may be mandatory.

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.

Complexity Level

This filter is available on Basic Complexity Level.

Disabled in Lite Edition

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

Filter Group

This filter is member of SmartRay_GrabImage filter group.

See Also