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

    参考

    To Top