Language:
Page Info
Skill Level:
Engine Version:

Matinee Editor Reference

Choose your OS:

The following screenshot shows the Matinee Editor:

Matinee Interface

  1. Menu Bar

  2. Tool Bar

  3. Curve Editor

  4. Track View

  5. Details

You can close any panel by clicking the small "X" in the upper-right corner of the tab. You can also hide any panel by Right-clicking on the tab, and then clicking Hide Tab on the context menu that appears. To once again display a panel that you have closed, click that panel's name on the Window menu.

For more information about Matinee, see Matinee User Guide .

File

Item

Description

Import

Imports a FBX or scene.

Export All

Exports the entire scene (though some items cannot be exported) to a FBX file for editing in an external 3D content creation package.

Export Sound Cue Info

Exports all SoundCue information for the Matinee sequence to a CSV file.

Export Animation Track Info

Exports all AnimTrack information for the Matinee sequence to a CSV file.

Bake Transforms on Export

Toggles whether transforms are baked before exporting the scene.

Save All

Saves your level.

Choose Files to Save

Offers you a choice of which modified level assets you want to save.

Connect to Source Control

If your project is using a source-control system, connects to that source-control system.

See Exporting and Importing Matinee Metadata for more information about these topics.

Edit

Item

Description

Undo

Undoes the last completed action.

Redo

Redoes the last undone action.

Delete Keys

Deletes the keys currently selected in the timeline. Selecting keys in the Curve Editor does not select them in the timeline.

Duplicate Keys

Duplicates (with a slight time offset) the keys currently selected in the timeline.

Insert Space

Inserts the specified amount of time into the matinee sequence at the current time cursor position.

Stretch Section

Stretches (or shrinks) the portion of the sequence contained in the loop section to fit the specified amount of time.

Stretch Selected Key Frames

Stretches (or shrinks) the section of time defined by the selected keyframes to fit the specified amount of time.

Delete Section

Deletes the portion of the sequence contined in the loop section.

Select In Section

Selects all the keys contained within the loop section.

Reduce Keys

Reduces the amount of keys in the currently selected track. This can be useful for tracks that were edited in an external application and may have quite a bit of redundant keys that are not needed to get the desired animation. See Key Reduction for more details.

Save Path Time

Saves the current time and positions of moving Actors to use when building paths.

Jump To Path Time

Moves the time cursor to the saved path-building position.

Editor Preferences

Enables you to configure the behavior and features of the Unreal Editor. Note that this gives you the same options as the Editor Preferences option on the Unreal Editor's Edit menu.

Project Settings

Enables you to change the settings of your current project. Note that this gives you the same options as the Project Settings option on the Unreal Editor's Edit menu.

View

Item

Description

Draw 3D Trajectories

Toggles display of 3D movement paths in the viewports. Display of paths for individual tracks can be toggled on an off by clicking the togglepath_button.jpg button on the track in the track list.

Show All 3D Trajectories

Enables display of 3D movement paths for all movement tracks in the sequence.

Hide All 3D Trajectories

Disables 3D movement paths for all movement tracks in the sequence.

Snap

Toggles snapping of the time cursor and keys.

Time to Frames

Snaps the timeline cursor to the frame rate specified in the Snap Size dropdown. Only enabled if snap size setting is in frames per second.

Fixed Time

Locks playback rate to the framerate specified in the Snap Size dropdown. Only enabled if the snap size setting is in frames per second.

Prefer Frame Numbers

Toggles display of frame numbers instead of time in seconds for the current cursor position for Anim Control tracks.

Show Time Cursor Position

Toggles whether cursor position info for Anim Control tracks should only be displayed for the currently selected Anim Control track or for all Anim Control tracks in the sequence.

Zoom To Time Cursor Position

Toggles whether the timeline should zoom in or out on the current cursor position or on the center of the visible timeline.

View Frame Stats

Toggles display of frame statistics in the viewport.

Editing Crosshair

Toggles display of a crosshair in the center of the viewport.

Editing Grid

Enables and sets the resolution of a grid overlay on the viewport.

Safe Frame Settings

Defines the region of the Matinee sequence that is visible during gameplay from the current camera, given its settings, including aspect ratio and FOV.

Sequence

Zooms timeline to the entire sequence.

Selected

Zooms timeline to the selected key(s).

Loop

Zooms timeline to loop section.

Loop Sequence

Sets start and end of loop section to the start and end of the entire sequence.

End

Moves the time to the last key in the selected track.

Gore

Toggles display of gore in editor preview.

Pan Invert

Toggles whether panning in the timeline moves in the direction of mouse movement or in the opposite direction.

Allow Keyframe Bar Selection

If enabled, enables keyframe selection by clicking on the bar of the keyframe.

Allow Keyframe Text Selection

If enabled, enables keyframe selection by clicking on the text of the keyframe.

Lock Camera Pitch

If enabled, constrains the camera pitch to between -90 and +90 degrees while editing.

Window

Item

Description

UnrealMatinee Curve Editor

Toggles display of the Curve Editor.

Details

Toggles display of the Details Pane.

Toolbar

What follows is a description of each of the toolbar buttons, from left to right as they appear on the toolbar.

Icon

Description

Add Key button

Adds a keyframe at the current position on the selected track.

Interpolation mode button

Sets the default InterpMode to use when adding new keys.

Play button

Starts the preview playback from current position.

Loop button

Loops the preview playback of loop section.

Stop button

Stops the preview playback.

Reverse button

Starts the preview playback in reverse.

Camera button

Creates a camera Actor at the current position of the scene camera.

Playback Speed button

Adjusts the preview playback speed.

Snap Setting button

Sets the timeline granularity for snapping and visualization purposes.

Curves button

Toggles the curves editor.

Snap button

Toggles snapping of the time cursor and keys.

Time to Frames button

Snaps the timeline cursor to the frame rate specified in the Snap Size dropdown. Only enabled if snap size setting is in frames per second.

Fixed Time button

Locks playback rate to the framerate specified in the Snap Size dropdown. Only enabled if the snap size setting is in frames per second.

Zoom Sequence button

Zooms timeline to the entire sequence.

Zoom Selected button

Zooms timeline to the selected key(s).

Zoom Loop button

Zooms timeline to loop section.

Loop Sequence button

Sets start and end of loop section to the start and end of the entire sequence.

End button

Move to the end of the track.

Record button

Opens the Matinee Recorder window.

Movie button

Creates a movie from the Matinee sequence.

Curve Editor

The Curve Editor allows you to graphically visualize and edit the animations curves used by the tracks in the Matinee sequence. Tracks that have animation curves that can be edited in the Curve Editor in Matinee have the curve_send_button.jpg toggle button. Clicking this button will send that track's curve information to the Curve Editor where the curve will become visible and the track info will appear in the track list.

Curve Editor

See the Curve Editor User Guide page for details about working with curve information in the Curve Editor.

You can also refer to the Setting Up Lifts page for an example of manipulating the Curve Editor in a Movement Track.

Track View

The Track View contains a list of all the folders, groups, and tracks contained within the Matinee sequence and shows their keyframe information on a timeline where they can be edited. It consists of the following areas:

Timeline Pane

  1. Group Tabs

  2. Group and Track List

  3. Timeline Info

  4. Timeline

Group Tabs

Group Tabs

The tabs across the top of the Timeline pane show all the Group Tabs that exist in the current Matinee sequence. Group Tabs are a handy way of organizing groups and tracks based on their function. Their use is completely optional. For very simple sequences, you could simply leave all groups and tracks in the default All tab. But with complex sequences, like those used to create in-game cinematics, you will do best to make use of these tabs as the number of groups and tracks in the sequence can quickly add up and become unwieldy to navigate. The All tab will always show all the groups and tracks in the sequence so adding related tracks to a corresponding group tab can be a quick and easy way to find and edit those groups and tracks. You can create your own custom tabs in addition to those provided by default to further organize your groups and tracks based on any criteria you choose.

Group and Track List

Group and Track List

The Group and Track list shows all the groups and tracks in the currently selected group tab. It will be empty by default in a new Matinee sequence.

Timeline Info

The Timeline Info pane displays information about the timeline, including the current location of the time cursor and the total length of the current scene.

Timeline

Timeline

The Timeline is a graphical representation of all the keyframes for all the tracks in the seqence. It shows time along the bottom horizontally and also contains the start and end markers for the loop section (in green) and for the seqeunce itself (in red). Keys can be selected and modified directly in the timeline. Some keys are displayed simply as triangles while other keys are shown as triangles followed by a colored bar. These are keys for animations, sounds, etc. that have a specific duration. The colored bar shows the duration of the action the key is triggering.

Details

Properties Pane

The Details panel is a standard Unreal Details window which displays the details of the currently selected folder, group, or track in the Timeline Pane's track list.

Controls

Mouse Controls

Control

Action

Click-drag on background

Pan sequence around

Mouse wheel

Zoom in and out

Click on key

Select keyframe

Keyboard Controls

Control

Action

Ctrl-click on object

Toggle selection of object

Ctrl-drag

Move current selection

Ctrl-Alt-drag

Box select

Ctrl-Alt-Shift-drag

Box select (add to current selection)

Hot Keys

Control

Action

Enter

Add keyframe at current position on the selected track

Ctrl-W

Duplicate selected keyframes

Delete

Delete selected keyframes

Left/Right Cursor

Jump to previous/next key on selected track

Up/Down Cursor

Move selected group up/down in list

Ctrl-Z

Undo

Ctrl-Y

Redo

R

Razor Tool (for AnimControl Track - see later)