Director (Scene) Node - Lumberyard User Guide

Director (Scene) Node

Open 3D Engine (O3DE), the successor to Lumberyard, is now available in Developer Preview. Download O3DE or visit the AWS Game Tech blog to learn more.

The Director (Scene) node includes a camera track that specifies the active camera for a track view sequence. You can add sequence-specific nodes (for example, Depth of Field or Comment) under the Director node to override the same nodes that were set at the sequence level.

To add a Director node in the Track View

  1. In Lumberyard Editor, choose Tools, Track View.

  2. In the Track View, click the Add Sequence icon.

  3. In the Add New Sequence dialog box, enter a name for your sequence and click OK.

  4. Right-click your sequence and choose Add Director (Scene) Node.

  5. Right-click the Director node and click Add Track.

                    Add the Director node in the Track View to
                        manage your track view sequence.
  6. Select the track and double-click to position the key on its highlighted row in the timeline.

  7. Double-click the green marker, and under Key Properties, enter a value for Value.

    You can add the following tracks and then set the key properties to the Director node.

    Director Node Tracks and Key Properties
    Track Key Property Description
    Camera Camera

    Specifies the sequence camera. You can optionally override the camera with the mov_overrideCam console variable . Set the console variable to an entity ID (string) of a Camera component entity for component entity sequences.

    For more information, see Using the Console Window.

    Blend time Specifies the blend time, in seconds, between sequential cameras in the track.
    Capture Duration Sets the capture duration in seconds.
    Time Step Forces a fixed frame rate, in seconds, by using a specified time step. Time step = 1/number of frames. Units are in 1 fps (frames per second), so a time step value of .0333 results in a game frame rate of 30 fps.
    Output Format

    Specifies the image output file format. Choose from the following options:

    • jpg

    • tga

    • tif

    Output Prefix Specifies a prefix to apply to the image file names. For best results, use the same prefix as the sequence for clarity.
    Output Folder Specifies the directory where the image files are stored.
    Buffer(s) to capture Specifies the image capture format. Choose from the following options:
    • Color – RGB pixel information

    • Color+Alpha – RGB pixel data and Alpha channel data


      To capture Alpha channel data, you must set Output Format to tga.

    Just one frame? Specifies if you want to capture a single frame.
    Console Command Runs the specified console variable command.
    Event Event Specifies the event to trigger in the Director node Lua script.
    Value Specifies the custom value that is referenced in the nodes for your Script Canvas graph or code.
    No trigger in scrubbing. Prevents the event from occurring while you preview the timeline of the track view sequence.
    FixedTimeStep Value Sets a fixed time step in order to modify the game speed. Units are in 1 fps, so a fixed time step value of .0333 results in a game frame rate of 30 fps.
    GoTo Goto Time Jumps forward or backward in a sequence. Use this track for key framing time shifts and to loop part of a sequence. This key automatically applies animation blending on animations that are currently playing in the sequence.
    Sequence Sequence Specifies the track view sequence to play at the specified keyframe.
    Override Start/End Times Overrides the sequence start and end times.
    Start Time Specifies the start time to override.
    End Time Specifies the end time to override.
    Sound StartTrigger Specifies the trigger to start the audio.
    StopTrigger Specifies the trigger to stop the audio.
    Duration Specifies the length to play the audio.
    Custom Color Specifies the color to display for the audio on the timeline.
    Timewarp Value Creates a slow-motion effect using a curve that scales the movie playback speed by the Timewarp value. A value of 1.0 represents normal speed; smaller values slow down time and larger values speed up time. If you set Timewarp to 0, playback will completely stop in your movie. Timewarp applies only to visuals; sounds are not slowed down.
  • You can add multiple Director nodes to a scene, but only one Director node can be active.

  • To change the active Director node, right-click the node and choose Set as Active Director. When you deactivate a Director node, all child node animations are deactivated. This is useful when you want to enable and disable animation for specific objects within the same track view sequence.