General

Input

Texture Space

This is the name of the UV coordinate map on the surface that will index the Scalar Ramp, when the Source option is set to 'UV Map'. If you leave this empty, then the first found UV map is used.

Source

This option determines the source of the coordinate that will index the Scalar Ramp.

  • UV Map - the coordinate is defined by a UV coordinate map on the object
  • Alt - the coordinate is defined by the Alt Input value
  • Auto - the default setting. If the inputs for Alt Input and Texture Space are both not configured, the standard UV map will be used instead. If one othe the inputs is configured, it will be used automatically as source.

Alt Input[-∞..+∞]

The scalar coordinate value that will index the color ramp when Source is set to 'Alt'.

Mapping

This option remaps a uv coordinate input to a float value in preparation for indexing the Scalar Ramp, when Source is 'UV Map' or 'Auto' (with no value for Alt Input connected).

  • Horizontal - the u component of the uv coordinate is used
  • Vertical - the v component of the uv coordinate is used
  • Diagonal - the average of the u and v components is used
  • Radial - the angle between the u and v components is used, mapped to 0-1
  • Circular - the hypotenuse of the u and v components is used

Adjust

Exposure[-∞..+∞]

Increases or decreases how the scalar ramp is mapped in a similar fashion to increasing or decreasing light exposure.

Old Range Min[-∞..+∞]

Old Range Max[-∞..+∞]

Controls the input range of the scalar ramp.

New Range Min[-∞..+∞]

New Range Max[-∞..+∞]

Controls the output range of the scalar ramp.

Invert

Enabling this option inverts the computed coordinate that will be used to index the scalar ramp.

Noise Amount[-∞..+∞]

This scales the amount of noise that will be applied to the scalar ramp coordinate to add variation to the values. A value of 0.0 means no noise is applied, with higher values meaning stronger noise.

Noise Frequency[-∞..+∞]

This scales the noise effect applied to the scalar ramp coordinate, with higher values resulting in higher frequency noise.

Ramp

Settings

Use this curve to convert the connected input values to a new floating point value. The horizontal axis of the graph represents the value of the input (left 0, right 1). The vertical axis direction of the graph represents the output value (bottom 0, top 1), Accordingly, if the curve is linear from bottom left to top right, the input values remain unchanged. Further control points can be added to the curve by Ctrl-clicks, at which tangents can also be used to display any desired curve. The operation of the spline graph otherwise corresponds to the typical spline graph GUI elements that can also be found with other nodes and objects in Cinema 4D. If you like to use a different range of value for the input or the output, have a look at the Settings parameters of the scalar ramp.


Click here to unfold the description of the Spline UI element in Cinema 4D.Closed

In general, you can remember that existing points on the curve can simply be grabbed and moved with the mouse when operating spline control elements. You will also find input fields below the spline for exact positioning if you click on the small arrow to the left of the function graph. The exact Y-position of a point can also be entered directly in the function graph by double-clicking on the point.
In the area below the function graph, you can control the Interpolation for each selected spline point, e.g., to work with tangents or hard interpolated points.
New points can be created by Ctrl-clicking or Cmd-clicking on the curve. Existing points can be selected by clicking on them and then deleted again by pressing the Del key.

You can also select several spline points at the same time by:

  • Dragging a rectangle selection with the left mouse button held down (the keys described in the next point also work here)
  • Adding several points to a selection one after the other by holding down the Shift key. Items that have already been selected can also be deselected again with Ctrl/Cmd clicks.

Common curves can be called up directly by right-clicking on the graph and then navigating to the Spline Presets submenu in the context menu. You will also find a Load Preset... button under the spline curve to load previously saved spline curves directly. You can also save your own curves at any time via Save Preset....
In general, you will also find many other helpful functions in the right-click context menu, e.g., for duplicating and mirroring a spline or for activating standard interpolations for individual points (submenu: Point Types).


The Spline Control Element

Each spline point that is using Spline Interpolation offers tangents that can be used to influence the course of the curve in the immediate vicinity of the point. Tangents always start at the spline point and have a handle at the end that can be grabbed and moved with the mouse.

Moving the tangent end points is supported by the following keys:

  • Shift: The moving half of the tangent can be changed independently of the opposite side (i.e., the tangent can be broken). If you want to undo the 'break', deactivate the Break Tangent option below.
  • Ctrl/Cmd: The tangents can only be changed in length, but not in angle. You will also find a Lock Angle option below the graph.

You can find options for each of these functions below, which you can use to set this permanently for each spline point. These options can then be used, for example, to lock an existing angle between broken tangents(Keep Visual Angle) or you can only edit the angle of a tangent, but no longer its length(Lock Length).

Some keyboard shortcuts also work, such as 0 (to set the Y component of the tangents to 0) or L (to set the X component of the tangents to 0).

The curve can also be moved as a whole using the mouse. To do this, simply grab the curve directly with the mouse between the spline points. For this to work, the Move Curves option must be active, which you can access by right-clicking on the function graph in its context menu.
If the option for Min/Max Lines is also active in the context menu just mentioned, the lowest and highest Y value of the curve is displayed with a horizontal dashed line. These dashed lines can then also be moved vertically with the mouse in order to scale the amplitude of the curve as a whole.

Within the graphical spline display, the hotkeys '1' (Move) and '2' (Scale) or the middle mouse button can be used to zoom in on specific areas. If you find the function graph display too small, you can use the button for Show in Separate Window below to open a window that can be scaled as required, where you can then fine-tune the curve to your heart's content.

Let's now take a detailed look at all the parameters of the Function Graph element:

Point X

Point Y

The coordinates of a selected spline point are displayed here. You can also edit this position directly here.

Lock X

Lock Y

This locks the respective coordinate component to prevent unwanted changes to it. These options can be set separately for each spline point.

Interpolation

Here you specify the type of interpolation (curve shape) to the next point for selected points:

  • Spline: The shape of the curve can be customized using tangents. The tangent always appears on the right-hand side of the selected point and on the left-hand side of the neighboring point to the right, e.g., if the first point of a spline is using Linear Interpolation and the second point is using a Spline interpolation, you will only find a right-hand tangent at the second point and a left-hand tangent at the third point.
  • Cubic: Results in a harmonic curve through the spline points without overshoots. No tangents are used.
  • Linear: A linear point always shows a straight connecting line to the following point, regardless of the interpolation used there.

If you right-click in the function graph, you can also choose common curve transitions for selected points in the context menu that opens under Point Types.

Tangent Left X / Left Y

Tangent Right X / Right Y

The tangent end points can be set numerically here.


For each spline point that uses Spline Interpolation, the following four options can be used to lock individual properties of the tangents;

Break Tangent

The left and right tangents can be processed independently of their counterparts.

Keep Visual Angle

The angle between the left and right tangent remains constant when working on one tangent (if possible), i.e., the other tangent moves with it.

Lock Angle

Tangents can only be changed in their length.

Lock Length

Tangents can only be rotated around their origin and remain unchanged in length.

Show in Separate Window

The function graph is opened in a separate, freely scalable window. You can scale it up to screen size and then fine-tune the curve.

Load Preset...

Save Preset...

Spline presets can be saved for later use.

Spline curves can be saved and loaded with these two commands.

Click on Load Preset... to open a small selection window where you can load the corresponding preset by simply double-clicking (see image above).

When the Save Preset... command is executed, a small dialog opens in which the desired name of the spline preset and other information can be entered. This means that your current spline curve can be permanently saved and reloaded at any time wherever comparable Function Curve controls are used in Cinema 4D. All presets are managed via the Asset Browser.

General details regarding the Preset System in Cinema 4D can be found there.

However, function curves can also be exchanged between different objects and dialogs without the use of saved presets. To do this, right-click on the term Spline (to the left of the curve) and select Copy in the context menu that pops up. You can then right-click on another Function Curve element and select Paste to transfer the spline curve.

Context menu

Right-click on the function graph to open a context menu with the following entries:

Frame All

If you have zoomed to a specific point, this command will show the complete spline curve including points.

Frame Selected

All selected curve points are displayed in maximum size.

Enable Snap

Spline points snap onto the grid points.

Min/Max Lines

Minimum and maximum values along the Y axis of the curve are displayed as horizontal, dashed lines. These dashed lines can also be moved vertically with the mouse in order to influence the amplitude of the curve without having to move all points separately.

Move Curves

If you click exactly on the spline curve, you can move the entire curve by holding down the mouse button (if this option is activated; otherwise only if all points are selected).

Rolling Curve

If this option is activated, the curve (if it is moved horizontally as a whole) can be moved out over the ends of the function graph on the left and right. Points that leave the graph appear again on the opposite side.

Link End Tangents

Imagine the first and last points overlapping to form a single point. The activated option then ensures an unbroken pair of tangents, i.e., the two tangents lie exactly opposite each other on a straight line. This is often necessary for functions where the beginning and end merge.

Link End Positions

If this option is activated, the spline start and end points are always at the same height.

Zero X (Tangent)

Zero Y (Tangent)

This sets the X or Y component of the tangent to zero. You then have a vertical or horizontal tangent. The shortcuts 0 (for the Y-portion of the tangents at the selected point) and L (for the X-portion of the tangents at the selected point) have the same effect.

Reset

This resets an existing curve to a linearly increasing curve with a start and end point.

Select All

Selects all points on the spline curve.

Spline Presets

You can select a number of predefined spline shapes here, which are then generated by creating several spline points. The previously displayed spline is replaced.

For Custom see Formula.... Spline shapes can be created here according to a formula to be entered.

Point Types

Here you can select a number of common tangent constellations for the selected points.

Set to Maximum

Set to Minimum

This can be used to move selected points either to the upper edge (Set to Maximum) or to the lower edge (Set to Minimum) of the graph. Warning! If no point is selected on the curve, the entire spline curve is moved to the upper or lower edge of the graph. Any existing tangents at the shifted points are automatically aligned horizontally, or the Y component of these tangents is set to 0.

Flip Horizontal

Flip Vertical

These commands mirror the existing curve on a straight line that runs through Y=0.5 (Flip Horizontal) or X=0.5(Flip Vertical) (i.e., a straight line in the middle of the graph in each case). These commands also work with a selection of spline points and can therefore also be used to mirror a curve section.

Double

If no point is selected, use this to compress the entire curve horizontally to half its width and copy this shortened curve to the second half. This results in a doubling of the curve. However, this command can also be executed for a point selection and is then limited to the selected curve section.

Symmetrize

This command works like Double, except that the curve to be copied is first mirrored horizontally. Here too, only a specific section of the curve can be mirrored symmetrically by selecting points beforehand.

Show in Separate Window

The function graph is opened in a separate, freely scalable window. You can scale this to screen size and then fine-tune the curve.