Curve Editor

Tool for interactively setting up and modifying curves to drive values of Distribution properties.

Choose your operating system:

Windows

macOS

Linux

The Curve Editor allows fine control over properties that change over time, e.g. properties which make use of Distributions . It is currently used in both Matinee and the Cascade particle system editor.

The Curve Editor, as it is currently used, is not a standalone editor as you would find with most other editors in Unreal Editor. It is used as a dockable pane inside of other editors. As such, opening the Curve Editor is done through the interface of the editor window it is found within, such as the Matinee or Cascade editor windows.

Layout

The Curve Editor is comprised of the following areas:

CurveEditor_Interface.png

  1. Tool Bar

  2. Track List

  3. Graph

Toolbar

Icon

Description

CE_Toolbar_Horizontal.png

Fit the graph to the current visible tracks horizontally.

CE_Toolbar_Vertical.png

Fit the graph to the current visible tracks vertically.

CE_Toolbar_All.png

Fit the graph horizontally and vertically to all points of the current visible tracks.

CE_Toolbar_Selected.png

Fit the graph horizontally and vertically to the selected points of the current visible tracks.

CE_Toolbar_Pan.png

Puts Curve Editor into Pan/Edit mode.

CE_Toolbar_Zoom.png

Puts Curve Editor into Zoom mode.

CE_Toolbar_Auto.png

Sets InterpMode for selected keys to Auto-curve mode. Tangents can rotate for optimal curvature but may have overshoot.

CE_Toolbar_AutoClamped.png

Sets InterpMode for selected keys to Auto-curve mode. Locked, flattened tangents.

CE_Toolbar_User.png

Sets InterpMode for selected keys to User curve mode. Locked, user-modified tangents.

CE_Toolbar_Break.png

Sets InterpMode for selected keys to Curve Break mode. Separate in and out tangents

CE_Toolbar_Linear.png

Sets InterpMode for selected keys to Linear mode.

CE_Toolbar_Constant.png

Sets InterpMode for selected keys to Constant mode.

CE_Toolbar_Flatten.png

Set selected keys' tangents flattened horizontally.

CE_Toolbar_Straighten.png

Straightens selected keys' tangents, when broken.

CE_Toolbar_ShowAll.png

Toggles the display of all keys' tangents.

CE_Toolbar_Create.png

Creates a new tab.

CE_Toolbar_Delete.png

Deletes current tab.

CE_Toolbar_CurrentTab.png

Allows you to choose the current tab when creating multiple tabs.

Track List

tracklist.jpg

The Track List displays all of the curve tracks currently loaded into the current tab. Tracks are normally loaded external to the Curve Editor by pressing a button associated with a Track in Matinee or a Module in Cascade.

track.jpg

Each track in the Track list displays the name of the property associated with the track along with visibility toggle buttons for each individual curve in the track and an overall visibility toggle button. The individual curve visibility toggle buttons are color-coded to correspond to the components of a vector, with red being X, green being Y, and blue being Z. Red is also the color used for a single scalar float value. In the case of a VectorUniformDistribution, there are two sets of curves with each color having a lighter and darker version.

Right-clicking on a track in the Track List brings up the track list context menu.

Curve_RC_Menu.png

  • Remove Curve - Removes the current track from the Curve Editor.

  • Remove All Curves - Clears all tracks loaded in the Curve Editor from all tabs.

Graph

graph.jpg

The Graph takes up the majority of the Curve Editor interface. It is a graphical representation of the curve with time (input value) along the horizontal axis and the property value (output value) along the vertical axis. Keys along the curve are displayed as points which can be selected and manipulated to visually edit the curve.

Right-clicking on the Graph brings up the graph context menu:

Graph_RC_Menu.png

  • Scale All Times - Scales the time values of all points of all visible tracks, e.g. scales horizontally.

  • Scale All Values - Scales the values of all points of all visible tracks, e.g. scales vertically.

Right-clicking on a point on a curve brings up the point context menu:

Key_RC_Menu.png

  • Set Time - Allows the Time of the point to be manually set.

  • Set Value - Allows the value of the point to be manually set.

  • Delete - Deletes the selected point(s).

Controls

Mouse Controls

In Pan/Edit mode:

LMB + Drag on background

Pan view around.

Mouse Scroll

Zoom in and out.

LMB on Key

Select point.

Ctrl + LMB on point

Toggle selection of point.

Ctrl + LMB on curve

Add new key at clicked location.

Ctrl + LMB + Drag

Move current selection.

Ctrl + Alt + LMB + Drag

Box select.

Ctrl + Alt + Shift + LMB + Drag

Box select (add to current selection).

In Zoom mode:

LMB + Drag

Zoom Y axis.

RMB + Drag

Zoom X axis.

LMB + RMB + Drag

Zoom X and Y axes.

Keyboard Controls

In Pan/Edit mode:

Delete

Delete selected points.

Z

Puts you into Zoom mode while held.

Hot Keys

Ctrl + Z

Undo

Ctrl + Y

Redo

Note: Some tools and actions in the Curve Editor may not support Undo/Redo.

Tabs

Tabs in the curve editor allow for organization of tracks. New Tabs can be created easily by pressing the CE_Toolbar_Create.png button. The new tab can be named which can hold any number of tracks.

NewTab.png

This can be useful when working with a particle system made up of multiple emitters. Sending the curve data for multiple Lifetime modules to the Curve Editor could become extremely confusing since there is no real distinction between them other than possibly coloration if one module is selected or the modules' colors are different.

tabs_multiple.jpg

Adding and removing tracks over and over to keep this from happening would be extremely inefficient. By creating a tab for each emitter, the tracks can be kept separate and identified easily keeping any mistaken editing of the wrong track for the wrong emitter.

ChangeTabs.png

Interpolation Modes

The interpolation mode buttons control the method each point on the curve will use to reach the next point. If you are using one of the curve modes (Auto, User, or Break), you will see white handles that you can click and drag to give you more control over the curve between points. If you select a key that is in Auto curve mode and adjust its tangents using the white handles, it will automatically convert to User curve mode.

Below are the available interpolation modes:

  • Auto

    Curve_Auto.png

  • Auto Clamped

    Curve_AutoClamped.png

  • User

    Curve_User.png

  • Break

    Curve_Break.png

  • Linear

    Curve_Linear.png

  • Constant

    Curve_Constant.png

Help shape the future of Unreal Engine documentation! Tell us how we're doing so we can serve you better.
Take our survey
Dismiss