W3cubDocs

/Web APIs

CanvasRenderingContext2D: createConicGradient() method

The CanvasRenderingContext2D.createConicGradient() method of the Canvas 2D API creates a gradient around a point with given coordinates.

This method returns a conic CanvasGradient. To be applied to a shape, the gradient must first be assigned to the fillStyle or strokeStyle properties.

Note: Gradient coordinates are global, i.e., relative to the current coordinate space. When applied to a shape, the coordinates are NOT relative to the shape's coordinates.

Syntax

js

createConicGradient(startAngle, x, y)

Parameters

startAngle

The angle at which to begin the gradient, in radians. The angle starts from a line going horizontally right from the center, and proceeds clockwise.

x

The x-axis coordinate of the center of the gradient.

y

The y-axis coordinate of the center of the gradient.

Return value

CanvasGradient

A conic CanvasGradient.

Examples

Filling a rectangle with a conic gradient

This example initializes a conic gradient using the createConicGradient() method. Five color stops between around the center coordinate are then created. Finally, the gradient is assigned to the canvas context, and is rendered to a filled rectangle.

HTML

html

<canvas id="canvas" width="240" height="240"></canvas>

JavaScript

js

const canvas = document.getElementById("canvas");
const ctx = canvas.getContext("2d");

// Create a conic gradient
// The start angle is 0
// The center position is 100, 100
const gradient = ctx.createConicGradient(0, 100, 100);

// Add five color stops
gradient.addColorStop(0, "red");
gradient.addColorStop(0.25, "orange");
gradient.addColorStop(0.5, "yellow");
gradient.addColorStop(0.75, "green");
gradient.addColorStop(1, "blue");

// Set the fill style and draw a rectangle
ctx.fillStyle = gradient;
ctx.fillRect(20, 20, 200, 200);

Rectangle result

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
createConicGradient 99 99 112
90Implements an older version of the specification. The gradient starts from a line going vertically up from the center, like the equivalent CSS function.
No 85 16.1
15Implements an older version of the specification. The gradient starts from a line going vertically up from the center, like the equivalent CSS function.
99 99 112
90Implements an older version of the specification. The gradient starts from a line going vertically up from the center, like the equivalent CSS function.
68 16.1
15Implements an older version of the specification. The gradient starts from a line going vertically up from the center, like the equivalent CSS function.
18.0

See also

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/createConicGradient