The clip function

  Read comments...
[No canvas support]
An example of the clipping the canvas and then drawing a black rectangle. Only part of the rectangle is visible

The clip function can be used when you want to rectrict any drawing to a particular area of the canvas. You draw a path without stroking or filling it, call the clip function and then any further drawing will be restricted to that area. There is (currently) no reset function so you need to save the state of the canvas before you clip it and then restore it when you're finished - as the example shows.

You can also give a Path2D object to clip to which specifies the clipping area.


Arguments to the function

An example

<script>
    window.onload = function ()
    {
        var canvas  = document.getElementById("cvs");
        var context = canvas.getContext('2d');
        
        context.save();
            
            context.beginPath();
            context.rect(50,50,50,50);
            context.clip();
    
            // Because the canvas is currently clipped only part of the rectangle is drawn on the canvas
            context.fillRect(0,0,600,250);
    
        context.restore();
    }
</script>

See also:
Share RGraph
X

Comments