Back to Adaptive Vision Studio website

You are here: Start » Filter Reference » Microview » Microview_StartAcquisition

Microview_StartAcquisition


Start acquisition using Microview.

Name Type Range Description
inDeviceID Integer* 0 - 10000 Device identifying number
inInputQueueSize Integer 1 - 200 Capacity of output frames queue
inJumboFrameSupport Bool
inRescanNeeded Bool
inUsersSettingsParams MicroviewUsersSettingsParams
inImageFormat MicroviewImageFormatParams
inAcquisitionControl MicroviewAcquisitionParams
inTriggerControl MicroviewTriggerParams

Remarks

This filter is intended for establishing connection with a Microview camera device using MVGESDK 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 Microview_GrabImage or to start multiple cameras in sync before the acquisition phase.

The use of this filter is not obligatory. Microview_GrabImage or Microview_GrabImage_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 MVGESDK software with camera dedicated drivers.

MVGESDK can be downloaded from the following website: http://www.microview.com.cn (registration may be required).

Recommended MVGESDK version for Adaptive Vision Studio usage is 2.8.

Add DLL path to system environment variable may be required.

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:

  • Device number - should be specified on device casing.
Camera parameters

Setting inJumboFrameSupport parameter to 'true' will select maximum possible camera package size.

Setting inRescanNeeded parameter to 'true' will rescan network to search new cameras.

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

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.

See Also