Documentation Center

Viz Trio User Guide

Version 4.0 | Published September 25, 2023 ©

Graphics Preview

This section covers the following topics:

Real-time Rendering of Graphics and Video

images/download/attachments/85885561/image2022-4-23_8-31-14.png
The local Preview window displays a representation of the graphics and video.

  • The defined title and safe area and bounding boxes are displayed. Bounding boxes are related to the graphics scene’s editable elements (see Tab Fields Window).

  • Timeline for scrubbing full screen video preview.

  • Control interactive scenes by clicking the scene inside the local preview window. You can then adjust an offside line in Trio’s local preview by reading a template referencing an interactive scene, for example.

Floating or Moving the Preview Window

Use the Floating preview button at the upper right corner of the preview window pane to un-dock the preview window.

  • If the preview window is docked (attached) to the Trio main window, clicking the pin-button will detach the Preview window.

  • If the preview-window is un-docked from the main Trio window, clicking the pin-button will dock the preview window to the main Trio window.

Graphics Control Buttons

At the top of the preview window:

images/download/thumbnails/85885561/image2022-4-23_8-33-6.png

  • Play: Starts the scene animation currently loaded in the local preview.

  • Continue: Continues the scene animation currently loaded if it contains stop points.

  • Stop: Stops the scene animation.

  • Time Slider: Lets you scrub the timeline by holding in and moving your cursor in the value field. The cursor changes to an arrow to indicate that the time value can be changed.

The middle section of the toolbar:

images/download/thumbnails/85885561/image2022-4-23_8-34-33.png

  • Show or hide the Title Area in the Preview window.

  • Show or hide the Safe Area in the Preview window.

  • Show or hide the Bounding Box for the tab field currently selected in the Preview window.

Preview Modes RGB, Key and RGB with Background Image

images/download/attachments/85885561/image2022-4-23_8-35-54.png
The three buttons can be used to see the previewed graphics in three different modes.

  • The left button displays the graphics in an RGB mode with a default background color (black).

  • The middle button displays the graphics in Key mode, showing how the key signal looks like.

  • The right button displays an RGB preview with a background image, illustrating how the graphics appear on top of a video.

The respective preview modes are shown below:
images/download/attachments/85885561/image2022-4-23_8-42-30.png

To set a preview background image, go to File > Show Properties > Preview background image and select an image.

Connection Status

images/download/attachments/85885561/userinterface_viz_connection_status.png
The Connection status of the local Viz renderer is shown in the upper right corner of the Preview window. Click the arrow to display a context menu.

images/download/attachments/85885561/image2022-4-23_8-46-54.png
These functions are mainly for testing and debugging purposes. The context menu can show these menu items:

  • Show Commands: Opens the command shell for the local Viz Engine renderer.

  • Show Status: Shows a status box for the local Viz Engine renderer.

  • Restart Viz: Restarts the local Viz Engine running on the same computer as the Trio client. This menu item is only active for local preview.

  • Reconnect Viz: Allows Trio to reconnect to a local preview engine after an engine running the local preview has been shut down. This option is visible regardless of whether an external preview is running.

  • Reconnects to the external Viz Engine: Only the local Trio client reconnects to the remote Viz Engine.

    If Trio has been started with an external Viz Previewer (and only then), the following menu choice appears in the context menu:

  • Set OnAir: Sets the external Viz Engine in OnAir Mode, so for example, Viz Artist's Design Mode exists and functions as a renderer engine.

    Note: In this context, External Viz Previewer should not be confused with External Viz Preview settings in the profile. An External Viz Previewer is another way of making an external Viz Engine act as a local Viz preview. You can configure the previewer using the Viz Trio startup parameter -vizpreview your-vizpreview-hostname-here.

OnPreview Script for a Graphical Element

This feature supports triggering an OnPreview event in a script for a scene. The event is only triggered for the local preview in Trio.

OnPreview scripts can be created using a whole scene or a container.

Creating a Scene Script:

  1. Open a scene in Viz Artist.

  2. Go to Scene Settings > Script and select Edit (if it is not already showing in the script editor).

  3. Enter a script in order to write a unique ID for the scene, so that it can later be identified in the console output:

    sub OnPreview(doPreview as Integer) PrintIn “OnPreview in test1 scene script: ” & doPreview end sub

  4. Press Compile & Run below the script editor.

  5. Save the scene.

Creating a Container Script

  1. Add a group container to the root of the scene.

  2. Go to Built Ins > Container Plugins and select the Global folder.

  3. Drag the Script plugin onto the container/group. A script editor opens.

  4. Enter a script that writes a unique id for the scene that can be identified in the console output later.

    sub OnPreview(doPreview as Integer) printIn “OnPreview in test1 container script: ” & doPreview end sub

  5. Press Compile & Run.

  6. Save the scene.

Follow the steps below in Viz Trio and open the local preview command window to check that the OnPreview event is triggered:

  1. Import a scene (Transition Logic scenes, Combo Templates, Concept/Variant scenes, TrioScroll scenes, Stillstore image scene etc.) with an onPreview script into Trio. See how to make an OnPreview script above.

  2. Open the local preview Viz engine console output window from Connect > Show Command.

  3. Read the imported template and do a page take.

    The page editor is used for editing pages. Depending on the template or page edited, page editor can display a wide range of specialized editors. Pages are edited using a wide range of editors: for example text, database and scroll editors. When pages have editable elements, it is possible to jump from element to element by pressing the Tab key. It is also possible to select elements by clicking them in the local preview window. The page editor is located in the upper right corner of the UI and is shown by default when starting Viz Trio.

  4. Save the page.

  5. Read the page by double-clicking it or issuing a Trio command. The local Viz engine console then triggers an OnPreview script event.