PHP 8.1.24 Released!

imagecrop

(PHP 5 >= 5.5.0, PHP 7, PHP 8)

imagecropCrop an image to the given rectangle

Descrição

imagecrop(GdImage $image, array $rectangle): GdImage|false

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

Parâmetros

image

Um objeto GdImage, retornado por uma das funções de criação de imagem, como imagecreatetruecolor().

rectangle

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

Valor Retornado

Return cropped image object on success ou false em caso de falha.

Changelog

Versão Descrição
8.0.0 O parâmetro image agora espera uma instância de GdImage; anteriormente, um resource gd válido era esperado.
8.0.0 On success, this function returns a GDImage instance now; previously, a resource was returned.

Exemplos

Exemplo #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);
?>

Veja Também

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

User Contributed Notes

There are no user contributed notes for this page.
To Top