Viz Artist User Guide

Version 5.0 | Published December 20, 2022 ©

Video Clips

This section details where video clips are stored, the transfer and download from Viz One and video clip playback.

This section contains the following topics:

Video Clip Storage

This section details where video clip can be stored and accessed for use in Viz Artist.

Hard Drive Video Clips

Videoclips should be placed on a fast SSD drive. Machines assembled by Vizrt are usually equipped with a D:\ drive.

IMPORTANT! It is not recommended to store video clips on the C:\ drive, as this is where the operating system is installed.

A second or third video clip directory can be added in Local Settings of Viz Configuration (see the Viz Engine Administrator Guide), which can be used for:

  • A Dual Channel and Trio One Box Configuration, or

  • With any Viz Artist/Viz Engine configuration for the selection of a secondary video clip directory if a directory fails. If the file path for a video clip is set to <clip_root>, and the first directory falls over the same video file is searched for and used, from the next directory in the Clip directory list. If, when multiple Clip directories are selected, the Clip Name box is used to search for a video, the search defaults to the last used directory.

Viz One Video Clips

Video clips can also be transferred and downloaded from a Viz One. To do this Viz One must be integrated with a Viz Engine. See the Viz One page in the Configuring Viz section of the Viz Engine Administrator Guide and the Viz One Deployment Guide.

Video Items

Video clips are also stored in the Graphic Hub (see Working with Items). These are only used in combination with the After Effects import feature.

Dual Channel and Trio One Box Configuration

When more than one directory path is selected, for example, D:\AEClips; D:\DecoClips, etc., in the Clip Name box change the file path to <clip_root>. The file name is then searched for, in the selected directories (selected in the Viz Configuration), one after the other, for stored video clips with the same name.

Example: Search for a video clip named next_tuesday.avi in D:\AEClips\AFL\Promos. In the Clip Name box change D:\AEClips\AFL\Promos to <clip_root>. The filename shown in Viz Artist should be <clip_root>\next_tuesday.avi.

Variables Used in File-name Expansion

Variable

Definition

<base_scene_name>

Expands to the scene name.

<absolute_scene_name>

Expands to the complete path of the loaded scene.

<absolute_scene2_name>

Expands to the complete path of the second loaded scene.

<clip_root>

Expands to the clip_root.

<hostname>

Expands to the hostname.

<if0>

Expands to the IPV4 network address of the first network interface.

<if1>

Expands to the IPV4 network address of the second network interface.

<if2>

Expands to the IPV4 network address of the third network interface.

Matrox Clip Player information

Playback of Clips with VBI

VBI (Vertical blanking interval) is the interval of time between the last line of a given field/frame and the beginning of the next field/frame, during which the incoming data stream is not shown on a monitor.

Video clips which contain VBI information, can be played back in two ways:

  • One: Use a video clip which contains the embedded VBI information.

  • Two: Use a separate video clip which contains the VBI data. This separate video clip must be named [clipname]_vbi.avi and conform to the size limitations detailed in the procedure below.

To Playback Clips with VBI in a Separate File

Note: The links in this procedure all refer to the Viz Engine Administrator Guide.

  1. Make sure that VBI is set to On for both the Clip Channel (Video Input: Clip Input) and the Video Output (Matrox).

  2. For each clip channel, make sure that the Video Input and Output Format resolutions are the same.
    The VBI clip contains only VBI information. The size of the clip must match the maximal total lines for VBI in this resolution:

    • NTSC: 32

    • PAL: 34

    • 720p: 19

    • 1080i: 30

    • 1080p: 35

Using VBI embedded in a full size clip is not supported as separate clip. This is only supported when played as the main clip.

VML Clip Player information

The VML player is a replacement of the Directshow Clip Player. It is meant for all systems that require clip playback without the need for a Matrox Videoboard. This can be the preview of videoclips on a Trio Installation or the playback of decoration clips (formerly handled by Softclip plug-in). VML player does not require the additional installation of various codecs like Softclip or Directshow Player.

To Use the VML Clip Player

The VML player is automatically being used if no Matrox board is present. Therefore the VML player is active on all systems without a Matrox board. To force a Clip player to use VML (or Matrox), you can specify the player in the Viz Engine configuration file:

Section CHANNELS_CONFIG
ClipIn{n}.Player = 1

For more information, see Software Configuration > VML player in the Viz Engine Administrator Guide.

Important: The player mode is not switched back to Matrox once it is configured as VML player.

VML player only allows playback speed of -1, 0 and 1.

Video Clip Playback

Video clip playback should be used sparingly. The size and formats of some video clips can affect performance of the Viz Engine Renderer. Beside the Matrox Clip player and the new introduced VML player, plug-ins like MoViz, Softclip, VLC can be used. However, we recommend to use either Matrox or VML as all other plug-in related clip players depend on system extensions like Directshow or VfW which are already deprecated.

Video Clip Playback General Guidelines and Considerations

For video clip playback methods, consider these general guidelines:

Use-case

Playback Method

If no 3D effects or animation control, and only limited 2D effects, are needed on the clips.

To Play a Video Clip as DVE.

For full screen (for example, background) clips.

To Play a Video Clip as DVE.

If video must be mapped onto a texture in the scene or requires minor adjustments.

Video Clip Animation in the Stage.

For non-standard image format/resolution/codec.

Use VML player.

IMPORTANT! Always test the performance of the different solutions and work with the solution that gives the best quality versus performance ratio. A performance test should always take place on a machine with the same specifications as those used for production playback.

  • The selected video clip must have the same frame rate as the clip channel. You can mix different Output Formats and Video Input Formats with different resolutions, but you must make sure to use either progressive or interlaced for Input and Output. You can play, for example, a 720p clip with an Output format of 1080p, but you cannot mix and 720p with a 1080i format:

    • Video Input: Clip Channel 1: HD 1080i

    • Output Format: 1080i

      images/download/attachments/85891247/image2020-4-10_13-49-36.png

      Each available Clip Channel can be configured for independent resolutions, providing the designer quick access to a range of options. These settings are configured in the Video Input section in Viz Config. Please refer to the Video Input page in the Configuring Viz section of the Viz Engine Administrator Guide.

      Tip: The Media Asset Manager provides a useful tool-tip when hovering the mouse pointer over Clip Channel media assets, displaying the resolution configured for the Clip Channel in use.

  • Make sure that the correct container and codec is selected (see Supported Codecs).

  • Video clip playback can be applied through either DVE or Texture.

  • To be able to use a Live input channel, a Clip channel or a Stream channel, they first have to be set to active in Video Input (see the Configuring Viz section of the Viz Engine Administrator Guide).

  • If alpha is required for a video clip, click Config and configure the alpha in Video Input (see the Configuring Viz section of the Viz Engine Administrator Guide ). Enable w/Alpha when alpha is required in video clips. Either two clips, or one clip that contains both the fill and key, are required. If there is only one clip, that contains the fill (without a key), the key is created dynamically and is fully opaque. For the naming convention of two clips, the alpha/key clip must have the same name with an attached _key before the file extension, this means if the main/fill clip is named example.mxf, the alpha/key clip must be named as follows: example_key.mxf.

  • The Matrox Clip Player supports TDIR (Time Delay Instant Replay), which enables Viz Engine to play back clips while they are still being written by Viz One. When a clip is played, with TDIR support enabled, looping is not enabled for this clip. Viz Engine determines automatically if it needs to set TDIR support on, or if the clip is already fully loaded.

  • BG Graphics are always the lowest in the stack, even below zero, and FG graphics are assigned a default of 100. Please note that priority can not be assigned to BG Graphics.

To Play a Video Clip as Texture

  1. Click on Built Ins.

  2. Click on Media Assets (MA).

  3. Right-click on a Clip Channel, and select Add Clip<1> as Texture.

    • The Texture button in the Scene Tree panel (Media Asset Manager) is automatically selected.

    • The selected Clip Channel is added to the Scene Tree and a new Container is created (click Tree to view).
      images/download/attachments/85891247/image2021-8-9_17-5-47.png

      Tip: The Clip<1> Channel can be made active or inactive. Toggle the active/inactive button.

      Tip: The Clip<1> Channel can also be dragged to the Scene Tree, where it is added as a Texture in a new Container. In Viz Engine, a Quad geometry with a Phong material is created.

  4. Click on Clip<1> Channel, in the Scene Tree panel (Media Asset Manager) Texture view, to open its properties panel.
    images/download/attachments/85891247/image2022-7-14_15-40-23.png

  5. Select the required Keying Mode (see Keying Mode).

  6. Add a video clip:

    • In the Clip Name line, click on the Browse Button, or

    • Drag a Video Clip item from the Server Panel, or

    • Click Viz One..., and select a video clip to import

      Note: To transfer and download videos from Viz One, Viz One must be integrated and configured with Viz Artist/Viz Engine.

  7. Configure the video clip playback as required.

  8. Click Play images/download/attachments/50615461/ma_play_ico.png to test the video clip.

To Play a Video Clip as DVE (Matrox)

  1. Click on Built Ins.

  2. Click on Media Assets (MA).

  3. Right-click on the required Clip Channel.

    images/download/attachments/85891247/image2021-8-9_17-6-22.png
  4. Select Add Clip<1> as DVE.

    • The DVE button in the Scene Tree panel (Media Asset Manager) is automatically selected.

      Tip: The Clip<1> Channel can be made active or inactive. Toggle the active/ inactive button.

      The Scene Editor shows a blue rectangle, which shows that the live input channel is correctly configured for live video.
      images/download/attachments/50615461/ma_cdve_blue.png

  5. Click on the Clip<1> Channel to open its properties panel.

  6. Adjust the parameters in the DVE control panel, as required.

  7. Add a video clip:

    • In the Clip Name line, browser for a File or

    • Drag a Video Clip item from the Asset View or

    • Click Viz One..., and select a video clip to import

      Note: To transfer and download videos from Viz One, Viz One must be integrated and configured with Viz Artist/Viz Engine.

  8. Configure the video clip playback as required.

  9. Click Play images/download/attachments/50615461/ma_play_ico.png to test the video clip.

Browsing for Clips always shows the default Clip Root location. If you need to access other locations, you can create an alias inside the file browser dialog. To do so, drag an folder from the right side into the locations area on the left side:
images/download/attachments/85891247/image2021-6-17_9-15-17.png

Video Clip Animation in the Stage

Video can also be played out as part of an animation. This is useful when video clips are required to interact with animation.

To Animate a Video Clip

  1. Before a video clip can be animated, it must first be applied as a Texture or DVE.

  2. Click Stage.

  3. Click the New Director button.

  4. Right-click on the Director.

  5. Select Clip > Clip1 > Clip
    images/download/attachments/85891247/image2022-9-21_10-0-28.png

  6. In the Clip1 channel, click in the dark blue area. The Clip Key Frame Editor opens on the far right.

  7. Add a video clip:

    images/download/attachments/85891247/image2022-9-21_10-1-58.png


    To load a clip,

    • Click images/download/thumbnails/85891247/image2022-9-21_10-3-29.png to browse for a local clip, or drag a Video Clip item from the Asset View.

    • Click Viz One..., and select a video clip to import.

    • Click Lock Clip Length to specify a certain time/length for your clip. This is useful when loading clips from an external control application via Viz One. In this case, the lock clip length acts as a placeholder, but does not change the clip length automatically after loading.

  8. Configure the Clip Key Frame Editor as required.

To Play a Single Clip in the Stage with Stage Loop

  1. Set a clip in the stage as described in To Animate a Video Clip.

  2. Click Clip, in the Stage Tree.

  3. Set the clip to loop a specific number of times or infinite.

    images/download/attachments/85891247/image2022-9-21_10-6-12.png

To Play Multiple Clips in One Channel

  1. Add a clip to the stage as described in To Play a Single Clip in the Stage with Stage Loop.

  2. Set the time indicator to a position after the first clip Key Frame.

  3. Click images/download/thumbnails/85891247/image2022-9-21_10-7-24.png to add a Key Frame.

  4. Select a clip for the new Key Frame (see To Animate a Video Clip). Show black rules for pauses between clips:

Black Rules

Frames Shown

Both clips NS

Frame 1 of Clip 2 is shown

Clip 1 AE, Clip 2 NS

Frame 1 of Clip 2 is shown

Clip 1 NS, Clip 2 BS

Last frame of Clip 1 is shown

Clip 1 AE, Clip 2 BS

Black is shown

Key:NS

Nothing is shown

setBS

Shows black before start

setAE

Shows black after end set

If Pending is Active (which is recommended) subsequent clips are loaded into the pending clip player and are swapped at the correct time. This feature enables the clips to concatenate seamlessly. However, when pending support is set to Inactive, black frames are shown until the clip is ready to be played (see the Configuring Viz section of the Viz Engine Administrator Guide).

To Play Multiple Clips in One Channel with Stage Loop

  1. Set multiple clips in the stage as described in To Play Multiple Clips in One Channel.

  2. Set the clips to loop. Click the corresponding entry in the Stage Tree.
    All Key Frames including the pauses in between and before are taken into account during play back, for example, pause - clip 1- pause - clip 2 loops as such.

To Play Single and/or Multiple Clips in Multiple Channels

This is a combination of the use cases described above, with the clips used on several channels.

Video Clip Queue

Video clips can also be queued, providing automatic playback of a series of clips. If no clip is playing at the moment of clip queue creation, playback of the first clip in the queue starts immediately. All other clips are played in the sequence they were added to the list. By default, every clip needs to be played out manually, although it is not required to set their names again. This behavior can be overridden by clicking the Autorun button, setting it to On.

images/download/attachments/85891247/image2022-9-21_10-10-8.png

The current state of the auto-play flag is stored with every queued clip, and can thus be used on demand.

Video Clip Queue Commands

Commands (n is the clip channel):

Command

Description

[...]*CLIPIN*n*NAME CUE name in out

Adds clip with name to the queue, using in and out as trim in and out points.
The parameters in and out are optional and can be omitted.

[...]*CLIPIN*n*QUEUE LIST

Lists all the clips currently queued.

[...]*CLIPIN*n*QUEUE INSERT name in out position

Inserts clip name using in and out at position in the queue.

[...]*CLIPIN*n*QUEUE REPLACE name in out position

Replaces the clip at position with the new one using name, in and out.

[...]*CLIPIN*n*QUEUE DELETE position

Deletes the clip at position in the queue.

[...]*CLIPIN*n*QUEUE MOVE source target

Moves the clip from position source to position target in the queue.

[...]*CLIPIN*n*QUEUE FLUSH

Removes any and all clips from the play-list.

Example Clip Queue Commands

RENDERER*VIDEO*CLIPIN*n*NAME CUE
MAIN_SCENE*VIDEO*CLIPIN*n*NAME CUE


See Also