Fabric.js Image Manipulation with Canvas
Tags: canvas, ui
Published: 2022-11-29 15:00:32

<figure><img src="https://d37oebn0w9ir6a.cloudfront.net/account_32099/fabric_jsandcanvas_e87e8fed5fcdb5df18c01b507183a270.jpg" alt="Header image that says, &quot;We &lt;3 Fabric.js.&quot;"/></figure>

Using Fabric.js image manipulation with [Canvas](https://developer.mozilla.org/en-US/docs/Web/API/Canvas_API) allows us to create some amazing graphics on the web these days. However, the API it provides is disappointingly low-level. It's one thing if we want to [draw a few basic shapes in Canvas](https://code.pieces.app/blog/drawing-interactive-shapes-with-canvas-elements-in-a-react-application) and forget about them; using Canvas won't feel cumbersome. But, when any form of interaction is required with Canvas, such as drawing complex graphics or changing pictures in specific situations, it becomes challenging to use the [Canvas API](https://code.pieces.app/blog/draw-interactive-shapes-react-canvas-api).

## What is Fabric.js?

Fabric.js is a JavaScript library that makes working with [HTML Canvas](https://www.w3schools.com/html/html5_canvas.asp) easy. It provides a unique object model and interactive platform to work with Canvas. Fabric.js was designed to tackle the difficulties of using the Canvas API. With Fabric.js, you can work with both images and animations. For example, Fabric.js allows you to drag, scale, and rotate images. You can also group and manipulate shapes and objects together. Fabric.js even provides the necessary functionality to serialize a Canvas element to SVG or JSON and enables you to reuse it as needed.

## Fabric.js Objects

Fabric.js provides a powerful object model that takes care of Canvas state and rendering. Fabric.js operates on objects by instantiating them, changing their property, and adding them to Canvas. These Fabric.js objects include the following:

- [fabric.Rect](http://fabricjs.com/docs/fabric.Rect.html)
- [fabric.Circle](http://fabricjs.com/docs/fabric.Circle.html)
- [fabric.Triangle](http://fabricjs.com/docs/fabric.Triangle.html)
- [fabric.polygon](http://fabricjs.com/docs/fabric.Polygon.html)
- [fabric.Line](http://fabricjs.com/docs/fabric.Line.html)
- [fabric.Text](http://fabricjs.com/docs/fabric.Text.html)
- [fabric.Group](http://fabricjs.com/docs/fabric.Group.html)
- [fabric.Image](http://fabricjs.com/docs/fabric.Image.html)


One of the unique features of Fabric is interactivity on top of all object models. The object model gives you programmatic access and the ability to manipulate objects on a canvas. As soon as the canvas is initialized, you can select objects, drag them around, scale them, rotate them, and group them in order to manipulate them into one piece.

### Setting Up Fabric.js

Just like every [JavaScript library](https://code.pieces.app/blog/javascript-tools-developer), setting up Fabric.js is quite easy and can be done in one of two ways. The first way is to download the source file from the official website,[ Fabricjs.com](http://fabricjs.com/):

<figure><img src="https://d37oebn0w9ir6a.cloudfront.net/account_32099/image6_24adb376c9b62261f3417adbe511c523.gif" alt="The Fabric.js website."/></figure>

A second way to set up Fabric.js is to copy the CDN link[ HERE](https://cdnjs.com/libraries/fabric.js) and include it in your project. Then, you can create an HTML file, for example, index.html:

```
<html>
  <head>
   <script src="fabric.min.js"></script>
  </head>
</html>
```

### The Fabric.js Install Process

On the other hand, if you want to integrate Fabric.js into React or a similar project, you have to install Fabric.js by using the following:

```
$ npm install fabric
```

After this, you can import Fabric.js with this command:

```
import { fabric } from 'fabric';
```

## Canvas API

The canvas element is used to draw 2-dimensional graphics on websites. It has an API called [Canvas API](https://developer.mozilla.org/en-US/docs/Web/API/Canvas_API), which is used to illustrate basic geometrical shapes like rectangles, triangles, and other objects. However, adding interactions to them or drawing complex shapes becomes very difficult. Fabric.js tends to fix this problem.

Next, we’ll be creating some Canvas objects like rectangles and circles. Because Fabric.js works with the Canvas API, we must make the `<canvas>` element tag in the HTML and give it an id. Further, we must pass that id to the Fabric.js API to initialize the Fabric.js Canvas instance on the `<canvas>` tag with a bit of CSS to center it:

```
<!DOCTYPE html>
<html>
 <head>
 <!-- Adding the fabric.js library -->
    <script src="https://unpkg.com/fabric@5.2.1/dist/fabric.min.js" ></script>
    <style>
      body{
             display:flex;
              flex-direction:column;
              align-items:center;
           }
    </styles>
 </head>
  <body>
      <h2>Learning Fabric</h2>
      <canvas id="canvas"></Canvas>
  </body>
</html>
```

Next, we initiate a Canvas instance in our script tag:

### Canvas API Syntax

```
new fabric.Canvas(element: HTMLElement|String, options: Object)
```

This allows Fabric.js to create this class instance so that we can use the provided methods of Fabric.js:

```
const canvas = new fabric.Canvas("canvas", {})
```

Now, we’ll go ahead and give our canvas different properties, such as width, height, and background color:

```
const canvas = new fabric.Canvas("canvas", {
 width:500,
 height:500,
 backgroundColor:green
})
```

### Canvas API Output

<figure><img src="https://d37oebn0w9ir6a.cloudfront.net/account_32099/image10_231e8afd527405407bcf6619ee00df81.jpg" alt="A green square."/></figure>

## Creating a Rectangle with Fabric.js

Now that we’ve initialized a canvas and given it various properties, we’re going to create a rectangle using the Fabric.js object[ fabric.Rect](http://fabricjs.com/docs/fabric.Rect.html):

### Rectangle Syntax

```
new fabric.Rect({object})
```

Here the object houses the rectangle properties:

```
const canvas = new fabric.Canvas("canvas", {
 width:500,
 height:500,
 backgroundColor:green
});

const rectangle = new fabric.Rect({
 width:200,
 height:200,
 /* fill is used to define the background color*/
    fill:'red'
})
/*the add method is used to add objects to the canvas element */
canvas.add(rectangle)
/*the renderAll method used to render the canvas*/
canvas.renderAll();
```

The `add()` method is used to add objects to the Canvas element. In this case, it adds the rectangle we created to the canvas:

### Rectangle Output

<figure><img src="https://d37oebn0w9ir6a.cloudfront.net/account_32099/image9_5bc747c322ef6bb7bfc23cf83d270ac1.gif" alt="Manipulating a green square in various ways."/></figure>

## Creating a Circle

In the same way, we’ll create a circle. This time, we’ll use[ fabric.Circle](http://fabricjs.com/docs/fabric.Circle.html):

```
const canvas = new fabric.Canvas("canvas", {
 width:500,
 height:500,
 backgroundColor:"lightgray"
});

const circle = new fabric.Circle({
 radius:60,
 fill:"blue"
})
canvas.add(circle);
canvas.renderALl();
```

### Circle Output

<figure><img src="https://d37oebn0w9ir6a.cloudfront.net/account_32099/image2_f04de2a62c43321dc2f14fe3f2ca8903.gif" alt="Manipulating a blue circle in various ways."/></figure>

With the above steps, we created a rectangle and a circle using Fabric.js. Note how interactive the objects are! Next, we’ll discuss images in Fabric.js.

## Images with Fabric

The[ Fabric.Image](http://fabricjs.com/docs/fabric.Image.html) is a Fabric.js object used to render images on a canvas. With Fabric.js, we can interact with the image. Images can be added to our canvas in two ways:

- Fabric.Image
- Fabric.Image.fromURL


Using the Fabric.Image constructor requires us to create an image element in our HTML and then insert it into the constructor:

### Fabric.Image Syntax

```
fabric.Image(image_element)
```

HTML

```
<canvas id='canvas'></canvas>
<img src='my_image.png' id='image' style='display:none'/>
<!-- giving the image the css property of display none makes it not to show outside the canvas -->
```

JS

```
const image_element = document.querySelector('#image');
const image = new fabric.Image(image_element)
canvas.add(image);
canvas.renderAll();
```

However, Fabric.Image.fromURL requires only the image URL (the URL can be retrieved from a website or your local folder), and is simpler than the former:

```
fabric.Image.fromURL(URL, function());
```

After passing the URL, the callback function after the image is loaded. The first default parameter of the callback function is the fabric.Image object. Now, we can modify the image properties and then add it to the canvas:

```
const canvas = new fabric.Canvas("canvas", {
 width:500,
 height:500,
 backgroundColor:"White"
});

fabric.Image.fromURL('my_image.png',(img) => {
 // the scaleToHeight property is use to set the image height
    img.scaleToHeight(250)
 // scaleToWidth is use to set the image width
    img.scaleToWidth(250)
    canvas.add(img)  
})
canvas.renderAll()
```

### Fabric.Image Output

<figure><img src="https://d37oebn0w9ir6a.cloudfront.net/account_32099/image4_6452b384c2c8cf4888683db0519efed1.jpg" alt="A woman laughing. "/></figure>

## Editing Images with Fabric.js

Now that we know how to insert an image into a canvas, we’ll look at other image objects like image filters.

### Fabric.js Image Filters

Fabric.js provides us with built-in filters:

- BaseFilter
- Brightness
- convolute
- GradientTransparency
- Grayscale
- Invert
- Mask
- Noise
- Pixelate
- RemoveWhite
- Sepia
- Sepia2
- Tint


Every instance of `fabric.Image` has the "filters" property, which is a simple array of filters. We can use the array method to perform any required operation, including removing filters (pop, slice, shift), adding filters (push, unshift, slice), and even combining multiple filters. When we call `applyFilters`, any filter in the “filters” array will be applied one by one. Let’s use some of these filters:

#### Image Filters Syntax

```
new fabric.Image.filters
// after that you can add any filter of your choice
// Example 
new fabric.Image.filters.Grayscale()
```

```
fabric.Image.fromURL('my_image.png', (image) => {
      image.scaleToHeight(300)
       image.ScaleToWidth(300)

 // Creating filter
 const filter = new fabric.Image.filters.Grayscale()
 
 //push the filter instance to filters
        image.filter.push(filter)

 // apply filter
         image.applyFilters()

 //add image into canvas (it also re-render the canvas)
         canvas.add(image)
},{crossOrigin: 'anonymous'});
canvas.renderAll();
```

#### Grayscale Filter Output

<figure><img src="https://d37oebn0w9ir6a.cloudfront.net/account_32099/image11_8c7edfd4ba930e71dd7786427506d436.png" alt="A grayscale image of a woman laughing. "/></figure>

Above, we used the Grayscale filter; we can also apply other filters. All we have to do is simply change the filter, as shown in this example:

```
fabric.Image.fromURL('my_image.png', (image) => {
      image.scaleToHeight(300)
       image.ScaleToWidth(300)

 // creating filter
 const filter = new fabric.Image.filters.Sepia()

 //add filter
        image.filter.push(filter)

 // apply filter
         image.applyFilters()

 //add image into canvas (it also re-render the canvas)
         canvas.add(image)
},{crossOrigin: 'anonymous'});
canvas.renderAll();
```

#### Changed Filter Output

<figure><img src="https://d37oebn0w9ir6a.cloudfront.net/account_32099/image4_57f3c11b88057c0a201128da02ac55e2.jpg" alt="An image of a woman laughing."/></figure>

### Image Blending

Blending is mixing two or more images to create a new image. Fabric.js gives us this ability. Here, we’re going to use the image blending filter for our image:

#### Image Blending Syntax

```
new fabric.Image.filters.BlendImage({
 // the image that we want to blend
          image:imageA,
 // blend mode (in this case we are using the 'add' mode)
          mode:'add',
 
 alpha:0.5
      });
```

```
fabric.Image.fromURL('my_image.png', (imageA) => {
    imageA.scaleToWidth(350)
    imageA.scaleToHeight(350)
    canvas.add(imageA)

 // Blending filter
    filter = new fabric.Image.filters.BlendImage({
 image:imageA,
 mode:'add',
 alpha:0.5
      });
 
 //Add the second image  
     fabric.Image.fromURL('my_image2.png',(imageB) => {
           imageB.scaleToHeight(100),
            imageB.scaleToWidth(100),
            canvas.add(imageB)
       }, {crossOrigin:''});

     imageA.filters.push(filter);
     imageA.applyFilters(canvas.renderAll.bind(canvas));
},{crossOrigin:''})
```

#### Image Blending Output

<figure><img src="https://d37oebn0w9ir6a.cloudfront.net/account_32099/image3_36a9420c38146725c254817648810741.gif" alt="Manipulating two images in Fabric.js."/></figure>

### Using Fabric.js to Clip an Existing Image to ClipPath

A very popular effect used today is image clipping, or rather image cropping, which is done to remove parts of an image that we don’t want. With Fabric.js, we can achieve this by using the `clipPath` method. 

First, we have to create our own `clipPath` using any Fabric.js object. Then, we’ll assign it to the `clipPath` property of the object we want to clip. Here, we’ll use a circle object:

```
const clipPath = new fabric.Circle({
 radius:150,
 top:200,
 left:250,
 // The originY and originX helps to center the image and the clipPath
    originY:"center",
 originX:"center"
})
```

After that, we add it to the image that we want to clip using the filter method:

```
new fabric.Image.fromURL('my_image.png',(img) => {
  img.scaleToHeight(300)
  img.scaleToWidth(300)
 // positioning the image
  img.scale(o.5).set({top:50,left:100})
 // Clip Path
  clipPath = new fabric.Circle({
 radius:150,
 top:200,
 left:250,
 originY:"center",
 originX:"center"
    })
  canvas.add(img)
  canvas.clipPath = clipPath;
  });
canvas.renderAll();
```

#### Image Clipping Output

<figure><img src="https://d37oebn0w9ir6a.cloudfront.net/account_32099/image7_781bad333e3f317af8ac23487094122d.gif" alt="Choosing only part of an image of woman laughing. "/></figure>

#### Image Blurring

Like other image filters, the blur filter accepts objects because they can be adjusted. A practical example is changing the brightness of an image. You can apply other image filters without any additional configurations (like grayscale, invert, or sepia). Other image filters like brightness, pixelate, tint, and noise all operate in this way, too. However, the difference is that their values are not the same. The brightness filter's actual brightness level ranges from-1 (full black) to 1 (full white). The noise filter's value is between 0 and 1000. For the blur filter, the value ranges from 0 to 10.

#### Image Blurring Syntax

```
new fabric.Image.filters.Blur(object)
```

```
fabric.Image.fromURL('my_image.png', (image) => {
      image.scaleToHeight(300)
       image.ScaleToWidth(300)

 // Creating the blur filter
 const filter = new fabric.Image.filters.Blur({
 blur:0.6
       })

 //push the filter instance to filters
        image.filter.push(filter)
         image.applyFilters()
         canvas.add(image)
},{crossOrigin: 'anonymous'});
canvas.renderAll();
```

#### Image Blurring Output

<figure><img src="https://d37oebn0w9ir6a.cloudfront.net/account_32099/image1_59bbf32eab51145bc1c4d67b82286287.jpg" alt="A blurry image of a woman laughing."/></figure>

## Conclusion

In conclusion, Fabric.js image manipulation gives us an awesome experience when working with Canvas. It also provides a lot of features, some of which we covered in this article.  For full details on some of the Fabric.js objects, you can [review its documentation to learn more](http://fabricjs.com/docs/).

Download the Pieces for Developers [IntelliJ plugin](https://code.pieces.app/plugins/jetbrains-intellij) or [VS Code extension](https://code.pieces.app/plugins/vscode) to easily use the code snippets above in your projects.