Magewell documentation

magewellpro is a Windows only IO plugin for Vahana VR. It allows Vahana VR to capture audio/video input from the Magewell Pro Capture cards.

It has been developed and tested with the Pro Capture Quad SDI.

Set-up

Drivers can be found at this address : http://www.magewell.com/download?lang=en. Please follow the documents to set up the card and the drivers.

Configuration

The magewell plugin can be used by Vahana VR through a .vah project file. Please see the *.vah file format specification for additional details.

Define an input for each input on the capture cards. The reader_config member specifies how to read it.

Example

"inputs" : [
{
  "width" : 1920,
  "height" : 1080,
  ...
  "reader_config" : {
      "type" : "magewellpro",
      "name" : "0",
      "pixel_format" : "RGB",
      "interleaved" : false,
      "frame_rate" : {
        "num" : 30,
        "den" : 1
      },
      "audio" : false,
      "audio_channels" : 0,
      "audio_sample_rate" : 0,
      "audio_sample_depth" : 0,
      "builtin_zoom" : "none"
    },
  ...
}]

Parameters

Member	Type	Default value
type	string	magewellpro	Required. Defines a Magewell input.
name	string	-	Required. The device's number (starting from 0).
interleaved	bool	false	If the input is interlaced.
pixel_format	string	-	Required. The input pixel format. Supported values are UYVY, YUY2, RGBA, and RGB.
builtin_zoom	string	-	Required. Defines the zoom behaviour. Available values are: zoom, fill or none.
frame_rate	struct	-	Required. The input framerate.
audio	bool	-	Required. Does this reader capture audio.

Note that the audio format is fixed to a 48 kHz sample rate, with double-channels and 16-bit sample.