Back to Adaptive Vision Studio website

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

Hikvision_GrabImage


Module: ThirdParty

Captures an image from a Hikvision device.

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