Imagick::scaleImage

(PECL imagick 2, PECL imagick 3)

Imagick::scaleImage — Met à l'échelle la taille de l'image

Description

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

Met à l'échelle la taille de l'image, aux dimensions voulues. Dans le cas où l'un des paramètres est égal à 0, il sera automatiquement calculé.

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 mise à l'échelle.
rows: Le nombre de lignes dans l'image mise à l'échelle.
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. Cette méthode supporte désormais la mise à l'échelle proportionnelle. Passez zéro dans l'un des paramètres pour activer cette option.
PECL imagick 3.4.0	Ajout du paramètre `legacy`.

Exemples

Exemple #1 Exemple avec Imagick::scaleImage()

<?php
function scaleImage($imagePath) {
    $imagick = new \Imagick(realpath($imagePath));
    $imagick->scaleImage(150, 150, true);
    header("Content-Type: image/jpg");
    echo $imagick->getImageBlob();
}

?>