SVG Gradients – SVG Code and C# Examples

SVG Gradients

SVG gradients allow you to create smooth transitions between colors or other visual properties in SVG graphics. Gradients are defined as gradually blending colors across an area. They are used to achieve various visual effects, such as shading, highlights, and more. SVG supports two main types of gradients: linear gradients and radial gradients that are defined by the <linearGradient> and <radialGradient> SVG elements.

The <linearGradient> or <radialGradient> element must be embedded within a <defs> tag to promote reusability. The <defs> element is often used to define gradients, patterns, filters, and other elements that can be referenced multiple times. The id attribute specifies a unique name for the SVG gradient. Other elements inside the file can reference it. The gradient can be applied for the fill or stroke properties for shapes, text, etc.

In this article, you will learn how to create linear and radial gradients in SVG code and walk through C# examples of implementing SVG gradients using the Aspose.SVG for .NET library.

Linear Gradient

How to create Linear Gradient in SVG Code

Linear gradient is defined by a <linearGradient> element. Linear gradients create a smooth transition between colors along a straight line – gradient vector. The linear gradient vector connects starting and ending points onto which the gradient stops are mapped. The attributes x1, y1, x2, and y2 set the linear gradient vector. Their values can be either numbers or percentages.

The <linearGradient> has nested children <stop> elements that control the colors used in the gradient. Each color is specified with a stop-color attribute. An offset attribute of the <stop> element indicates where the gradient stop is placed. For linear gradients, it represents a location along the gradient vector.

<svg xmlns="http://www.w3.org/2000/svg">
	<defs>
		<linearGradient id="linear-gradient" x1="0%" y1="0%" x2="100%" y2="0%">
			<stop offset="10%" stop-color="#c71700" />
			<stop offset="60%" stop-color="orange" />
			<stop offset="100%" stop-color="#5a2100" />
		</linearGradient>
	</defs>
    <rect x="30" y="30" height="150" width="370" fill="url(#linear-gradient)" />
</svg>

In the example above, the linear gradient id="linear-gradient" is referenced by the <rect> element in the fill attribute. There are three <stop> nodes inside the linear gradient. In each of them, an offset attribute sets the position where the SVG gradient gets a stop-color value. The resulting SVG image looks like this:

Linear Gradient – C# Example

This C# example creates an SVG file with a rectangle filled with a linear gradient similar to the one we saw earlier.

1. Use the SVGDocument() constructor to create an empty SVG document. The RootElement property of the SVGDocument class points to the document’s root <svg> element.
2. Create a <defs> element and add it to the <svg> element:
   • Use the CreateElementNS() method to create an instance of the SVGDefsElement class.
   • Use the AppendChild() method to add the <defs> element to the <svg> element.
3. Create a <linearGradient> element with attributes and add it to the <defs> element:
   • Use the CreateElementNS() method to create an instance of the SVGLinearGradientElement class.
   • Call the SetAttribute(name, value) method to set x1, y1, x2, and y2 attributes.
   • Don’t forget to set the id attribute. Referring to the url name of the id attribute in the <linearGradient> allows applying the SVG gradient to fill and stroke shapes or SVG text.
   • Use the AppendChild() method to add the <linearGradient> to the <defs> element.
4. Create <stop> elements, set their attributes, and add the stops to the <linearGradient> element:
   • Use the CreateElementNS() to create instances of the SVGStopElement class.
   • Call the SetAttribute () method to set offset and stop-color attributes.
   • Use the AppendChild() method to add the stops to the <linearGradient> element.
5. Create a rectangle <rect> element that will be filled with the linear gradient. It is given a fill attribute that is set to url(#linear-gradient) referencing the previously defined SVG gradient with the Id = "linear-gradient".
6. Call the Save() method to save the document to a local file specified by path.

using Aspose.Svg;
using System.IO;

// Create an SVG linear gradient and apply it to a rectangle programmatically in C#

// Set SVG Namespace Url
string SvgNamespace = "http://www.w3.org/2000/svg";

// Initialize an SVG document
using (SVGDocument document = new SVGDocument())
{
    SVGSVGElement svgElement = document.RootElement;

    // Create a <defs> element and add it to the <svg> element
    SVGDefsElement defsElement = (SVGDefsElement)document.CreateElementNS(SvgNamespace, "defs");
    svgElement.AppendChild(defsElement);

    // Create a <linearGradient> element and add it to the <defs> element
    SVGLinearGradientElement linearGradient = (SVGLinearGradientElement)document.CreateElementNS(SvgNamespace, "linearGradient");
    linearGradient.Id = "linear-gradient";
    linearGradient.X1.BaseVal.ValueAsString = "0%";
    linearGradient.Y1.BaseVal.ValueAsString = "0%";
    linearGradient.X2.BaseVal.ValueAsString = "100%";
    linearGradient.Y2.BaseVal.ValueAsString = "0%";
    defsElement.AppendChild(linearGradient);

    // Add color stops to the gradient
    SVGStopElement stop1 = (SVGStopElement)document.CreateElementNS(SvgNamespace, "stop");
    stop1.SetAttribute("offset", "10%");
    stop1.SetAttribute("stop-color", "#c71700");
    linearGradient.AppendChild(stop1);

    SVGStopElement stop2 = (SVGStopElement)document.CreateElementNS(SvgNamespace, "stop");
    stop2.SetAttribute("offset", "70%");
    stop2.SetAttribute("stop-color", "orange");
    linearGradient.AppendChild(stop2);

    SVGStopElement stop3 = (SVGStopElement)document.CreateElementNS(SvgNamespace, "stop");
    stop3.SetAttribute("offset", "100%");
    stop3.SetAttribute("stop-color", "#5a2100");
    linearGradient.AppendChild(stop3);

    // Create a rectangle and apply the linear gradient
    SVGRectElement rectElement = (SVGRectElement)document.CreateElementNS(SvgNamespace, "rect");
    rectElement.X.BaseVal.Value = 30;
    rectElement.Y.BaseVal.Value = 30;
    rectElement.Width.BaseVal.Value = 370;
    rectElement.Height.BaseVal.Value = 150;
    rectElement.SetAttribute("fill", "url(#linear-gradient)");

    // Append the rectangle to the SVG document
    svgElement.AppendChild(rectElement);

    // Save the document
    document.Save(Path.Combine(OutputDir, "linear-gradient.svg"));
}

The resulting linear-gradient.svg file looks exactly like the image above – the rectangle with the red-orange-brown linear gradient.

Radial Gradient

Radial gradients create a smooth transition between colors radiating from a center point. A <radialGradient> element defines a radial gradient and its attributes. Like linear gradients, <stop> elements define color stops along the radial gradient.

• cx, cy, and r attributes define the end circle for the radial gradient. The gradient will be drawn such that the 100% gradient stop is mapped to the perimeter of this end circle.
• fx, fy, and fr attributes define the start circle for the radial gradient. The gradient will be drawn such that the 0% gradient stop is mapped to the perimeter of this start circle.

How to Create Radial Gradient in SVG Code

A radial gradient is more difficult than a linear one. The colors change circularly rather than linearly in it. Radial gradient is defined by a <radialGradient> element.

• The cx and cy attributes set the coordinates of the center of the gradient circle. The value “0.5” corresponds to the center of the element. Both default to 0.5 if omitted.
• The r attribute sets the radius of the gradient circle as a proportion of the element’s size. The value “0.8” corresponds to 80% of the element’s size.
• The fx and fy attributes set the coordinates of the focal point of the gradient ellipse. The focal point is where the gradient’s emphasis is directed. For example, the fx value “25%” indicates that the focal point horizontally at 25% of the element’s width.

In this example, the centers of the end and start circles of the radial gradient do not match.

<svg xmlns="http://www.w3.org/2000/svg">
    <defs>
		<radialGradient id="radial-gradient" cx="0.5" cy="0.5" r="0.8" fx="25%" fy="25%" >
            <stop offset="10%" stop-color="chocolate" />
            <stop offset="30%" stop-color="silver" />
            <stop offset="60%" stop-color="chocolate" />
            <stop offset="90%" stop-color="maroon" />
        </radialGradient>
    </defs>
    <g fill="url(#radial-gradient)">
		<circle cx="100" cy="100" r="90" />
		<rect x="570" y="10" height="130" width="200" />
		<ellipse cx="300" cy="150" rx="150" ry="50" />
		<ellipse cx="490" cy="140" rx="50" ry="130" />
	</g>
</svg>

As you can see in the figure, the perception of the radial gradient depends on the shape it is applied to. The radial gradient can create a compelling illusion of 3D lighting and depth in a circle or ellipse. At the same time, we do not observe such an effect in the rectangle. Here, the gradient gives varying degrees of visual emphasis and lighting effects on flat surfaces.

Radial Gradient – C# Examples

A radial gradient creates a smooth color transition that radiates from the center point to the outer edges of the shape. The following C# code snippet shows how to create a radial gradient. In this example, the centers of the innermost and outermost border of the SVG gradient are the same and by default is 0.5. Let’s consider the C# code step by step:

1. Create an instance of the SVGDocument class. The RootElement property of the SVGDocument class points to the document’s root <svg> element.
2. Create a <defs> element and add it to the <svg> element:
   • Use the CreateElementNS(namespaceURI, qualifiedName) method to create an instance of the SVGDefsElement class.
   • Use the AppendChild() method to add the <defs> element to the <svg> element.
3. Create a <radialGradient> element with attributes and add it to the <defs> element:
   • Use the CreateElementNS method to create an instance of the SVGRadialGradientElement class.
   • Call the SetAttribute() method to set x1, y1, x2, and y2 attributes.
   • Don’t forget to set the id attribute. Referring to the url name of the id attribute in the <radialGradient> allows applying the SVG gradient to fill and stroke shapes or SVG text.
   • Use the AppendChild() method to add the <radialGradient> to the <defs> element.
4. Create <stop> elements, set their attributes, and add the stops to the <radialGradient> element:
   • Use the CreateElementNS() to create instances of the SVGStopElement class.
   • Call the SetAttribute () method to set offset and stop-color attributes.
   • Use the AppendChild() method to add the stops to the <radialGradient> element.
5. Create a rectangle <rect> and <circle> elements that will be filled with the radial gradient. It is given a fill attribute that is set to url(#RadialGradient) referencing the previously defined SVG gradient with the Id = "RadialGradient".
6. Call the Save() method to save the resulting SVG image to a local file specified by path.

using Aspose.Svg;
using System.IO;

// Create and apply a radial gradient to SVG shapes programmatically using Aspose.SVG

// Set SVG Namespace Url
string SvgNamespace = "http://www.w3.org/2000/svg";

// Initialize an SVG document
using (SVGDocument document = new SVGDocument())
{
    SVGSVGElement svgElement = document.RootElement;

    // Create a <defs> element and add it to the <svg> element
    SVGDefsElement defsElement = (SVGDefsElement)document.CreateElementNS(SvgNamespace, "defs");
    svgElement.AppendChild(defsElement);

    // Create a <radialGradient> element and add it to the <defs> element
    SVGRadialGradientElement radialGradient = (SVGRadialGradientElement)document.CreateElementNS(SvgNamespace, "radialGradient");
    radialGradient.Id = "RadialGradient";
    radialGradient.R.BaseVal.ValueAsString = "0.7";
    defsElement.AppendChild(radialGradient);

    // Add color stops to the radial gradient
    SVGStopElement stop1 = (SVGStopElement)document.CreateElementNS(SvgNamespace, "stop");
    stop1.SetAttribute("offset", "0%");
    stop1.SetAttribute("stop-color", "silver");
    radialGradient.AppendChild(stop1);

    SVGStopElement stop2 = (SVGStopElement)document.CreateElementNS(SvgNamespace, "stop");
    stop2.SetAttribute("offset", "55%");
    stop2.SetAttribute("stop-color", "darkgreen");
    radialGradient.AppendChild(stop2);

    SVGStopElement stop3 = (SVGStopElement)document.CreateElementNS(SvgNamespace, "stop");
    stop3.SetAttribute("offset", "100%");
    stop3.SetAttribute("stop-color", "black");
    radialGradient.AppendChild(stop3);

    // Create a rectangle and apply the radial gradient
    SVGRectElement rectElement = (SVGRectElement)document.CreateElementNS(SvgNamespace, "rect");
    rectElement.X.BaseVal.Value = 50;
    rectElement.Y.BaseVal.Value = 50;
    rectElement.Width.BaseVal.Value = 200;
    rectElement.Height.BaseVal.Value = 150;
    rectElement.SetAttribute("fill", "url(#RadialGradient)");

    // Create a <circle> element and set its attributes
    SVGCircleElement circleElement = (SVGCircleElement)document.CreateElementNS(SvgNamespace, "circle");
    circleElement.Cx.BaseVal.Value = 520;
    circleElement.Cy.BaseVal.Value = 125;
    circleElement.R.BaseVal.Value = 90;
    circleElement.SetAttribute("fill", "url(#RadialGradient)");

    // Append the rectangle and circle to SVG
    svgElement.AppendChild(rectElement);
    svgElement.AppendChild(circleElement);

    // Save the document
    document.Save(Path.Combine(OutputDir, "radial-gradient.svg"));
}

The resulting image, radial-gradient.svg, looks like this.

As you see in the figure, when the radial gradient is applied to a circle and a rectangle, the perception of the shapes differs.

• Applying the radial gradient to a rectangle produces a different visual effect than a circle. While the gradient can still add a sense of depth and highlight the rectangle, the 3D feel is less strong than with the circle. Instead, a gradient can accentuate the center of a rectangle or create lighting effects more typical of flat surfaces.

• When applied to a circle, a radial gradient can create a breathtaking 3D effect. The center point of the gradient corresponds to the center of the circle. As the gradient extends from the center to the outer edges of the circle, it simulates the illusion of a light source shining on a rounded surface. Colors fade from the color at the center to the color at the outer edge, mimicking the behavior of light falling on a curved object. This effect can add depth and dimension, making the circle appear more realistic as if it were a spherical object lit from a specific direction.

See also

• You can download the complete examples and data files from GitHub.

• About downloading from GitHub and running examples, you find out from the How to Run the Examples section.

• For more information about SVG Gradients, see the W3C Paint Servers: Gradients and Patterns page and the SVG Filters and Gradients article.