imagecropauto

imagecropauto

Crop an image automatically using one of the available modes

 **imagecropauto** GdImage $image int $mode float $threshold int $color

Automatically crops an image according to the given . mode

modeOne of the following constants:

IMG_CROP_DEFAULT Same as . Before PHP 7.4.0, the bundled libgd fell back to , if the image had no transparent color. IMG_CROP_TRANSPARENT``IMG_CROP_SIDES

IMG_CROP_TRANSPARENTCrops out a transparent background.

IMG_CROP_BLACKCrops out a black background.

IMG_CROP_WHITECrops out a white background.

IMG_CROP_SIDESUses the 4 corners of the image to attempt to detect the background to crop.

IMG_CROP_THRESHOLD Crops an image using the given and . threshold``color

thresholdSpecifies the tolerance in percent to be used while comparing the image color and the color to crop. The method used to calculate the color difference is based on the color distance in the RGB(a) cube.

  Used only in  mode.
 `IMG_CROP_THRESHOLD`

Opmerking: > Before PHP 7.4.0, the bundled libgd used a somewhat different algorithm, so the same yielded different results for system and bundled libgd. threshold

colorEither an RGB color value or a palette index.

  Used only in  mode.
 `IMG_CROP_THRESHOLD`

Returns a cropped image object on successreturn.falseforfailure. false is also returned if the whole image was cropped.

Voorbeeld: Proper handling of auto-cropping

 As noted in the return value section, 
 returns false if the whole image
 was cropped. In this example we have an image object
  which should be automatically cropped only if there
 is something to crop; otherwise we want to proceed with the original image.
`imagecropauto``$im`

<?php
$cropped = imagecropauto($im, IMG_CROP_DEFAULT);
if ($cropped !== false) { // in case a new image object was returned
    $im = $cropped;       // assign the cropped image to $im
}
?>

imagecrop