imagecropauto
(PHP 5 >= 5.5.0, PHP 7)
imagecropauto — Crop an image automatically using one of the available modes
Description
$image
[, int $mode = IMG_CROP_DEFAULT
[, float $threshold = .5
[, int $color = -1
]]] ) : resource
Automatically crops an image according to the given
mode.
Parameters
-
image -
An image resource, returned by one of the image creation functions, such as imagecreatetruecolor().
-
mode -
One of the following constants:
-
IMG_CROP_DEFAULT -
Same as
IMG_CROP_TRANSPARENT. Before PHP 7.4.0, the bundled libgd fell back toIMG_CROP_SIDES, if the image had no transparent color. -
IMG_CROP_TRANSPARENT - Crops out a transparent background.
-
IMG_CROP_BLACK - Crops out a black background.
-
IMG_CROP_WHITE - Crops out a white background.
-
IMG_CROP_SIDES - Uses the 4 corners of the image to attempt to detect the background to crop.
-
IMG_CROP_THRESHOLD -
Crops an image using the given
thresholdandcolor.
-
-
threshold -
Specifies 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
IMG_CROP_THRESHOLDmode.Note: Before PHP 7.4.0, the bundled libgd used a somewhat different algorithm, so the same
thresholdyielded different results for system and bundled libgd. -
color -
Either an RGB color value or a palette index.
Used only in
IMG_CROP_THRESHOLDmode.
Return Values
Returns a cropped image resource on success or FALSE on failure.
If the complete image was cropped, imagecrop() returns FALSE.
Changelog
| Version | Description |
|---|---|
| 7.4.0 |
The behavior of imagecropauto() in the bundled libgd has been synced with
that of system libgd: IMG_CROP_DEFAULT no longer falls
back to IMG_CROP_SIDES and threshold-cropping now uses
the same algorithm as system libgd.
|
| 7.4.0 |
The default value of mode has been changed to
IMG_CROP_AUTO. Formerly, the default value has been
-1 which corresponds to IMG_CROP_DEFAULT,
but passing -1 is now deprecated.
|
Examples
Example #1 Proper handling of auto-cropping
As noted in the return value section, imagecropauto()
returns FALSE if the whole image
was cropped. In this example we have an image resource
$im which should be automatically cropped only if there
is something to crop; otherwise we want to proceed with the original image.
<?php
$cropped = imagecropauto($im, IMG_CROP_DEFAULT);
if ($cropped !== false) { // in case a new image resource was returned
imagedestroy($im); // we destroy the original image
$im = $cropped; // and assign the cropped image to $im
}
?>
Vertaling niet beschikbaar
De PHP-handleiding is nog niet in het Nederlands vertaald, dus het scherm is in het Engels. Als u wilt, kunt u het ook in het Frans of in het Duits raadplegen.
Als je de moed voelt, kun je je vertaling aanbieden ;-)
Nederlandse vertaling
U hebt gevraagd om deze site in het Nederlands te bezoeken. Voor nu wordt alleen de interface vertaald, maar nog niet alle inhoud.Als je me wilt helpen met vertalingen, is je bijdrage welkom. Het enige dat u hoeft te doen, is u op de site registreren en mij een bericht sturen waarin u wordt gevraagd om u toe te voegen aan de groep vertalers, zodat u de gewenste pagina's kunt vertalen. Een link onderaan elke vertaalde pagina geeft aan dat u de vertaler bent en heeft een link naar uw profiel.
Bij voorbaat dank.
Document heeft de 30/01/2003 gemaakt, de laatste keer de 26/10/2018 gewijzigd
Bron van het afgedrukte document:https://www.gaudry.be/nl/php-rf-imagecropauto.html
De infobrol is een persoonlijke site waarvan de inhoud uitsluitend mijn verantwoordelijkheid is. De tekst is beschikbaar onder CreativeCommons-licentie (BY-NC-SA). Meer info op de gebruiksvoorwaarden en de auteur.
Referenties
Deze verwijzingen en links verwijzen naar documenten die geraadpleegd zijn tijdens het schrijven van deze pagina, of die aanvullende informatie kunnen geven, maar de auteurs van deze bronnen kunnen niet verantwoordelijk worden gehouden voor de inhoud van deze pagina.
De auteur Deze site is als enige verantwoordelijk voor de manier waarop de verschillende concepten, en de vrijheden die met de referentiewerken worden genomen, hier worden gepresenteerd. Vergeet niet dat u meerdere broninformatie moet doorgeven om het risico op fouten te verkleinen.
