Imagick::borderImage

(PECL imagick 2.0.0)

Imagick::borderImage — Surrounds the image with a border

Description

bool Imagick::borderImage ( mixed $bordercolor , int $width , int $height )

Surrounds the image with a border of the color defined by the bordercolor ImagickPixel object.

Parameters

bordercolor: ImagickPixel object or a string containing the border color
width: Border width
height: Border height

Return Values

Returns TRUE on success.

Changelog

Version	Description
2.1.0	Now allows a string representing the color as the first parameter. Previous versions allow only an ImagickPixel object.

Examples

Example #1 Imagick::borderImage()


<?php
function borderImage($imagePath, $color, $width, $height) {
    $imagick = new \Imagick(realpath($imagePath));
    $imagick->borderImage($color, $width, $height);
    header("Content-Type: image/jpg");
    echo $imagick->getImageBlob();
}

?>

User Contributed Notes

rosh3000 at gmail dot com

9 months ago


To  get an image with exact dimensions (i.e. add whitespace) use with borderImage:  
$desired_width = 1000;
$desired_height = 1000;

 $image->scaleImage($desired_width,$desired_height , true);
 $image->borderImage('white', ($image->getImageWidth() - $desired_width) / 2,($image->getImageHeight() - $desired_height ) / 2);

Alex

2 years ago


Before making border of image in php, please, consider CSS capabilities to do that. These are more powerful and will not change original image

.img_class {
     border:10px solid red; /* Style of border (solid, dotted, inset, outset, ridge, grooved) */
     padding:20px 10px 5px 20px; /* Padding of border by clock-wise rule, starting from top */
     backhround:url('file.jpg'); /* Background image file if padding applied */
 
}