Drawing Basic Shapes with HTML Canvas
Tags: html, javascript, beginners, codenewbie
Published: 2022-03-16 17:04:56

Since HTML canvas is a graphic tool, it goes without saying that it allows us to draw shapes. We can draw new shapes using a number of different functions available to use via the the context we set. If you're brand new to HTML canvas, [start with my introduction article](https://fjolt.com/article/html-canvas-getting-started).

In this guide, we'll cover how to make some of the most basic shapes with HTML canvas - squares, rectangles, circles and triangles.

## Creating Rectangles and Squares with HTML Canvas
Squares and rectangles are easy to make in HTML5 Canvas. There are a number of different rect functions we can use to make

- `rect(x, y, width, height)` - outlines where a rectangle or square should be, but does not fill it.
- `fillRect(x, y, width, height)` - creates a rectangle and immediately fills it.
- `strokeRect(x, y, width, height)` - creates a rectangle and immediately outlines it with a stroke.
As you can see, all of these functions follow the same format - they have an x and y coordinate for where they start, and a width and height within the canvas.

Let's look at some examples in code.

### Clear Rectangle Function
If you want to learn about clearRect, [read my tutorial on that here](html-canvas-how-to-clear-canvas).

### Using rect() to create a rectangle
If we want to use rect() to create a rectangle, and then fill and stroke it, we need to define the fillStyle and strokeStyle. For example, the below code will create a rectangle starting at (10, 10), of dimensions 100x150, with a #b668ff background, and 5px wide white stroke:

**Outcome**:
![How to draw a rectangle with HTML canvas](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/u15b0fhqo1kegp9e0e8e.png)
 

```javascript
let canvas = document.getElementById('canvas');
let ctx = canvas.getContext('2d');

ctx.rect(10, 10, 100, 150);
ctx.fillStyle = '#b668ff';
ctx.strokeStyle = 'white';
ctx.lineWidth = 5;
ctx.fill();
ctx.stroke();
```

### Using fillRect() to create a rectangle
fillRect lets us create a rectangle and automatically fill it with a specific color. That means we don't have to use fill() separately.

For example, the following will fill a rectangle of the same size as before, with a #b668ff background:

```javascript
let canvas = document.getElementById('canvas');
let ctx = canvas.getContext('2d');

ctx.fillStyle = '#b668ff';
ctx.fillRect(10, 10, 100, 150);
```

**Outcome**:
![How to draw a rectangle with HTML canvas](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/zsrntp459obsx1hxany1.png)
 
## Using strokeRect() to create a rectangle
strokeRect() follows a similar format, only it will create a rectangle which is stroked automatically. For example, the below code will make a rectangle of the same dimensions and position as before, with a 5px wide #b668ff border/stroke:

```javascript
let canvas = document.getElementById('canvas');
let ctx = canvas.getContext('2d');

ctx.strokeStyle = '#b668ff';
ctx.lineWidth = 5;
ctx.strokeRect(10, 10, 100, 150);
```

**Outcome**:
![How to draw a stroked rectangle with HTML canvas](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/fdjv99trhcseaq1ke6mc.png)
 

## Creating Circles in HTML Canvas
The easiest way to create a circle in HTML Canvas is to use the `arc` function. An arc doesn't have to draw a full circle, though - it can draw only part of a circle by changing the start and end angles. Let's look at the syntax of ctx.arc, and how to make a circle.

`ctx.arc(x, y, radius, startAngle, endAngle, counterClockwise?)`

- `x` - refers to the x coordinate of the center of the circle.
- `y` - refers to the y coordinate of the center of the circle.
- `radius` - the radius of the arc we are drawing.
- `startAngle` - the angle at which the arc starts (in radians).
- `endAngle` - the angle at which the arc ends (in radians).
- `counterClockwise` - whether the angle goes counter clockwise (default is false, can be set to true).

If we set our `startAngle` to `0 Radians`, it will start at the center right side of the circle. A circle is `2π radians` in diameter. If we want to draw a full circle, our startAngle is `0`, and our endAngle is `2π`.

We can represent this in code using `Math.PI * 2`. Here is our code to draw a circle, with a 4px wide stroke in #b668ff, with a radius of `90px`, where its center point is (100, 100):

```javascript
let canvas = document.getElementById('canvas4');
let ctx = canvas.getContext('2d');
    
ctx.arc(100, 100, 100, 0, Math.PI * 2, false);
ctx.strokeStyle = '#b668ff';
ctx.lineWidth = 4;
ctx.stroke();
```

**Outcome**:
![How to draw a circle with HTML canvas](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/mi5krsuig1oq9qo7y6df.png)
 

## Creating Semi-Circles with HTML Canvas
Since we can use arc to draw circles and adjust our endAngle, we can also use it to draw a semi-circle. As a full circle is 2π in diameter, a semi-circle is only 1π radians. The only extra step we have to do here is draw a line from the end of our semi-circle, back to the beginning again.

Since we are going to end at (10, 100) - as our radius is 90px, we draw a line with the lineTo function back to our starting point, which is (190, 100).

```javascript
let canvas = document.getElementById('canvas');
let ctx = canvas.getContext('2d');
    
ctx.arc(100, 100, 90, 0, Math.PI * 1, false);
ctx.lineTo(190, 100);
ctx.fillStyle = '#b668ff';
ctx.fill();
```

**Outcome**:
![How to draw a semi circle with HTML canvas](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/igtlx8d1f6hogvw1k5yj.png)
 

We can flip our semi-circle by changing the counter clockwise option to true:

```javascript
ctx.arc(100, 100, 90, 0, Math.PI * 1, true);
```

**Outcome**:
![How to draw a semi circle with HTML canvas](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/43mpfvpi7ep7i86ap65a.png)
 

## Creating Ovals with HTML Canvas
We can draw an oval in HTML5 canvas by using the ellipse() function. It works in a very similar way to arc(), except we have two radius options.

`ctx.ellipse(x, y, radiusX, radiusY, rotation, startAngle, endAngle, counterClockwise?)`
- `x` - refers to the x coordinate of the center of the circle.
- `y` - refers to the y coordinate of the center of the circle.
- `radiusX` - the radius along the X axis of the arc we are drawing.
- `radiusY` - the radius along the Y axis of the arc we are drawing.
- `rotation` - how much we wish to rotate our ellipse shape, in radians.
- `startAngle` - the angle at which the arc starts (in radians).
- `endAngle` - the angle at which the arc ends (in radians).
- `counterClockwise` - whether the angle goes counter clockwise (default is false, can be set to true).

Here is an example, using the same concepts as we did before with `arc()`:

```javascript
let canvas = document.getElementById('canvas');
let ctx = canvas.getContext('2d');
    
ctx.ellipse(100, 60, 90, 60, 0, 0, Math.PI * 2, false);
ctx.fillStyle = '#b668ff';
ctx.fill();
```

**Outcome**:
![How to draw an oval with HTML canvas](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/iexjn1629xjn78mvbq5k.png)
 

## Creating Triangle Shapes with HTML Canvas
There is no built in triangle function in Javascript, so we have to use the lineTo and moveTo function instead. All these functions do are draw lines on the context, to specific points.

We use `moveTo` to determine the starting position of our triangle, and then draw lines as appropriate to draw the shape of the triangle we want. Here is an example where we draw a triangle and fill it with #b668ff.

```javascript
let canvas = document.getElementById('canvas8');
let ctx = canvas.getContext('2d');
    
ctx.moveTo(20, 0);
ctx.lineTo(40, 30);
ctx.lineTo(0, 30);
ctx.lineTo(20, 0);
ctx.fillStyle = '#b668ff';
ctx.fill();
```

**Outcome**:
![How to draw a triangle with HTML canvas](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/63dgx0otqtzt1og0x2iz.png)
 

1. We start by using moveTo to determine the starting point of our triangle.
2. Then, we draw a line from (20, 0) to (40, 30) - i.e. 20px to the right, and 30px down from our starting point.
3. Since this triangle will be symmetrical, we draw a 20px to the left, and 30px down, i.e. (0, 30).
4. Finally, we join our shape up by drawing a line back to our starting point, which was (20, 0).
5. Then we fill it, and we have a triangle.

The `lineTo()` function can be used to draw many more complicated shapes in HTML Canvas, which are not built in by default. Any custom polygons will use `lineTo`, such as Hexagons, Octagons, or even Parallelograms.


## Conclusion
In this guide, we've covered how to make some simple shapes in HTML canvas: squares, rectangles, circles and triangles. We've also touched upon the fact that lineTo can be used to draw a line anywhere on our canvas, allowing us to make more complicated shapes like hexagons and octagons. I hope you've enjoyed this article.