1.7. VRMagic

Summary:

VRMagic Camera / Framegrabber

Type:

DataIO

License:

licensed under LGPL

Platforms:

Windows, (Linux possible but not implemented yet)

Devices:

USB Cameras from company VRMagic (tested with framegrabber VRmAVC-2)

Author:

M. Gronle, C. Lingel, ITO, University Stuttgart

1.7.1. Overview

Plugin for cameras / framgrabbers from VRMagic that run with the VRMagic API. Currently, only monochrome cameras with 8, 10 or 16 bit depth are supported. This plugin has been tested using the VRmAVC-2 grabber under Windows.

1.7.2. Initialization

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

  • device_num: int, optional

    Device number.

    Value range: [0, 5], Default: 0

  • portnum_num: int, optional

    Port number of chosen device.

    Value range: [0, 5], Default: 0

1.7.3. Parameters

bpp: {int}

Bit depth of the output data from camera in bpp (can differ from sensor bit depth).

brightness: {int}

Brightness of camera / framegrabber (0 to 255)

contrast: {int}

Contrast of camera / framegrabber (0 to 255)

format: {str}, read-only

Format of the image. See documentation of SDK for explanation.

group_ID: {int}, read-only

Group ID of device (gid).

hue: {int}

Hue of camera / framegrabber (0 to 255)

name: {str}, read-only

name of the camera

product_ID: {int}, read-only

Product ID of device (pid).

saturation: {int}

Saturation of camera / framegrabber (0 to 255)

serial_number: {str}, read-only

Serial number of device.

signal_source: {str}

Signal source of the grabber [svideo, composite, yc].

sizex: {int}, read-only

Width of ROI (number of columns).

sizey: {int}, read-only

Height of ROI (number of rows).

vendor_ID: {int}, read-only

Vendor ID of device (vid).

1.7.4. Installation

Install the VRmagic SDK, named VRmUsbCam DevKit (https://www.vrmagic.com/de/imaging/downloads/). For compiling the plugin set the CMake variable VRMagic_INCLUDE_DIR to the directory that contains the header files of the SDK.

Note

Under Windows this is often found under /Program Files (x86)/Common Files/VRmagic/VRmUsbCamSDK/include!

1.7.5. Changelog

  • itom setup 2.1.0: This plugin has been compiled using the VRmagic SDK 4.5.0

  • itom setup 2.2.0: This plugin has been compiled using the VRmagic SDK 4.5.0

  • itom setup 3.0.0: This plugin has been compiled using the VRmagic SDK 4.5.0

  • itom setup 3.1.0: This plugin has been compiled using the VRmagic SDK 4.5.0

  • itom setup 3.2.1: This plugin has been compiled using the VRmagic SDK 4.5.0

  • itom setup 4.0.0: This plugin has been compiled using the VRmagic SDK 4.5.0

  • itom setup 4.1.0: This plugin has been compiled using the VRmagic SDK 4.5.0