関数・クラス解説

imagecolorclosest

version:PHP 4, PHP 5, PHP 7 (公式)

指定した色に最も近い色のインデックスを取得する

公式リファレンス

書式

imagecolorclosest ( resource $image , int $red , int $green , int $blue ) : int

説明

指定した RGB 値に「近い」 画像パレット中の色のインデックスを返します。

指定した色とパレット上の各色の「距離」は、 RGB 値が三次元空間上の点の座標を表すと考えて計算します。

画像をファイルから作成した場合は、画像内で使われている色だけを解決します。パレットにだけ存在する色は解決されません。

パラメータ

image
imagecreatetruecolor()のような画像作成関数が返す画像リソース。
red
赤コンポーネントの値。
green
緑コンポーネントの値。
blue
青コンポーネントの値。
色のパラメータは、0 から 255 までの整数値か 0x00 から 0xFF までの十六進値を指定します。

返値

画像パレット内で、指定した色にいちばん近い色のインデックスを返します。

サンプル

例1 画像内での色セットの検索

// 画像を作成し、パレット画像に変換します $im = imagecreatefrompng('figures/imagecolorclosest.png'); imagetruecolortopalette($im, false, 255); // 探したい色 (RGB) $colors = array(     array(254, 145, 154),     array(153, 145, 188),     array(153, 90, 145),     array(255, 137, 92) ); // それぞれを検索し、パレット内でもっとも近い色を見つけます // 検索番号、検索した RGB、そして見つかった RGB を返します foreach($colors as $id => $rgb) {     $result = imagecolorclosest($im, $rgb[0], $rgb[1], $rgb[2]);     $result = imagecolorsforindex($im, $result);     $result = "({$result['red']}, {$result['green']}, {$result['blue']})";     echo "#$id: Search ($rgb[0], $rgb[1], $rgb[2]); Closest match: $result.\n"; } imagedestroy($im);

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

#0: Search (254, 145, 154); Closest match: (252, 150, 148). #1: Search (153, 145, 188); Closest match: (148, 150, 196). #2: Search (153, 90, 145); Closest match: (148, 90, 156). #3: Search (255, 137, 92); Closest match: (252, 150, 92).

参考

  • imagecolorexact() - 指定した色のインデックスを取得する
  • imagecolorclosestalpha() - 指定した色+アルファ値に最も近い色のインデックスを取得する
  • imagecolorclosesthwb() - 色合い、白、黒を有する色のインデックスを得る
  • ワード検索


    ※入力キーワードが、関数名・説明文・タグに含まれるものを検索

    関数名アルファベット別

    A B C D E F G H I J
    K L M N O P Q R S T
    U V W X Y Z _

    最終更新一覧

    stristr
     大文字小文字を区別せず文字列を検索し、ヒット箇所以降(あるいは以前)の文字列を返却

    stripslashes
     バックスラッシュでエスケープされた文字列から、バックスラッシュを取り除く

    stripos
     大文字小文字を区別せずに文字列が最初に現れる位置を取得する

    stripcslashes
     addcslashes() でクォートされた文字列をアンクォートする

    strip_tags
     文字列から HTML と PHP のタグを除去して返却

    strcspn
     指定した文字が最初に現れる位置を調べる

    strcoll
     ロケールに基づいて2つの文字列を比較し同じか(あるいは大小)を判定する

    strcmp
     2つの文字列を比較し同じか(あるいは大小)を判定する

    strchr
     strstr() のエイリアス

    strcasecmp
     2つの文字列を比較(大文字小文字を区別せず同じとみなす)

    カテゴリー一覧

    PHP の振る舞いの変更
    音声フォーマットの操作
    認証サービス
    コマンドライン関連
    圧縮およびアーカイブ
    暗号
    データベース関連
    日付および時刻関連
    ファイルシステム
    自然言語および文字エンコーディング
    画像処理および作成
    メール関連
    数学
    テキスト以外の MIME 型
    プロセス制御
    その他の基本モジュール
    その他のサービス
    検索エンジン用の拡張モジュール
    サーバー固有のモジュール
    セッション関連
    テキスト処理
    変数・データ型関連
    ウェブサービス
    Windows 用のモジュール
    XML 操作
    GUI用の拡張モジュール