imagecolorset

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

imagecolorset指定したパレットインデックスの色を設定する

説明

imagecolorset(
    GdImage $image,
    int $color,
    int $red,
    int $green,
    int $blue,
    int $alpha = 0
): ?bool

この関数は、パレット上で指定したインデックス index を 指定した色 color に設定します。 実際にぬりつぶしを実行するオーバーヘッドなしに パレット上の色を使用する画像をぬりつぶしたような効果を得る ことができ、便利です。

パラメータ

image

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

color

パレットのインデックス。

red

赤コンポーネントの値。

green

緑コンポーネントの値。

blue

青コンポーネントの値。

alpha

アルファコンポーネントの値。

戻り値

この関数は、成功時に null を返します。 失敗した場合に false を返します

変更履歴

バージョン 説明
8.0.0 image は、 GdImage クラスのインスタンスを期待するようになりました。 これより前のバージョンでは、resource が期待されていました。

例1 imagecolorset() の例

<?php
// 300x100 の画像を作成します
$im imagecreate(300100);

// 背景色を赤に設定します
imagecolorallocate($im25500);

// 背景の色インデックスを取得します
$bg imagecolorat($im00);

// 背景色を青に設定します
imagecolorset($im$bg00255);

// 画像をブラウザに出力します
header('Content-Type: image/png');

imagepng($im);
imagedestroy($im);
?>

参考

  • imagecolorat() - ピクセルの色のインデックスを取得する
関連キーワード:  インデックス, パレット, 設定, 指定, , int, 関数, imagecolorset, コンポーネント, GdImage