ImagickPixel::setHSL
(PECL imagick 2.0.0)
ImagickPixel::setHSL — 正規化した HSL カラーを設定する
説明
bool ImagickPixel::setHSL
( float
$hue
, float $saturation
, float $luminosity
)hue (色相)、saturation (彩度) および luminosity (明度) を正規化した値によって ImagickPixel オブジェクトの色を設定します。
パラメータ
-
hue -
色相を正規化した値。これは、色相環上での位置 (0 から 1 まで) を表します。ゼロは赤です。
-
saturation -
彩度を正規化した値。1 が最大です。
-
luminosity -
明度を正規化した値。黒が 0、白が 1 で、 0.5 にすると完全な HS 値が再現されます。
返り値
成功した場合に TRUE を返します。
例
例1 ImagickPixel::setHSL() による色の変更
<?php
// ほぼ真っ赤な色を作ります
$color = new ImagickPixel('rgb(90%, 10%, 10%)');
// その HSL 値を取得します
$colorInfo = $color->getHSL();
// 色相を 180 度反転させます
$newHue = $colorInfo['hue'] + 0.5;
if ($newHue > 1) {
$newHue = $newHue - 1;
}
// ImagickPixel を新しい色に設定します
$colorInfo = $color->setHSL($newHue, $colorInfo['saturation'], $colorInfo['luminosity']);
// 新しい色が青/緑になることを確かめます
$colorInfo = $color->getcolor();
print_r($colorInfo);
?>
上の例の出力は以下となります。
Array
(
[r] => 26
[g] => 230
[b] => 230
[a] => 255
)
注意
注意:
ImageMagick ライブラリバージョン 6.2.9 以降で使用可能です。
忘却曲線を使ってこの知識を確実に記憶に残す
