1.26. Vistek

Summary:

SVS Vistek GigE grabber.

Type:

DataIO

License:

licensed under LGPL, the necessary Vistek drivers, header files and libraries have their own license.

Platforms:

Windows

Devices:

Cameras from company Vistek

Author:

H. Gilbergs, ITO, University Stuttgart

1.26.1. Overview

itom plugin for GigE cameras from SVS Vistek. Every camera is simply initialized by the serial number of the connected SVS Vistek camera. (see camera housing).

Some files of the SVGigE SDK are shipped within this plugin (currently 1.5.2). Please check the SVS Vistek website for newer versions of the SDK and replace the files if desired. Additionally, it is stated that SVS Vistek does not provide any support for this specific plugin wrapping the official SDK of SVS Vistek.

This plugin requires the necessary libraries from the SVS Vistek SDK (SVGigE.dll, SVGigETLFilter.dll, SVGigETLWinsock.dll or 64bit versions). Please check the right version and make these libraries available for itom (PATH environment variable, system directory…).

For a robust data communication please install the SVGigE FilterDriver and enable Jumbo frames at your network adapter.

Please notice: Currently, this plugin only works for Vistek drivers up to version 1.5.2. If you want to use a 2.x series of the Vistek drivers, use the GenICam plugin of itom that is able to communicate with Vistek USB3 and GigE cameras.

1.26.2. Initialization

The following parameters are mandatory or optional for initializing an instance of this plugin:

  • CameraSerialNo: str, optional

    Serial Number of the SVS Vistek camera (see camera housing)

    RegExp: “^[0-9]*$”, Default: <empty str>

  • streamingPacketSize: int, optional

    used streaming packet size (-1: use maximal available packet size, else value in bytes). Try to enable jumbo-frames at your network adapter in order to realize higher packet sizes

    Value range: [-1, 16000], Default: -1

  • streamingBuffers: int, optional

    number of streaming buffers. Increase if you get data losses, decrease if you want to consume less memory

    Value range: [1, 300], Default: 3

1.26.3. Parameters

An instance of this plugin has the following internal parameters:

name: {str}, read-only

Vistek

cameraModel: {str}, read-only

Camera Model ID

cameraManufacturer: {str}, read-only

Camera manufacturer

cameraVersion: {str}, read-only

Camera firmware version

cameraSerialNo: {str}, read-only

Serial number of the camera (see camera housing)

cameraIP: {str}, read-only

IP adress of the camera

camnum: {int}

Camera Number

exposure: {float}

Exposure time in [s] (deprecated: use integration_time instead; this is an alias for integration_time only)

integration_time: {float}

Exposure time in [s]

gain: {float}

Gain [0..18 dB]

offset: {float}

Offset [0.0..1.0]

binning: {int}

Binning mode (OFF = 0 [default], HORIZONTAL = 1, VERTICAL = 2, 2x2 = 3, 3x3 = 4, 4x4 = 5). In order to be compatible with the default binning definition of itom plugins, the following values can be set, too: OFF = 0, HORIZONTAL = 102, VERTICAL = 201, 2x2=202, 3x3 = 303, 4x4 = 404. getParam returns the values 0-5.

sizex: {int}, read-only

Width of current camera frame

sizey: {int}, read-only

Height of current camera frame

bpp: {int}

bit-depth for camera buffer

timestamp: {float}, read-only

Time in ms since last image (end of exposure)

streamingPacketSize: {int}, read-only

Used streaming packet size (in bytes, more than 1500 usually only possible if you enable jumbo-frames at your network adapter)

logLevel: {int}

Log level. The logfile is Vistek_SVGigE.log in the current directory. 0 - logging off (default), 1 - CRITICAL errors that prevent from further operation, 2 - ERRORs that prevent from proper functioning, 3 - WARNINGs which usually do not affect proper work, 4 - INFO for listing camera communication (default), 5 - DIAGNOSTICS for investigating image callbacks, 6 - DEBUG for receiving multiple parameters for image callbacks, 7 - DETAIL for receiving multiple signals for each image callback

Please consider, that 12bit images have been delivered in a range between 16 and 65535 with an increment of 16 for Vistek library version <= 1.0.0. From version 1.1.0, this range has been adapted to the default range [0,4096).

1.26.4. Disclaimer

The company Vistek is not responsible for this plugin and therefore does not provide any support.

1.26.5. Changelog

  • itom setup 1.2.0: This plugin has been compiled using the SVCam GigE SDK 1.4.24.59

  • itom setup 1.3.0: This plugin has been compiled using the SVCam GigE SDK 1.4.24.59

  • itom setup 1.4.0: This plugin has been compiled using the SVCam GigE SDK 1.4.24.59

  • itom setup 2.0.0: This plugin has been compiled using the SVCam GigE SDK 1.4.24.59

  • itom setup 2.1.0: This plugin has been compiled using the SVCam GigE SDK 1.4.24.59

  • itom setup 2.2.0: This plugin has been compiled using the SVCam GigE SDK 1.4.24.59

  • itom setup 3.0.0: This plugin has been compiled using the SVCam GigE SDK 1.5.2.251

  • itom setup 3.1.0: This plugin has been compiled using the SVCam GigE SDK 1.5.2.251

  • itom setup 3.2.1: This plugin has been compiled using the SVCam GigE SDK 1.5.2.251

  • itom setup 4.0.0: This plugin has been compiled using the SVCam GigE SDK 1.5.2.251

  • itom setup 4.1.0: This plugin has been compiled using the SVCam GigE SDK 1.5.2.251