imagecolorsforindex

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

説明

array imagecolorsforindex(GdImage $image, int $color)

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

パラメータ

image

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

color

色インデックス。

戻り値

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

変更履歴

バージョン 説明
8.0.0 image は、 GdImage クラスのインスタンスを期待するようになりました。 これより前のバージョンでは、有効な gd resource が期待されていました。
8.0.0 color が範囲外の値の場合に、 imagecolorsforindexValueError をスローするようになりました。 これより前のバージョンでは、 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
)

参考

  • imagecolorat
  • imagecolorexact