Back to Aurora Vision Library website

You are here: Start » Function Reference » Camera Support » Thorlabs » Thorlabs_GrabImage

Thorlabs_GrabImage


Header: ThirdPartySdk.h
Namespace: avl
Module: ThirdParty

Captures an image from a Thorlabs device.

Syntax

bool avl::Thorlabs_GrabImage
(
	Thorlabs_State& ioState,
	atl::Optional<const atl::String&> inDeviceID,
	atl::Optional<int> inInputQueueSize,
	atl::Optional<int> inExposureTime,
	atl::Optional<int> inGain,
	avl::Image& outImage,
	int& outFrameID
)

Parameters

Name Type Range Default Description
Input will be modified ioState Thorlabs_State& Object used to maintain state of the function.
Input value inDeviceID Optional<const String&> NIL Camera serial number or name, Auto = first camera
Input value inInputQueueSize Optional<int> 0 - NIL Sets size of image queue (on acquisition start, default = 8)
Input value inExposureTime Optional<int> 1 - 50000 Sets the target exposure time in microseconds
Input value inGain Optional<int> 0 - 1023 120 Sets gain
Output value outImage Image& Captured frame
Output value outFrameID int& Captured frame ID

Remarks

Camera driver software

This filter is intended to cooperate with camera using its vendor Thorlabs SDK. To be able to connect to camera it is required to install Thorlabs SDK software with camera dedicated drivers. Currently Aurora Vision Studio uses Thorlabs SDK version 2.9.1.

Thorlabs SDK can be downloaded from the following website: https://www.thorlabs.com/software_pages/ViewSoftwarePage.cfm?Code=ThorCam

Multithreaded environment

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

See Also