WOLFRAM

Wolfram言語 ＆ システムドキュメントセンター

DominantColors[image]

image 中の主調色を返す．

DominantColors[image,n]

image 中の主調色を最高で n 色返す．

DominantColors[image,n,prop]

同じ主調色に属する領域の指定された特性 prop を返す．

DominantColors[image,n,prop,format]

指定の format で出力を返す．

DominantColors[{image1,image2,…},…]

各 imageiの主調色を返す．

詳細とオプション
Details and Options Details and Options
例題  
例  
スコープ  
基本的な用法  
特性  
フォーマット  
オプション  
ColorCoverage  
DistanceFunction  
Masking  
Method  
MinColorDistance  
アプリケーション  
特性と関係  
おもしろい例題  
関連項目
関連するガイド
関連リンク
履歴
引用書式

DominantColors

DominantColors[image]

image 中の主調色を返す．

DominantColors[image,n]

image 中の主調色を最高で n 色返す．

DominantColors[image,n,prop]

同じ主調色に属する領域の指定された特性 prop を返す．

DominantColors[image,n,prop,format]

指定の format で出力を返す．

DominantColors[{image1,image2,…},…]

各 imageiの主調色を返す．

詳細とオプション

  • DominantColors[image]は，画像中の色のクラスタを表す色のリストを返す．色はGrayLevelまたはRGBColorで表される．
  • DominantColorsは2Dおよび3Dの任意の画像に使うことができる．
  • 返される色は，それぞれのクラスタの大きさによって並べられる．
  • DominantColorsはLABColorを使って色のクラスタを求める．
  • 次の特性を使ってさまざまな形で主調色を返すことができる
  • "Color"RGBまたはグレースケールで与えられる各クラスタの色（デフォルト）
    "HexRGBColor"16進形式によるRGBカラー
    "LABColor"CIELABカラー
    "NearestHTMLColor"直近のHTMLカラーの名前
  • サポートされるその他の特性
  • "Count"各色クラスタに覆われた画素数の合計
    "Coverage"各色クラスタに覆われた画像全体の割合
    "CoverageImage"各色クラスタに覆われた領域を表す画像
    "MaskCoverage"各色クラスタに覆われた指定マスクの割合
  • DominantColors[image,n,{"prop1","prop2",…}]は，複数の特性を計算する．
  • DominantColors[image,n,"Properties"]は，サポートされている特性のリストを返す．
  • format 引数は出力形式を指定する．次はその可能な設定である．
  • Automatic出力を自動的に決定する
    "ColorAssociation"coli{…,valj,…}の連想
    "ColorPropertyAssociation"coli<|…,propjvalj,…|>の連想
    "Dataset"クラスタ特性のDataset
    "List"ネストしたリスト
    "PropertyAssociation"propj{…,vali,…}の連想
  • DominantColorsは次のオプションを取ることができる．
  • ColorCoverage Automatic画像の被覆割合
    DistanceFunction AutomaticColorDistanceでサポートされる任意の距離
    Masking All関心領域
    Method Automatic使用するメソッド
    MinColorDistance Automatic色の最短距離
  • MinColorDistance->d とすると，ColorDistance[c1,c2]<d の場合に，色 c1および色 c2 で表されるクラスタがマージされる．より広範囲を覆う色が新たなクラスタに割り当てられる．
  • ColorCoverage->f とすると，f の割合より少ない部分の画像を覆う色が返される．ColorCoverage->{fmin,fmax}とすると，被覆割合の範囲を指定することができる．
  • Masking->roi では，"CoverageImage"および"MaskCoverage"は，指定された関心領域 roi についての特性を返す． »
  • Methodの可能な設定には以下がある．
  • "KMeans" 平均クラスタ化アルゴリズム
    "KMedoids"メドイドの周りの分割
    "MedianCut"中央値の画素値に基づいて繰り返し色空間を分割する
    "MinVariance"新たな部分領域の分散の和が最小になるように色空間を繰り返し分割する（Wuのアルゴリズム）
    "Octree"すべての画像の画素から八分木を作り，最も代表的なものになるまで葉をマージする

例題

すべて開く すべて閉じる

例  (3)

ロゴ画像中の主調色：

Wolfram Language code: DominantColors[[image]]

グレースケール画像の主調色：

Wolfram Language code: DominantColors[[image]]

3D立体の主調色：

Wolfram Language code: DominantColors[\!\(\*Graphics3DBox[«10»]\)]

スコープ  (12)

基本的な用法  (4)

画像中の主調色を求める：

Wolfram Language code: DominantColors[[image]]

主調色を5色まで計算する：

Wolfram Language code: DominantColors[[image], 5]

各主調色についてさまざまな特性を計算する：

Wolfram Language code: DominantColors[[image], 5, {"Color", "Coverage"}]

画像のリストの主調色を計算する：

Wolfram Language code: DominantColors[{[image], [image], [image]}]

特性  (6)

デフォルトで，主調色はRGBカラーで返される：

Wolfram Language code: DominantColors[[image], 4, "Color"]//InputForm

CIELAB色空間で表された主調色：

Wolfram Language code: DominantColors[[image], 4, "LABColor"]//InputForm

主調色を16進表現で返す：

Wolfram Language code: DominantColors[[image], 4, "HexRGBColor"]

各主調色に最も近いHTMLカラー名を求める：

Wolfram Language code: DominantColors[[image], 4, "NearestHTMLColor"]

各主調色で被覆された画素数を計算する：

Wolfram Language code: DominantColors[[image], 4, {"Color", "Count"}]

被覆率と被覆マスクを返す：

Wolfram Language code: DominantColors[[image], 4, {"Color", "Coverage", "CoverageImage"}]

フォーマット  (2)

異なる出力形式を指定する：

Wolfram Language code: DominantColors[[image], 3, {"NearestHTMLColor", "Coverage", "CoverageImage"}, "Dataset"]

特性値の連想を返す：

Wolfram Language code: DominantColors[[image], Automatic, {"Color", "Coverage"}, "PropertyAssociation"]

オプション  (8)

ColorCoverage  (1)

デフォルトで，ColorCoverageには自動閾値が使われる：

Wolfram Language code: i = [image];
Wolfram Language code: DominantColors[i]

被覆に関係なく，すべての色を返す：

Wolfram Language code: DominantColors[i, ColorCoverage -> 0]

指定された最小被覆にどの色も達していない場合は，空リストが返される：

Wolfram Language code: DominantColors[i, ColorCoverage -> .5]

色被覆のための範囲を指定する：

Wolfram Language code: DominantColors[i, ColorCoverage -> {0, .05}]

DistanceFunction  (1)

デフォルトで，色クラスタの混合に"CIE76"色距離が使われる：

Wolfram Language code: i = [image];
Wolfram Language code: DominantColors[i, MinColorDistance -> .4]

別の色距離を使う：

Wolfram Language code: DominantColors[i, MinColorDistance -> .4, DistanceFunction -> "CIE2000"]

CIELAB色間のカスタムの色関数を指定する：

Wolfram Language code: DominantColors[i, MinColorDistance -> .4, DistanceFunction -> (Norm[#1 - #2, 1]&)]

Masking  (2)

デフォルトで，画像全体の主調色が返される：

Wolfram Language code: i = [image];
Wolfram Language code: DominantColors[i]

これはMasking->Allと設定することに等しい：

Wolfram Language code: DominantColors[i, Masking -> All]

画像前面の主調色を計算する：

Wolfram Language code: mask = ColorNegate@RegionBinarize[i, {{1, 1}}, .1]
Wolfram Language code: DominantColors[i, Masking -> mask]

Masking->Allのとき，"Coverage"と"MaskCoverage"は等しい：

Wolfram Language code: i = [image];
Wolfram Language code: DominantColors[i, 3, {"Color", "Coverage", "MaskCoverage"}, Masking -> All]

指定されたマスクを使うと，"MaskCoverage"は各クラスタで覆われたマスクの割合を返す：

Wolfram Language code: mask = [image];
Wolfram Language code: DominantColors[i, 3, {"Color", "Coverage", "MaskCoverage"}, Masking -> mask]

Method  (2)

デフォルトで，DominantColorsは色のクラスタを生成する方法を自動的に選ぶ：

Wolfram Language code: i = [image];
Wolfram Language code: DominantColors[i]

Methodオプションを使って特定のメソッドを選択する：

Wolfram Language code: DominantColors[i, Method -> "Octree"]

さまざまなメソッドの所要時間と結果を比較する：

Wolfram Language code: Table[Prepend[AbsoluteTiming@DominantColors[[image], Method -> m], m], {m, {"KMeans", "KMedoids", "MedianCut", "MinVariance", "Octree"}}]//TextGrid

MinColorDistance  (2)

デフォルトで，最小色距離が自動的に選ばれる：

Wolfram Language code: image = [image]; DominantColors[image, 15]

MinColorDistance->d では，d より近い色見本は融合される：

Wolfram Language code: DominantColors[image, 15, MinColorDistance -> .5]

MinColorDistance->0を使って色の融合を避ける：

Wolfram Language code: DominantColors[image, 15, MinColorDistance -> 0]

MinColorDistance->0ですべての主調色を計算して色の融合を避ける：

Wolfram Language code: image = [image];
Wolfram Language code: colors = DominantColors[image, 15, {"Color", "Coverage"}, MinColorDistance -> 0]

カスタム関数を使って似ている色を削除する：

Wolfram Language code: DeleteDuplicates[colors, ColorDistance[#1[[1]], #2[[1]]] < .5&]

アプリケーション  (4)

旗の色を抽出する：

Wolfram Language code: DominantColors[[image]]

画像をその主調色の領域に分割する：

Wolfram Language code: i = [image];
Wolfram Language code: res = DominantColors[i, Automatic, {"CoverageImage", "Color"}]
Wolfram Language code: ImageMultiply@@@res

画像の量子化されたバージョンを作る：

Wolfram Language code: img = [image];
Wolfram Language code: ImageAdd@@ImageMultiply@@@DominantColors[img, Automatic, {"CoverageImage", "Color"}, ColorCoverage -> 0]

融合を避けて詳細をさらに加える：

Wolfram Language code: ImageAdd@@ImageMultiply@@@DominantColors[img, Automatic, {"CoverageImage", "Color"}, ColorCoverage -> 0, MinColorDistance -> 0]

色の異なるセルごとに分ける：

Wolfram Language code: DominantColors[[image], 5, {"Color", "Coverage", "CoverageImage"}, "Dataset", MinColorDistance -> .5]

特性と関係  (4)

主調色は被覆面積に基づいてソートされる：

Wolfram Language code: DominantColors[[image]]

主調色の計算の際には，アルファチャンネルが考慮される：

Wolfram Language code: DominantColors[[image]]

ある程度透過性がある画像を背景とブレンドして，画像の外観に似た結果を得る：

Wolfram Language code: DominantColors[RemoveAlphaChannel[[image], White]]

ColorQuantizeは画像中に使われている色調で画像を表す：

Wolfram Language code: i = [image]; ColorQuantize[i, 3, Dithering -> False]

DominantColorsによって生成された色：

Wolfram Language code: col = DominantColors[i, 3]

画素をRGB色空間内の最も近いよく使われる色で置換する：

Wolfram Language code: nf = Nearest[List@@@col]; ImageApply[First@nf[#, 1]&, i]

CIELAB色空間で色の置換を行う：

Wolfram Language code: nf = Nearest[List@@@DominantColors[i, 3, "LABColor"]]; ImageApply[First@nf[#, 1]&, ColorConvert[i, "LAB"]]

任意の主調色について計算可能なサポートされている特性のリスト：

Wolfram Language code: DominantColors[[image], 8, "Properties"]

おもしろい例題  (1)

ArrayPlotを使って，1つのプロットの中に色とその相対的な頻度を示す：

Wolfram Language code: DominantColors[[image], Automatic, {"Color", "Count"}]
Wolfram Language code: ArrayPlot[Transpose[%]]
Wolfram Research (2012), DominantColors, Wolfram言語関数， https://reference.wolfram.com/language/ref/DominantColors.html （2019年に更新）.

テキスト

Wolfram Research (2012), DominantColors, Wolfram言語関数， https://reference.wolfram.com/language/ref/DominantColors.html （2019年に更新）.

CMS

Wolfram Language. 2012. "DominantColors." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2019. https://reference.wolfram.com/language/ref/DominantColors.html.

APA

Wolfram Language. (2012). DominantColors. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/DominantColors.html

BibTeX

@misc{reference.wolfram_2026_dominantcolors, author="Wolfram Research", title="{DominantColors}", year="2019", howpublished="\url{https://reference.wolfram.com/language/ref/DominantColors.html}", note=[Accessed: 08-September-2026]}

BibLaTeX

@online{reference.wolfram_2026_dominantcolors, organization={Wolfram Research}, title={DominantColors}, year={2019}, url={https://reference.wolfram.com/language/ref/DominantColors.html}, note=[Accessed: 08-September-2026]}