Viz Engine Administrator Guide

Version 3.13 | Published March 28, 2019 ©

Matrox

In the Matrox section, assign Matrox Input and Output channels to Viz Engine Input and Output channels. The GUI shows a drop down menu for the configurable parameters. The parameters available are dependent on the installed hardware.

This page provides information about the following:

General Properties

The General Properties Panel shows information about the installed hardware.

images/download/attachments/50616052/cfg_matrox_general.jpg

  • Serial No.: Shows the serial number of the installed Matrox board.

  • Board Info: Shows the model and type of the Matrox board.

  • DSX Info: Shows the software version and driver version.

  • Fast Texture Mode: Activate to shorten the ’in out’ delay in Texture Mode to a minimum.

    Note: If Fast Texture Mode is set to Active, DVE does not work (see Video Clip Playout Considerations and Video Playout in the Viz Artist User Guide).


  • CC Extraction: Enables or disables the closed captioning extraction for Matrox X.mio 3 / DSX LE 4 and X.mio2+.

  • Print Clip Info: Enables printing of clip information to the console when activated. However, such information may cause the render loop to stall. Default mode is Inactive.

  • Watchdog: Sets a timer that allows a system to continue video pass-through during an application crash or system failure (see also Matrox Watchdog Configuration (Matrox X.mio Series) and Video Board):

    • Use Watchdog: When set to Active enables the Matrox X.mio watchdog feature. It passes the input signal to a hardcoded output port as soon as Viz Engine is unresponsive. Default mode is Inactive.

    • Timeout: Sets the time, in milliseconds, until the watchdog takes over control. This value should not be smaller than the time of two fields/frames. Default value is 999 ms.

      Note: Use Watchdog and Timeout can also be set and changed in Video Board.

  • Genlock:

    • Use Flywheel: Adopts a tracking mode if the genlock signal is interrupted or lost that maintains the signal frequency until the source genlock signal is regained when activated. Default mode is Active.

    • Max Recovery Time: Represents the time in milliseconds (ms) provided to the flywheel to attempt to regain the genlock before an abrupt jump to the locked state is performed. Default value is 15.

    • Max Unclock Time: Represents the time in milliseconds (ms) provided to the flywheel to remain in the unlocked state before switching to the free running state. Default value is 15.

VideoOut Properties

In the VideoOut panel, you select which Viz Artist/Engine Output is mapped to the selected Matrox output. The VideoOut panel shows the mapped Viz output channel and its editable parameters. When your video input is set to UHD in the Video Input section of the config menu (see Video Input), Matrox channels B, C and D are disabled.

images/download/attachments/50616052/cfg_matrox_videoout2-6.jpg

Map to Viz Channel

  • Map to VizChannel: Selects which video out channel is mapped to the selected Matrox video out channel. Select an Output channel from the drop-down menu. Only channels not already in use are shown. On single channel configurations, VideoOut Ais usually mapped to Program, and VideoOut Bto Preview. On dual Channel configurations, the first channel maps VideoOut Ato Program, and the second maps VideoOut Bto Program.

    • Unused: Does not map this Matrox channel for output.

    • Program: Maps the Program output to the selected video output of the Matrox card.

    • Preview: Maps the Preview output to the selected video output of the Matrox card.

    • Clean: Outputs video without overlay graphics. Clean mode enables and activates a second output feed. This feed consists of DVE video content without any graphics and video textures: only live video, clip video, IP input, streaming input. This stream also includes a separate audio mix corresponding to the video only, excluding stage audio such as audio clips, plug-in audio or text-to-speech, from the clean feed audio mix. If Watchdog functionality is required, VideoOut A must be mapped to Clean, and VideoOut B to Program. Requires Matrox X.mio3, X.mio3 IP, or DSX LE4.

      Note: A clean feed increases the video In->Out delay by one frame!

Fill Properties

  • Allow Super Black: Determines whether to clip an output video signal that is under 7.5 IRE units. Default mode is Inactive.

  • Allow Super White: Determines whether to clip an output video signal that is over 100 IRE units. Default mode is Inactive. The colorimetry tables for SD (ITUR-BT 601) and HD (ITUR-BT 709) define a color conversion from YUV with the range of 16-235 to RGB with the range of 0-255. Values above 235 are Super White and values below 16 are Super Black. As Super White and Super Black pixels are outside the range of 1-byte RGB, these pixels are clamped to the normal 16-235 YUV range when used in a texture.

  • Allow Chroma Clipping: Determines whether to clip over-saturated chroma levels in the active portion of the output video signal. Default mode is Inactive.

  • Digital Edge Sharpening Filter: Applies an edge sharpening filter to digital output video. Default mode is Inactive. SD configurations only.

Key Properties

  • Watchdog Key Opaque: Specifies if the output key must be opaque or transparent when the watchdog unit activates. Default mode is Inactive.

  • Allow Super Black: Determines whether to clip an output video signal that is under 7.5 IRE units. Default mode is Inactive.

  • Allow Super White: Determines whether to clip an output video signal that is over 100 IRE units. Default mode is Inactive.

    Note: Please see the description about allowing Super White and Super Black in the Fill Properties section above.

  • Allow Chroma Clipping: Determines whether to clip over-saturated chroma levels in the active portion of the output video signal. Default mode is Inactive.

  • Apply Offset: Applies an offset to the luminance values such that the inverted result still falls within the 16-235 range. Default mode is Inactive.

  • Downscale Luma: Compresses the luminance range of the output key signal from 0-255 to 16-235. Default mode is Active.

  • Invert Luma: Inverts the luminance part of the output key signal (inverts the key). Default mode is Inactive.

Manager, Repeat and 3G Properties

  • Manager Size (frames): Sets the number of frames available in the on-board memory for output. A too high value may cause memory problems on the Matrox board. Default value is 3.

  • Repeat Mode: Defines the way the output should be repeated if Viz Engine is stalled and does not update the output. Default mode is Field. Available modes are:

    • None: Does not repeat. Output goes black.

    • Field: Repeats the last played field.

    • Frame: Repeats the last played frame.

  • 3G Level B: Activates Level B for 3G mode in 1080p 50/60/60M (default mode is Level A).

VBI Properties

Use this switch to enable or disable VBI (Vertical Blanking Interval) in the output.

VideoIn Properties

The VideoIn tab shows the mapped Viz Engine channel together with modifiable input channel settings.

images/download/attachments/50616052/cfg_matrox_videoin.jpg

Map to Viz Channel

  • Set which video in channel is mapped onto this Matrox video in channel. The drop-down gives a choice between the available channels. Only the channels not already taken are shown.

    • Unused: Do not use this Matrox channel for video input

    • Video <1 to 8>: Captured input is available in Video1.

      Note: On a single channel configuration VideoIn A is usually mapped to Video1 and VideoIn B to Video2 and so on whereas for a Dual Channel configuration usually the first channel maps VideoIn A to Video1 and the second channel maps VideoIn B to Video1. In this case both the first and the second channel have one video input configured, namely Video1.

      Note: Input nodes can be shared among multiple engines instances for versions 3.12 and later.

Allow Properties

images/download/attachments/50616052/configuringviz_config_matrox_videoin_noname_r.png

  • Allow Super Black: Determines whether to clip an input video signal that is under 7.5 IRE units. Default mode is Active.

  • Allow Super White: Determines whether to clip an input video signal that is over 100 IRE units. Default mode is Active.

  • Allow Chroma Clipping: Determines whether to clip over-saturated chroma levels in the active portion of the input video signal. Default mode is Inactive.

Key Properties

images/download/attachments/50616052/configuringviz_config_matrox_videoin_key_r.png

  • Contains Alpha: Enables/Disables use of alpha component.

    Note: This switch is only enabled on input channels where capture with alpha is supported.

  • Key Apply Offset: Applies an offset to the luminance values so that the inverted result still falls within the 16-235 range.

  • Key Upscale Luma: Expands the luminance range of the input key signal from 16-235 to 0-255.

  • Key Invert Luma: Inverts the luminance part of the key signal (inverts the key).

  • Shaped: Enables/Disables capture in shaped format.

Video Properties

images/download/attachments/50616052/configuringviz_config_matrox_videoin_video_r.png

  • Manager Size: Sets the number of frames available in the on-board memory for capturing. This value is influenced by the input delays specified in the parameters below and is automatically adjusted if it is too low. A too high value may cause memory problems on the Matrox board. Default value is 6.

  • Streaming Size: Not in use.

  • Texturemanager Size: Defines the size of the texture buffer in frames. Default value is 8.

  • Video Delay DVE: Sets the number of frames the live input should be delayed before it can be used as a DVE layer. Default value is 0 (Off).

  • Video Delay Texture: Sets the number of frames the live input should be delayed before it can be used as a texture in the scene (default value is 4, also the minimum value. The maximum value is 50).

    Note: Viz Enigne ships with preconfigured profiles for a minimum AV delay for all Matrox boards and all major resolutions. Please be sure to apply these settings. Usually, there is no need to tweak the delay settings except special situations like frame accuracy settings etc..

  • RP188 Enable: Enables capturing of SMPTE RP 188 extra information such as LTC and VITC. Default is Inactive.

  • Repeat Mode: Determines the behavior of the video input in case of capture drops. Options are:

    • None: Does not repeat. Input goes black.

    • Field: Repeats the last field.

    • Frame: Repeats the last frame.

  • 3G Level B: Activates Level B for 3G mode in 1080p 50/60/60M (default mode is Level A).

VBI Properties

images/download/attachments/50616052/configuringviz_config_matrox_videoin_vbi_r.png

  • Enable: Enables VBI for this channel when set to Active. Default is Inactive.

    Note: This setting c an only be activated if input and output resolution match.

  • Start Line: Defines at which line on the input the VBI section starts. Default value is 0 (Off). The minimum VBI values are (as for VideoOut):

    • NTSC: 7

    • PAL: 6

    • 720p: 7

    • 1080i: 6

  • Delay DVE: Sets the number of frames the VBI should be delayed before the clip can be used in DVE mode. Default is 0 (Off).

  • Delay Texture: Sets the number of frames the VBI should be delayed before the clip can be used in texture mode. Default is 0 (Off).

Audio Properties

images/download/attachments/50616052/configuringviz_config_matrox_videoin_audio_r.png

  • Audio: Enables audio capturing on this channel when set to Active. Default mode is Active.

  • Channels: Sets the number of audio channels to capture (see also Audio in Viz). Default number of channels are 2. Available channel options for AES on X.mio are: None, 1, 2, and 4. For AES on X.mio2/X.mio2 Plus and for Embedded the channel options are: None, 1, 2, 4, 8, and 16.

  • Delay DVE: Sets the number of frames the audio should be delayed in DVE mode before it can be mixed to the output. Default value is 4.

  • Delay Texture: Sets the number of frames the audio should be delayed in texture mode before it can be mixed to the output. Default value is 4.

M264 Encoder/Decoder Boards

M264 encoder/decoder boards are usually configured automatically. If they do not appear in the configuration section, please double check the Matrox.Devices entry in the MATROX_CONFIG of the viz.cfg file.

It should look like Matrox.Devices = <device1>,<device2>.

Depending on your model, e.g. a M264 S3, which supports three streams, the entry would look like: Matrox.Devices = <device1>,<m264device>,<m264device>,<m264device>.