Back to Adaptive Vision Library Lite website
You are here: Start » Hikvision » Hikvision_StartAcquisition
![](../../img/icon/Hikvision.png)
Hikvision_StartAcquisition
Initializes and starts image acquisition in a device.
Syntax
void avl::Hikvision_StartAcquisition ( Hikvision_State& ioState, atl::Optional<const atl::String&> inDeviceID, int inInputQueueSize, avl::HikvisionPixelFormat::Type inPixelFormat, atl::Optional<const avl::Box&> inRoi, atl::Optional<float> inFrameRate, bool inFrameRateAuto, atl::Optional<float> inExposureTime, bool inExposureTimeAuto, atl::Optional<float> inGain, bool inGainAuto )
Parameters
Name | Type | Range | Default | Description | |
---|---|---|---|---|---|
ioState | Hikvision_State& | Object used to maintain state of the function. | |||
![]() |
inDeviceID | Optional<const String&> | NIL | Camera serial number or name, Auto = first camera | |
![]() |
inInputQueueSize | int | 1 - ![]() |
8 | Sets size of image queue (on acquisition start) |
![]() |
inPixelFormat | HikvisionPixelFormat::Type | Image pixel format (set on acquisiton start) | ||
![]() |
inRoi | Optional<const Box&> | NIL | Region of interest, Auto = full frame (set on acquisiton start) | |
![]() |
inFrameRate | Optional<float> | 0.0 - ![]() |
NIL | Sets the frame rate limit |
![]() |
inFrameRateAuto | bool | True | True if frame rate is not limited | |
![]() |
inExposureTime | Optional<float> | 0.0 - ![]() |
10000.0f | Sets the target exposure time in microseconds |
![]() |
inExposureTimeAuto | bool | True if using automatic exposure time | ||
![]() |
inGain | Optional<float> | 0.0 - ![]() |
0.0f | Sets gain in dB |
![]() |
inGainAuto | bool | True if using automatic gain |
Multithreaded environment
This function is not guaranteed to be thread-safe. When used in multithreaded environment, it has to be manually synchronized.