Imagick::adaptiveResizeImage

(PECL imagick 2, PECL imagick 3)

Imagick::adaptiveResizeImageRedimensionne adaptativement une image par triangulation

Description

public function Imagick::adaptiveResizeImage(
    int $columns,
    int $rows,
    bool $bestfit = false,
    bool $legacy = false
): bool

Redimensionne une image adaptativement par triangulation. Cette fonction évite les effets de flou dans les images à contraste fort. Elle fonctionne au mieux avec des images qu'il faut réduire légèrement à une taille Web standard; ne fonctionne pas toujours quand il faut réduire une grosse image à une miniature. Cette méthode n'est disponible que si Imagick a été compilé avec ImageMagick version 6.2.9 ou supérieur.

Note:

Le comportement du paramètre bestfit a changé avec Imagick 3.0.0. Avant cette version, fournir les dimensions 400x400 à une image de dimensions 200x150 faisait que la partie gauche était inchangée. Avec Imagick 3.0.0 et suivants, l'image est réduite à la taille 400x300, sachant que c'est le meilleur résultat pour ces dimensions. Si le paramètre bestfit est utilisé, la largeur et la hauteur doivent être fournies.

Liste de paramètres

columns

Le nombre de colonnes dans l'image cible.

rows

Le nombre de lignes dans l'image cible.

bestfit

Indique si l'image doit tenir dans les dimensions données tout en conservant les proportions.

legacy

Paramètre optionnel de type bool. Si défini à true, les calculs sont effectués avec le léger bogue d'arrondi qui existait dans Imagick avant la version 3.4.0. Si défini à false, les calculs produisent les mêmes résultats que les outils en ligne de commande d'ImageMagick.

Valeurs de retour

Retourne true en cas de succès.

Erreurs / Exceptions

Lance une exception ImagickException si une erreur survient.

Historique

Version Description
PECL imagick 2.1.0 Ajout d'un paramètre optionnel de fit.
PECL imagick 2.1.0 Cette méthode supporte maintenant la mise à l'échelle proportionnelle. Utiliser la valeur zéro comme paramètre pour une mise à l'échelle proportionnelle.
PECL imagick 3.4.0 Ajout du paramètre legacy.

Exemples

Exemple #1 Exemple avec Imagick::adaptiveResizeImage()

Redimensionne une image à une taille standard pour le Web. Cette méthode fonctionne au mieux lorsqu'il faut redimensionner à une taille légèrement inférieure à l'image précédente.

<?php
header('Content-type: image/jpeg');

$image = new Imagick('image.jpg');
$image->adaptiveResizeImage(1024,768);

echo $image;
?>

Voir aussi

add a note

User Contributed Notes

There are no user contributed notes for this page.