Common Key Frame Editor Properties

• Name: Defines the name of the Key Frame. This name is used for external commands or scripts.

• Time: Defines where along the time-line (in fields) the Key Frame is placed.

• Previous/Next buttons: If the property has more than one Key Frame, the previous or next Key Frame along the time-line is selected.

• Value: The rest of the Key Frame editor options vary according to which property is being animated.

  Example: For scaling, it is possible to define the size of an object in direction X, Y, and Z.

Locked and Unlocked Key Frames

By default the Key Frames in the position animation are locked. They store information about the position of the container along the X-, Y- and Z-axis, as well as the time the Key Frame will be passed by in the animation.

An unlocked Key Frame stores only information of the position along X-, Y- and Z-axis, without the information at which time the Key Frame should be passed. To reflect this, in the object editor for a locked Key Frame the Time is grayed out. Furthermore, as the spline editor shows time and path-percentage, the unlocked Key Frames will not be shown there. In the animation editor unlocked Key Frames will be shown at half height of locked Key Frames. Viz Artist calculates the time the Key Frame will be passed to fit with the handles set in the next locked Key Frame before and after the unlocked Key Frame.

To better understand the difference between locked and unlocked Key Frames, create a simple position animation. You will see the container moving with different speeds between the Key Frames. Next unlock all Key Frames and play the animation once more. The container will move evenly during the whole animation.

Use an unlocked Key Frames to define the path without editing the time for every Key Frame. This can save time.

Action Key Frame Editor Properties

In addition to the common key frame editor properties, the Action Key Frame Editor defines the Action Channel. The action will work when the Director time-line equals the Action Channel Key Frame.

• Value: Enter the command or OS task here

• Type: The action Key Frames can initialize two main types of actions:

  • Command: Use Viz Artist internal commands to execute a number of automated tasks in the program (for Viz Artist internal commands documentation go to: <viz install folder>/Documentation/CommandInterface/index.html)

  • Task: Enter a task command. Any relevant command which can be started from a command line window (i.e., cmd.exe) can be executed as a task. If the path to the executable file contains spaces, set the complete path in quotation marks, for example, "C:\program files\microsoft office\office\winword.exe"

    Tip: Multiple commands can be executed in the Action Key Frame Editor. The commands must be terminated by a ; (semi-colon) and on a new line. For example: RENDERER*TREE*$sometext*GEOM*TEXT SET Hello World; MAIN_SCENE*STAGE*DIRECTOR*$Default GOTO_TRIO $B $A;

• Dir: Sets which way, forwards or backwards, the animation should go to trigger the Action Key Frame:

  • Both: The Key Frame will be triggered when the animation goes forward and in reverse.

  • Normal: The Key Frame will be triggered when the animation goes forwards.

  • Reverse: The Key Frame will be triggered when the animation goes backwards.

• Execute: Starts the action

Position Key Frame Editor Properties

In addition to the Common Key Frame Editor Properties, a Position Key Frame contains information about the position of a Container at a specific time. The parameters of Position Key Frames are:

• Distance: The distance of a selected Key Frame (value in percent) between the first and last Key Frame of the animation (information only)

• X: Defines the position along the X axis.

• Y: Defines the position along the Y axis.

• Z: Defines the position along the Z axis.

Rotation Key Frame Editor Properties

A rotation Key Frame contains information about the container rotation. In addition to the default options in the Key Frame Editors, for a rotation Key Frame it is possible to define specific rotation options.

• X: Defines the rotation along the X axis.

• Y: Defines the rotation along the Y axis.

• Z: Defines the rotation along the Z axis.

• Angle: Defines the angle of the handles for the path or speed.

• Weight: Defines the weight of the handles for the path or speed.

• Smooth Left/Right: Allows the handles for the path to be smooth.

• Single (S), Locked (L) and Mirror (M): Defines the way handles for the path or speed should be modified.
  Furthermore in the spline editor three different splines will be shown, one for every axes. The red one is for the X-axis, the green one for the Y-axis and the blue one for the Z-axis. As you can only edit the currently selected spline, you must use three spline buttons at the top of the Dopesheet Editor (or shortcuts <Ctrl+Z>, <Ctrl+X> and <Ctrl+C>) to select the spline you want to edit. For ease of use in the lower left corner you will find indicated which axis is currently selected.

Scale Key Frame Editor Properties

Scale Key Frames have to do with the scaling of the object in the animation. For a scale Key Frame, in addition to the default options in the Key Frame Editors, it is possible to define the scaling along the X, Y, and Z axes in the three input boxes.

If you have animated the scale, you can scale along up to all three axes. To change all three scale values, in the object editor you will find an input box for X, one for Y and one for Z. There you can change if the values should be Locked or if you change them proportional (Prop) or each Single value.

Furthermore in the spline editor three different splines will be shown (when Prop or Single is selected), one for every axis. The red one is for the X-axis, the green one for the Y-axis and the blue one for the Z-axis. As you can only edit the currently selected spline, you must use three spline buttons at the top of the Dopesheet Editor (or shortcuts <Ctrl+Z>, <Ctrl+X> and <Ctrl+C>) to select the spline you want to edit. For ease of use in the lower left corner you will find indicated which axis is currently selected.

Material Key Frame Editor Properties

With a material Key Frame, in addition to the default options in the Key Frame Editors, it is possible to define color.

If a material has been animated, the object editor for the Key Frames shows a Material Editor . This allows you to conveniently the change the material.

Furthermore in the spline editor two different splines will be shown. The red one is for the alpha value (1), the green one for the shininess (2). As you can only edit the Key Frames/handles of one spline, you must use the number keys in the Stage Editor Bar to select the required spline. For ease of use in the lower left corner you will find indicated which parameter is currently selected.

Clip Key Frame Editor Properties

• Name: Set a name for the Clip Key Frame.

• Time/Time End: Set the start and end time, in fields, of the Key Frame.

• Duration: Time duration of selected clip Key Frame as set by Time/TimeEnd.

• Clip: Click the and select a clip to use.

• Viz One: Select a clip from Viz One (see Transfer Clips From Viz One).

• Lock Clip Length: Locks automatic length adjustment. Keyframe will maintain length for set clips. Useful when exporting the scene after making adjustments to the clip length in the stage, as this will keep the clip length as designed, and not revert to the length of the clip file.

• Before Start: Set what should happen before the clip starts to play within the animation. If the button is disabled, it shows the in-frame. If the button is enabled, it shows black until the animation gets to the clip.

• After End: Set what should happen after the animation leaves the clip Key Frame. If the button is disabled, it shows the out-frame. If the button is enabled, it shows black.

• Clip In/Out: Set the time the clip comes in and goes out.
  Example:

• Time = 50

• Time End = 250

• Clip Length = 4 sec (50i clip)

• Clip In = 00:00:01:00

• Clip Out = 00:00:03:00
  The clip playback starts 1 second after the Director starts. The clip starts at frame 25 and ends at frame 75. Because the Key Frame duration is twice as long the clip part will be played twice.

Adding Camera Events Using Key-frames

The Stage Editor also allows the designer to change the active camera in a scene by using key-frames.