Back to Adaptive Vision Library Lite website
You are here: Start » MATRIX VISION » mvGenTLAcquire_GrabImage_WithTimeout
![](../../img/icon/Matrix_GrabImage.png)
mvGenTLAcquire_GrabImage_WithTimeout
Captures a frame from MATRIX VISION cameras using mvGenTLAcquire SDK.
Syntax
bool avl::mvGenTLAcquire_GrabImage_WithTimeout ( mvGenTLAcquireState& ioState, atl::Optional<const atl::String&> inDeviceID, int inTimeout, avl::MVGenTLPixelFormat::Type inPixelFormat, atl::Optional<int> inExposureTime, atl::Optional<float> inGain, atl::Optional<float> inFrameRate, atl::Optional<const avl::Box&> inAoi, avl::MvIMPACTTriggerActivation::Type inTriggerMode, avl::MvIMPACTTriggerSource::Type inTriggerSource, atl::Conditional<avl::Image>& outImage )
Parameters
Name | Type | Range | Default | Description | |
---|---|---|---|---|---|
ioState | mvGenTLAcquireState& | Object used to maintain state of the function. | |||
![]() |
inDeviceID | Optional<const String&> | NIL | Device name or serial number of device | |
![]() |
inTimeout | int | 10 - ![]() |
Maximum time to wait for frame in milliseconds | |
![]() |
inPixelFormat | MVGenTLPixelFormat::Type | Pixel format of output image | ||
![]() |
inExposureTime | Optional<int> | 1 - +![]() |
NIL | Exposure time value |
![]() |
inGain | Optional<float> | NIL | Gain value | |
![]() |
inFrameRate | Optional<float> | 1.0 - ![]() |
NIL | Frame rate in FPS |
![]() |
inAoi | Optional<const Box&> | NIL | Required fragment of image to stream | |
![]() |
inTriggerMode | MvIMPACTTriggerActivation::Type | Trigger mode | ||
![]() |
inTriggerSource | MvIMPACTTriggerSource::Type | Source of trigger | ||
![]() |
outImage | Conditional<Image>& | Captured frame |
Multithreaded environment
This function is not guaranteed to be thread-safe. When used in multithreaded environment, it has to be manually synchronized.