Viz Artist User Guide

Version 5.2 | Published March 20, 2024 ©

Directors

To create an animation, there must be at least one Director in the Stage Tree. Directors are used to group a certain set of Stage items, such as Actors and Channels. It is possible to create Directors at the root level of the Stage Tree, or as Sub-Directors.

A Director can hold as many items as required, but to improve usability it is recommended to group certain items in different Directors, especially when working with complex animations. In addition to improved overview in the Stage Tree, multiple Directors make it possible to show only the animations contained within each Director. This opens the possibility to, for example, have multiple animation channels on one object, driven by multiple Directors.

Each Director can also hold controlling items such as stop points and actions that only affect the animations within the Director (see Basic Animation Functions).

Note: The first Director created in the Stage is always called Default Director. Any subsequent Directors are called Director (rename as required).

Most actions on Actors are done using Directors. Actions affecting the time-line are performed directly in the Dopesheet Editor. Working with Directors in the Dopesheet editor enables the Director Editor.

This page contains information on the following topics:

Directors in the Stage Tree

Directors are shown in the Stage Tree with a gray blue background color.

images/download/thumbnails/130576963/image-2023-7-17_8-39-41.png

To Create a Director

Note: The first Director created in the Stage is always called Default Director. Any subsequent Directors are called Director (rename as required).

images/download/thumbnails/130576963/image-2023-7-17_8-39-49.png

  • Click the (Add Director) button

    Note: The new Director is added under the currently selected Director. If no Director is selected then its added at the end of the director tree.

    Or

  • Drag the images/download/thumbnails/130576963/image-2023-7-17_8-40-51.png (Add Director) icon to the Stage Tree:
    Directors that are dragged to the Stage Tree can be positioned in various ways, and create either root or Sub-Directors.

To Move a Director

Drag one or more Directors to a different place in the Stage Tree hierarchy

To Copy a Director

Press CTRL and drag one or more Directors to a different place in the Stage Tree hierarchy

To Rename a Director

Note: Special characters, such as space, are not allowed in Director names.

  1. Right-click a Director.

  2. In the context menu, select Rename.

  3. Type a new name.

  4. Press ENTER.
    Or:

  1. Select the required Director in the Stage Tree.

  2. Open the Director Editor.

  3. Type a descriptive name in the Name text box.

  4. Press ENTER.

    images/download/thumbnails/130576963/image-2023-7-17_9-1-24.png images/download/thumbnails/130576963/image-2023-7-17_9-2-53.png

To Delete a Director

  1. Right-click a Director in the Stage Tree.

  2. In the context menu, select Delete Director.
    Or:

  • Drag the Director, or multiple Directors, to the trash can
    Or:

  • Select a Director, or multiple Directors, and press DELETE.

Directors in the Dopesheet Editor

Directors are shown in the Dopesheet Editor with a gray-blue color.

To Move a Director in the Time-line

  • Click on the Director and drag to a different time.

    images/download/attachments/130576963/image-2023-7-17_9-34-30.png

To Speed Up or Slow Down a Director

  • Click on the start or the end of the Director.

  • Drag the start or end point to change the Director speed:

    images/download/attachments/130576963/image-2023-7-17_9-34-44.png

To Stretch a Portion of a Director

If only a part of a director needs to be lengthen or shortened, you can use the rubberband function.

  • Keep the T key pressed click on the Start of your Selection. A green marker appears.

  • Keep T key pressed again and select your end point.

  • Stretch or shrink your selection by using the two green handles.

    images/download/attachments/130576963/image-2023-7-17_9-57-32.png

Events in a Director

Events can be added to a Director to add control to an animation. Events that can be added to the Director are:

  • Stop: Stops the animation until continue animation is clicked. A Stop applies for the Director and all Sub-Directors.

  • Tag: Shows a position along the time-line. This Event type does not stop the animation.

  • Local Stop: Stops the animation until continue animation is clicked. A local stop only applies for the Director it is placed on, not its Sub-Directors.

  • Pause: Stops the animation for a specified amount of frames.

  • Next Scene: Marks a position where a Scene ends. The next Scene starts automatically.

    Note: Viz Weather has an automatic play list option where the user does not need to start the next Scene. The Next Scene tag starts the next Scene automatically when the current Scene reaches the Next Scene Tag.

To Create a New Event

  1. Click on a Director in the Stage Tree.

  2. Set the Time-line Marker to the point where the new Event is to be added.

  3. Add an Event:

    • Click the images/download/thumbnails/130576963/image-2023-7-17_10-2-31.png (Add Stop/Tag) button, or

    • Press S and click in a Director where the new Event is to be added.

      Note: The default new Event is a Stop Event.

  4. If required, change the Event type.

To Change an Event Type

  1. Enable the Event Editor in the Stage.

  2. In the Director, select the Event to be change.

  3. In the Event Editor, click an Event type button in the Type area to change status.

    images/download/attachments/130576963/image-2023-7-17_10-1-54.png



  4. If Pause is selected: In the Value box, define the number of frames that the animation should pause for, before it continues.

To Move an Event along the Time-line

  1. Select one or more Events.

  2. Drag the selected Events along the Director Time-line.

    Note: To select more than one Event press and hold CTRL and click on each required Event.

    or

  1. Enable the Event Editor in the Stage.

  2. Select an Event in the Director.

  3. Move the selected Event:

    • In the Event Editor, enter the new position (in frames) in the Time input box, or

    • Click in the Time input box and drag left or right.

      Note: This moves only the last selected Event in the Director.

To Name an Event

  1. Enable the Event Editor in the Stage.

  2. Select an Event in the Director Time-line.

  3. In the Event Editor, enter a descriptive name in the Name text box.

  4. Press ENTER.

    Note: Special characters, such as space, are not allowed in Event names.

To Delete an Event

  1. Select the Event to be deleted.

  2. Click the images/download/thumbnails/130576963/image-2023-7-17_10-3-7.png (Delete Stop/Tag) button.
    or

  1. Select one or more Events.

  2. Press DELETE.

To Create a Tag (Preview Point) for External Applications

For example, in Viz Trio and Viz Pilot:

images/download/attachments/130576963/image-2023-7-17_10-9-15.png

  1. Open the Stage

  2. Select the default Director.

  3. Position the Time Marker at the point where the Scene is to be previewed.

  4. Click the images/download/thumbnails/130576963/image-2023-7-17_10-9-35.png (Add Stop/Tag) button to add an Event.

  5. In the Event Editor, enter pilot1 (case sensitive) in the Name text box. The name pilot1 is the Tag name requested by control application, and is also the default preview point for an Object scene in Transition Logic-enabled scenes. For labeling more Tags, or preview points, continue with pilot2, pilot3, etc. Make sure Tag is selected in the Type area.

    Note: Custom Tag Events can be used as well. However, those Tags Events are only selectable within the Viz Pilot Newsroom client.

To Create a Tag (Preview Point) for Viz Trio

  1. Open the Stage, and select the default Director.

  2. Position the Time Marker at the point where the Scene is to be previewed.

  3. Click the images/download/thumbnails/130576963/image-2023-7-17_10-9-43.png (Add Stop/Tag) button to add an Event.

  4. In the Event Editor enter the Name as 01, 02, 03, etc. according to the value of the corresponding Field identifiers (01, 02, 03, etc.). Setting these points previews the Scene in the local Viz Trio preview window when a tab field in Viz Trio is selected (01, 02, 03, etc.).

Preview Callback Events

IMPORTANT! This event must only be triggered for the local preview in the External Control Application, and not for any external preview or program engines.

Viz Engine supports a script event called OnPreview upon loading a scene in an External Control Application, such as Viz Trio or Viz Pilot. This gives the designer additional capabilities for when the scene is loaded in the local preview, as it can be used to show or hide parts of the scene to make it clearer for the operator what is shown later in the animation, or to write some instructions for the operator, while the scene should be taken On Air without changes.

It may also be used to compensate for unavailable capabilities on a preview Engine. For example, if a scene plays a video in the background, which cannot be previewed in Engine, a back plate can be shown in the preview with a snapshot of the video. This gives the operator an idea of how the scene looks when taken On Air. It could also be used as an optimization, to save the local preview engine from loading large video files.

Note: Preview Callback Event support requires Viz version 3.8.1 or higher.

The OnPreview script event can be used in a scene or container script. If adding the script as a container script, make sure it is added to the same container as the Control Object plug-in. The script can also be loaded as both a scene and a container script, in which case both scripts are invoked when the scene is loaded.

In Transition Logic scenes, the function can be placed in the scene script of the Master scene, or as a container script on the Control Object container in one or more of the Object scenes. In Transition Logic scenes, the scene script of the Master scene, and the container script on the root Control Object container of all Object scenes, is invoked.

A simple OnPreview script event handler could be like:

sub OnPreview(doPreview as Integer)
if doPreview then
println("4015 Container OnPreview")
end if
end sub


See Also