You are here: Start » Filter Reference » Camera Support » STC » STC_StartAcquisition

STC_StartAcquisition

Module:	ThirdParty

Initializes and starts image acquisition in device.

Name	Type	Range	Description
inDeviceID	String *		Device identifying number
inInputQueueSize	Integer	1 - 200	Capacity of output frames queue
inPixelFormat	OmronPixelFormat *		Format of the pixels provided by the device
inRoi	Box *		Region of interest
inAcquisitionMode	OmronAcquisitionMode *		Acquisition mode of the device
inAcquisitionFrameCount	Integer *		Number of frames to acquire in MultiFrame Acquisition mode
inFrameRate	Double *		Acquisition rate in Hertz at which the frames are captured
inExposureAuto	Bool *		Enables or disables the automatic exposure time control
inExposureTime	Double *		Exposure time in microseconds
inGainAuto	Bool *		Enables or disables the automatic gain control
inGain	Double *		Gain as an absolute physical value
inGamma	Double *		Gamma correction of pixel intensity
inBlackLevel	Double *		Black level as an absolute physical value
inTriggerEnable	Bool *		Controls if the selected trigger is active
inTriggerSource	OmronTriggerSource *		Source of the acquisition trigger
inTriggerActivation	OmronTriggerActivation *		Activation mode of the trigger
inTriggerDelay	Double *		Delay in microseconds to apply after the trigger reception before activating it

Remarks

This filter is intended for establishing connection with an Omron camera device using Sentech SDK Package 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 STC_GrabImage or to start multiple cameras in sync before the acquisition phase.

The use of this filter is not obligatory. STC_GrabImage or STC_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 Sentech SDK Package software with camera dedicated drivers.

Sentech SDK Package can be downloaded from the following website: https://sentech.co.jp/en/data/software/ (registration may be required).

Add DLL path to system environment variable may be required.

Recommended Sentech SDK Package version for FabImage Studio usage is 1.1.2 Update 3.

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:

Serial Number - should be printed on the device housing.
Device ID - unique device identifier that can be viewed in StViewer utility.
Device User ID - user-programmable device identifier that can be set in StViewer utility.

Camera parameters

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

Complexity Level