Back to Adaptive Vision Studio website

You are here: Start » Filter Reference » Camera Support » Smart » Smart_GrabImage


Module: ThirdParty

Captures an image from a smart camera using AvSMART interface. Allows for remote access to the runtime system.

Name Type Range Description
Input value
inIpAddress SmartIPAddress IP address of the runtime system (e.g. a smart camera)
Input value
inPixelFormat RoseekImageFormat Image color format
Input value
inFrameRate Real* Requested camera frame rate in frames per second
Input value
inWorkingMode RoseekWorkingMode* Working mode of image acquisition
Input value
inSensitivityLevel Integer* 0 - 3 Sensitivity level of camera sensor
Input value
inExposureMode RoseekExposureMode* Exposure mode, should be set to Manual if you want to adjust inExposureTime manually
Input value
inExposureTime Integer* 0 - Camera frame exposition time
Input value
inGain Real* 0.0 - 36.0 Camera exposure gain
Output value
outImage Image Captured frame
Output value
outIsRemote Bool


For more information about Remote Access to the Runtime Application please refer to the following article. Please pay attention especially to the second part of the article, there you will find a detailed description of remote image grabbing procedure.

Multithreaded environment

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


This filter can throw an exception to report error. Read how to deal with errors in Error Handling.

List of possible exceptions:

Error type Description
RuntimeError Smart_GrabImage is not supported in the Lite edition.

Complexity Level

This filter is available on Basic Complexity Level.

Filter Group

This filter is member of Smart_GrabImage filter group.