HTML5 Canvas - Composition


HTML5 canvas provides compositing attribute globalCompositeOperation which affect all the drawing operations.

We can draw new shapes behind existing shapes and mask off certain areas, clear sections from the canvas using globalCompositeOperation attribute as shown below in the example.

There are following values which can be set for globalCompositeOperation −

Attribute Description
source-over This is the default setting and draws new shapes on top of the existing canvas content.
source-in The new shape is drawn only where both the new shape and the destination canvas overlap. Everything else is made transparent.
source-out The new shape is drawn where it doesn't overlap the existing canvas content.
source-atop The new shape is only drawn where it overlaps the existing canvas content.
lighter Where both shapes overlap the color is determined by adding color values.
xor Shapes are made transparent where both overlap and drawn normal everywhere else.
destination-over New shapes are drawn behind the existing canvas content.
destination-in The existing canvas content is kept where both the new shape and existing canvas content overlap. Everything else is made transparent.
destination-out The existing content is kept where it doesn't overlap the new shape.
destination-atop The existing canvas is only kept where it overlaps the new shape. The new shape is drawn behind the canvas content.
darker Where both shapes overlap the color is determined by subtracting color values.


Following is a simple example which makes use of globalCompositeOperation attribute to create all possible compositions −

      <script type="text/javascript">
         var compositeTypes = [
         function drawShape(){
            for (i=0;i<compositeTypes.length;i++){
               var label = document.createTextNode(compositeTypes[i]);
               var ctx = document.getElementById('tut'+i).getContext('2d');
               // draw rectangle
               ctx.fillStyle = "#FF3366";
               // set composite property
               ctx.globalCompositeOperation = compositeTypes[i];
               // draw circle
               ctx.fillStyle = "#0066FF";
   <body onload="drawShape();">
      <table border="1" align="center">
            <td><canvas id="tut0" width="125" height="125"></canvas><br/>
               <label id="lab0"></label>
            <td><canvas id="tut1" width="125" height="125"></canvas><br/>
               <label id="lab1"></label>
            <td><canvas id="tut2" width="125" height="125"></canvas><br/>
               <label id="lab2"></label>
            <td><canvas id="tut3" width="125" height="125"></canvas><br/>
               <label id="lab3"></label>
            <td><canvas id="tut4" width="125" height="125"></canvas><br/>
               <label id="lab4"></label>
            <td><canvas id="tut5" width="125" height="125"></canvas><br/>
               <label id="lab5"></label>
            <td><canvas id="tut6" width="125" height="125"></canvas><br/>
               <label id="lab6"></label>
            <td><canvas id="tut7" width="125" height="125"></canvas><br/>
               <label id="lab7"></label>
            <td><canvas id="tut8" width="125" height="125"></canvas><br/>
               <label id="lab8"></label>
            <td><canvas id="tut9" width="125" height="125"></canvas><br/>
               <label id="lab9"></label>
            <td><canvas id="tut10" width="125" height="125"></canvas><br/>
               <label id="lab10"></label>
            <td><canvas id="tut11" width="125" height="125"></canvas><br/>
               <label id="lab11"></label>

The above example would produce following result −