imagecolorsforindex

(PHP 4, PHP 5, PHP 7, PHP 8)

imagecolorsforindexカラーインデックスからカラーを取得する

説明

imagecolorsforindex(GdImage $image, int $color): array

指定したインデックスに対する色を取得します。

パラメータ

image

imagecreatetruecolor()のような画像作成関数が返す GdImage オブジェクト。

color

色インデックス。

戻り値

指定したカラーインデックス index に対して適当な値からなる red、green、blue をキーとする連想配列を返します。

変更履歴

バージョン 説明
8.0.0 image は、 GdImage クラスのインスタンスを期待するようになりました。 これより前のバージョンでは、resource が期待されていました。
8.0.0 color が範囲外の値の場合に、 imagecolorsforindex()ValueError をスローするようになりました。 これより前のバージョンでは、 false を返していました。

例1 imagecolorsforindex() の例

<?php

// 画像をオープンします
$im imagecreatefrompng('nexen.png');

// 色を取得します
$start_x 40;
$start_y 50;
$color_index imagecolorat($im$start_x$start_y);

// 可読形式にします
$color_tran imagecolorsforindex($im$color_index);

// どんな内容でしょう?
print_r($color_tran);

?>

上の例の出力は、 たとえば以下のようになります。

Array
(
   [red] => 226
   [green] => 222
   [blue] => 252
   [alpha] => 0
)

参考

関連キーワード:  取得, カラー, imagecolorsforindex, インデックス, バージョン, GdImage, 関数, 期待, red, 参考