ImagickPixel::getColor

(PECL imagick 2, PECL imagick 3)

ImagickPixel::getColor — Retourne la couleur

Description

public ImagickPixel::getColor(int $normalized = 0): array

Retourne la couleur décrite par l'objet ImagickPixel, sous la forme d'un tableau. Si la couleur contient un canal d'opacité, il sera fourni comme quatrième valeur de la liste.

Liste de paramètres

normalized

Normalise les valeurs de couleurs. Les valeurs possibles sont 0, 1 ou 2.
Liste des valeurs possibles pour normalized

normalized Description

0 Les valeurs RGB sont retournées en tant que ints dans l'intervalle (inclusive) 0 à 255. La valeur alpha est retournée en tant que int et est soit 0 ou 1.

1 Les valeurs RGBA sont retournées en tant que floats dans l'intervalle (inclusive) 0 à 1.

2 Les valeurs RGBA sont retournées en tant que ints dans l'intervalle (inclusive) 0 à 255.

**Liste des valeurs possibles pour `normalized`**
`normalized`	Description
`0`	Les valeurs RGB sont retournées en tant que ints dans l'intervalle (inclusive) `0` à `255`. La valeur alpha est retournée en tant que int et est soit `0` ou `1`.
`1`	Les valeurs RGBA sont retournées en tant que floats dans l'intervalle (inclusive) `0` à `1`.
`2`	Les valeurs RGBA sont retournées en tant que ints dans l'intervalle (inclusive) `0` à `255`.

Valeurs de retour

Un tableau des valeurs des canaux. Lance ImagickPixelException en cas d'erreur.

Exemples

Exemple #1 Utilisation simple de la méthode Imagick::getColor()

<?php

// Crée un objet ImagickPixel avec comme couleur prédéfinie 'marron'
$color = new ImagickPixel('brown');

// Définit la couleur pour avoir un canal alpha de 25%
$color->setColorValue(Imagick::COLOR_ALPHA, 64 / 256.0);

$colorInfo = $color->getColor();

echo "Valeurs standards :".PHP_EOL;
print_r($colorInfo);

$colorInfo = $color->getColor(1);

echo "Valeurs normalisées :".PHP_EOL;
print_r($colorInfo);

?>

L'exemple ci-dessus va afficher :

Valeurs standards :
Array
(
    [r] => 165
    [g] => 42
    [b] => 42
    [a] => 0
)
Valeurs normalisées :
Array
(
    [r] => 0.64705882352941
    [g] => 0.16470588235294
    [b] => 0.16470588235294
    [a] => 0.25000381475547
)