PHP 7.0.14 Released

imagecrop

(PHP 5 >= 5.5.0, PHP 7)

imagecropCrop an image to the given rectangle

Description

resource imagecrop ( resource $image , array $rect )

Crops an image to the given rectangular area and returns the resulting image. The given image is not modified.

Parameters

image

An image resource, returned by one of the image creation functions, such as imagecreatetruecolor().

rect

The cropping rectangle as array with keys x, y, width and height.

Return Values

Return cropped image resource on success or FALSE on failure.

Examples

Example #1 imagecrop() example

This example shows how to crop an image to a square area.

<?php
$im 
imagecreatefrompng('example.png');
$size min(imagesx($im), imagesy($im));
$im2 imagecrop($im, ['x' => 0'y' => 0'width' => $size'height' => $size]);
if (
$im2 !== FALSE) {
    
imagepng($im2'example-cropped.png');
}
?>

See Also

  • imagecropauto() - Crop an image automatically using one of the available modes
add a note add a note

User Contributed Notes 1 note

up
9
robert at woodst dot com
5 months ago
It appears that imagecrop() will output a black line along the bottom the resulting image until version 5.6.12. Your only choices are to upgrade PHP or use imagecopyresampled().

http://php.net/ChangeLog-5.php#5.6.12 (bug #67447)
To Top