ImagickDraw::setClipPath

Associates a named clipping path with the image

&reftitle.description; public `bool` `ImagickDraw::setClipPath` `string` `clip_mask` &warn.undocumented.func;

Associates a named clipping path with the image. Only the areas drawn on by the clipping path will be modified as long as it remains in effect.

&reftitle.parameters;

`clip_mask`

- the clipping path name

&reftitle.returnvalues;

&return.void;

&reftitle.examples;

### `ImagickDraw::setClipPath` example

    <?php
    function setClipPath($strokeColor, $fillColor, $backgroundColor) {

        $draw = new \ImagickDraw();
        $draw->setStrokeColor($strokeColor);
        $draw->setFillColor($fillColor);
        $draw->setStrokeOpacity(1);
        $draw->setStrokeWidth(2);

        $clipPathName = 'testClipPath';

        $draw->pushClipPath($clipPathName);
        $draw->rectangle(0, 0, 250, 250);
        $draw->popClipPath();
        $draw->setClipPath($clipPathName);
        $draw->rectangle(100, 100, 400, 400);

        $imagick = new \Imagick();
        $imagick->newImage(500, 500, $backgroundColor);
        $imagick->setImageFormat("png");

        $imagick->drawImage($draw);

        header("Content-Type: image/png");
        echo $imagick->getImageBlob();
    }

    ?>