imagegetclip

(PHP 7 >= 7.2.0, PHP 8)

imagegetclipGet the clipping rectangle

Description

imagegetclip(GdImage$image): array

imagegetclip() retrieves the current clipping rectangle, i.e. the area beyond which no pixels will be drawn.

Parameters

image

A GdImage object, returned by one of the image creation functions, such as imagecreatetruecolor().

Return Values

The function returns an indexed array with the coordinates of the clipping rectangle which has the following entries:

  • x-coordinate of the upper left corner
  • y-coordinate of the upper left corner
  • x-coordinate of the lower right corner
  • y-coordinate of the lower right corner

Changelog

VersionDescription
8.0.0image expects a GdImage instance now; previously, a valid gdresource was expected.

Examples

Example #1 imagegetclip() example

Setting and retrieving the clipping rectangle.

<?php
$im
= imagecreate(100, 100);
imagesetclip($im, 10,10, 89,89);
print_r(imagegetclip($im));

The above example will output:

Array ( [0] => 10 [1] => 10 [2] => 89 [3] => 89 )

See Also

To Top