Remaps the input x to the output y based on an editable function curve. This is useful for modulating effects using a custom profile, such as for falloffs and more.

Inputs

fcurve

The function curve to evaluate. You can edit the curve in the Parameter Editor, or connect it to expose the curve editor on the parent compound. You can also set a value node to the FCurve type to drive multiple evaluate_fcurve nodes with the same curve.

x

The x axis value at which to evaluate the curve.

Output

y

The value of the curve at position x.

Editing curves

Optionally, click the options icon and choose a preset curve to use as a starting point. You can also choose a preset curve by right-clicking on the background of the curve editor when it is displayed in a resizable floating window. Then, edit the curve as desired.

Function curves default to the range [0, 1]. However, you can define points at horizontal and vertical positions outside this range.

• Click on a point to select it, or click and drag a box to marquee-select multiple points. Shift-click to toggle the selection of individual points. Press the Delete or Backspace key to remove the selected points. Drag selected points to change their positions and values. For Bezier points, you can also drag the tangent handles to adjust the slope. Right-click on a point for other options, including:

  • Break Tangents to adjust the left and right tangent handles separately.
  • Unify Tangents to lock the handles together.

• Click on the curve to add a point, and then drag it to the desired location.

• Navigate the curve editor using the Alt key:

  • Alt+middle-click and drag to pan.
  • Alt+right-click and drag to zoom in and out.

• Use the buttons at the upper right to:

  • Frame all points on the curve.
  • Open the curve in a separate, resizable window.
  • Open the options menu. This is the same menu as displayed when you right-click in the background of the curve editor in a floating window.

• Use the controls below the curve to:

  • Select a point in order from left to right.
  • Edit the selected point.
  • Set the value or interpolation of multiple points.

Extrapolation

The Pre and Post extrapolation define the behavior of a curve before the first point and after the last point of that curve.

• Constant

  Maintains the value of the end points.

• Linear

  Extrapolates the value of the first point using its tangent information. It projects a straight line infinitely beyond.

• Cycle

  Repeats the curve's shape infinitely.

• Relative Repeat

  Repeats the curve infinitely, except the first point of each cycle is superimposed on the last point of the previous cycle so that, for example, an increasing curve continues to increase.

• Oscillate

  Repeats the curve by reversing its values, and therefore shape, with each cycle, creating an alternating backwards and forwards effect.