array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.imagecrop.php', 1 => 'imagecrop', ), 'up' => array ( 0 => 'ref.image.php', 1 => 'GD- und Image-Funktionen', ), 'prev' => array ( 0 => 'function.imagecreatetruecolor.php', 1 => 'imagecreatetruecolor', ), 'next' => array ( 0 => 'function.imagecropauto.php', 1 => 'imagecropauto', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'en', 'path' => 'reference/image/functions/imagecrop.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 5 >= 5.5.0, PHP 7, PHP 8)
imagecrop — Crop an image to the given rectangle
Crops an image to the given rectangular area and returns the resulting image.
The given image
is not modified.
image
Ein GdImage-Objekt, das von einer der Funktionen zur Bilderzeugung, z. B. imagecreatetruecolor(), zurückgegeben wurde.
rectangle
The cropping rectangle as array with keys
x
, y
, width
and
height
.
Return cropped image object on successBei einem Fehler wird false
zurückgegeben..
Version | Beschreibung |
---|---|
8.0.0 |
image erwartet nun eine
GdImage-Instanz; vorher wurde eine gültige
gd -Ressource erwartet.
|
8.0.0 | On success, this function returns a GDImage instance now; previously, a resource was returned. |
Beispiel #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');
imagedestroy($im2);
}
imagedestroy($im);
?>