Curve Gradient Layer

From Synfig Studio :: Documentation
Jump to: navigation, search
Languages Language: 


Layer gradient curve icon.png

About Curve Gradient Layer

As you already guessed, a Curve Gradient is a gradient that follows a curve. One side of the curve will be filled with the color at the beginning of the current gradient (see the Gradient Editor Dialog), and the other side will be filled by the color at the end of the gradient. In other words, the gradient will fully cover your canvas (as the other gradients do), and you'll have to play with the Blend Method if you want to bind it to a specific shape.

There are two ways to display a gradient: the default one (fast), and an improved one that can remove any render artifacts you have with the first one. To switch from one method to the other, check/uncheck the "Fast" Parameter from the Parameters Panel.

Parameters of Curve Gradient Layer

The parameters of the "Curve Gradient Layer" are:

Name Value Type
Type real icon.png Z Depth 0.000000 real
Type real icon.png Amount 1.000000 real
Type integer icon.png Blend Method Composite integer
Type vector icon.png Origin 0.000000pt,0.000000pt vector
Type real icon.png Width 5.500000pt real
Type list icon.png Vertices List spline
Tool gradient icon.png Gradient
Type bool icon.png Loop
Type bool icon.png ZigZag
Type bool icon.png Perpendicular
Type bool icon.png Fast

Creating a Curve Gradient

There are several ways to create a gradient that follows a curve.

  • In the New Layer Menu (from the Canvas Menu Caret or with a right click on a layer in the Layers Panel), select Gradients > Curve Gradient. It will create a gradient with a default shape. On the Parameters Panel, right click on "Vertices", and select Convert > Spline, so you can edit the shape of the gradient.
  • To make a Curve Gradient follow an existing shape, place the "Curve Gradient Layer" above the layer containing the shape in the Layers Panel. Select those two layers, then on the Parameters Panel, right-click on "Vertices" (greyed) and select "Link".
  • Alternately, to make a Curve Gradient follow an existing Spline shape (Outline, Region, or other Curve Gradient), select the shape you want it to follow, right-click its Vertices Parameter in the Parameters Panel and chose Export from the menu. Type a name in the dialog that pops up. Then select the "Curve Gradient Layer" where you want to use this exported shape. Open the Library Panel, find the shape you just exported and select it. Then right-click on the Vertices parameter of the exported Layer where you want to use the shape and select "Connect" from the menu.

Spreading the gradient

Your Curve Gradient is now created, but it may not look at all like a gradient. Instead it may looks like each side of the curve was filled with a solid color. That's because the width of the gradient is too small. Make sure that the "Curve Gradient Layer" is selected, and in the Parameters Panel, increase the "Width" value. Your gradient will appear.

An easier way to increase the gradient size is to use the Width Handles. In the Canvas Menu select View > Show/Hide Handles > Show Width Handles. The Width Handles appear in purple on the Canvas. Grab one of them to adjust the width. Each Width Handle can be adjusted independently. The width of the gradient will follow the width of the Spline at each point, so it's possible to have the gradient very wide in some places and less wide in others.

Fast Option

Within the Parameters Panel of the "Curve Gradient Layer" is a "Fast" option. I'm unsure exactly what speed up it produces, but it does cause a visual artifact when the gradient is constrained with transparency as show in the Gradient Editor Dialog page, and curve vertices are set to width = 0.


The "Fast" option can be turned Off in the curve gradient layer's Parameters Panel.

Languages Language: