Back to Adaptive Vision Studio website

You are here: Start » Filter Reference » Hikvision » Hikvision_GrabImage

Hikvision_GrabImage


Captures an image from a Hikvision device.

Name Type Range Description
inDeviceID String* Camera serial number, name or IP address, Auto = first camera
inInputQueueSize Integer 1 - Sets size of image queue (on acquisition start)
inPixelFormat HikvisionPixelFormat Image pixel format (set on acquisition start)
inRoi Box* Region of interest (set on acquisition start)
inFrameRate Real* 0.0 - Sets the frame rate limit
inFrameRateAuto Bool True if frame rate is not limited
inExposureTime Real* 0.0 - Sets the target exposure time in microseconds
inExposureTimeAuto Bool True if using automatic exposure time
inGain Real* 0.0 - Sets gain in dB
inGainAuto Bool True if using automatic gain
outImage Image Captured frame
outFrameID Integer? Captured frame ID

Remarks

Camera driver software

This filter is intended to cooperate with camera using its vendor Hikvision SDK. To be able to connect to camera it is required to install Hikvision Machine Vision Software with camera dedicated drivers. Currently Adaptive Vision Studio uses Hikvision SDK version 3.2.0 (DLL version 3.2.0.3).

Hikvision SDK can be downloaded from the following website: http://en.hikrobotics.com/service/soft.htm?type=1

Setting bandwidth for GigEVision cameras

Bandwidth of Hikvision GigEVision cameras needs to be configured before use, otherwise packet loss and image artifacts may occur.

Open MVS software from Hikvision and connect to the camera. Open Settings / Options menu and go to Network tab. Bandwidth Control slider will be shown. To preserve new value of bandwidth after disconnecting power from the camera, you will need to save it using User Set Control parameters in Features tab.

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.

Filter Group

This filter is member of Hikvision_GrabImage filter group.

See Also