imagecolorset

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

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

説明

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

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

パラメータ

image: imagecreatetruecolor()のような画像作成関数が返す GdImage オブジェクト。
color: パレットのインデックス。
red: 赤コンポーネントの値。
green: 緑コンポーネントの値。
blue: 青コンポーネントの値。
alpha: アルファコンポーネントの値。

戻り値

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

変更履歴

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

例

例1 imagecolorset() の例

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

// 背景色を赤に設定します
imagecolorallocate($im, 255, 0, 0);

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

// 背景色を青に設定します
imagecolorset($im, $bg, 0, 0, 255);

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

imagepng($im);
?>

参考

imagecolorat() - ピクセルの色のインデックスを取得する

関連キーワード:

インデックスパレット imagecolorset image 画像コンポーネント GdImage color green blue alpha 期待背景色 imagecolorat imagecolorresolvealpha imagecolorsforindex Image index 実際ぬりつぶしオーバーヘッド効果便利 imagecreatetruecolor 成功