You are here: Start » Filter Reference » SiliconSoftware » SiliconSoftware_GrabImage

SiliconSoftware_GrabImage

Captures a frame using Silicon Software board.

Name	Type	Range	Description
inDeviceIndex	Integer *	0 -	Device identifying number
inAppletPath	String *		Applet to load
inPort	Integer	0 -	DMA port
inInputQueueSize	Integer	4 - 200	Capacity of output frames queue
inConfigurationFile	File *		Configuration file path
outImage	Image		Captured frame

Remarks

Device identification

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

Device Index - Silicon Software board identifying internal index.

Frame grabber driver software

This filter is intended to cooperate with a microEnable using its vendor SDK. To be able to connect to a device, it is required to install Silicon Software Runtime with frame grabber dedicated drivers. We also recommended install version with applets.

Silicon Software Runtime can be downloaded from the following website: https://silicon.software/product/microenable-5-acl-marathon/.

Add DLL path to system environment variable may be required.

Recommended Runtime version for Adaptive Vision Studio usage is 5.7.0.

Load applets to device memory may be needed for some devices. Please use RT microDisplay software for this purpose.

Each frame grabber is initializing master mode. Acquisition is started in non blocking mode.

Device parameters

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

Setting inAppletPath parameter to 'Auto' will select currently loaded and activated applet.

Setting inConfigurationFile is recommended way to configure acquisition properties instead of SiliconSoftware_SetParameter function.

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.

List of available parameters, including acquisition triggering, depends on applet type and will contains custom options. You can find it in device vendor documentation and current selected applet documentation.

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.

Filter Group

This filter is member of SiliconSoftware_GrabImage filter group.