WOLFRAM

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

ColorBalance[image]

無色照明の効果を模すようなバランスを得るために，image 中の色を調整する．

ColorBalance[image,ref]

ref で指定された基準色が白にマップされるように image 中の色を調整する．

ColorBalance[image,reftarget]

基準色 ref を target にマップする．

詳細とオプション
Details and Options Details and Options
例題  
例  
スコープ  
オプション  
Method  
アプリケーション  
水中画像  
1日のうちの時間  
黄ばみを取る  
特性と関係  
考えられる問題  
インタラクティブな例題  
関連項目
関連するガイド
履歴
引用書式

ColorBalance

ColorBalance[image]

無色照明の効果を模すようなバランスを得るために，image 中の色を調整する．

ColorBalance[image,ref]

ref で指定された基準色が白にマップされるように image 中の色を調整する．

ColorBalance[image,reftarget]

基準色 ref を target にマップする．

詳細とオプション

  • ColorBalanceは，非現実的なカラーキャストを画像から除いた白または灰色の平衡によく使われる．これは，結果としてオブジェクトを灰色の無彩色で表すことが多い．
  • ColorBalanceは明示的な色空間がある画像に使うことができる．ColorSpace->Automaticの画像は調整前に"RGB"または"Grayscale"に変換される．
  • ref あるいは target のいずれかは，以下の任意のものでよい．
  • color明示的な色
    whitepointWhitePointの設定で使われるような名前付きの白色点
    temperature温度で指定された色
    {temperature,tint}温度と色合いで指定された色
    {pos1,pos2,…}もとの画像中の位置 posiの画素の平均色
    markerimageマーカー画像に従ってサンプルされた画素の平均色
  • 画素の平均色はLab色空間で計算される．
  • temperature はケルビン単位の値として指定することができる．よく使われる値は2000Kから20,000Kの範囲である．tint は 単位で与えることができる．よく使われる値はからの範囲である．
  • 温度と色合いは，以下に示すMacAdam色度図で可視化することができる．曲線は放射黒体に相当し，色合い調整は，温度曲線に直交する等温線からの動きである．
  • ColorBalanceはMethodオプションを取る．次は可能な設定である．
  • "GrayScaling"画像の平均をスケーリングする
    "RGBScaling"RGB空間でスケーリングする
    "LMSScaling"LMS空間でスケーリングする
    "ChromaticityScaling"LMS空間内の色度のスケーリング
  • メソッド"LMSScaling"では，XYZとLMSの変換を行うBradford変換行列を使ってスケーリングが行われる．
  • {temperature,tint}ペアが与えられると，常にMethod"ChromaticityScaling"が使われる．その他の場合はMethod->"LMSScaling"が使われる． »

例題

すべて開く すべて閉じる

例  (1)

自動のホワイトバランスでブルーキャストを修正する：

Wolfram Language code: ColorBalance[[image]]

スコープ  (8)

特定の色を使って白基準を指定する：

Wolfram Language code: ColorBalance[[image], RGBColor[0.5, 1., 0.5]]

画素位置のリストを使って白領域を指定する：

Wolfram Language code: ColorBalance[[image], {{22, 9}, {136, 27}, {139, 11}}]

マーカー画像を使って白領域を指定する：

Wolfram Language code: ColorBalance[[image], [image]]

基準の白色温度を指定する：

Wolfram Language code: ColorBalance[[image], Quantity[4200, "Kelvins"]]

基準の白色温度と色合いを指定する：

Wolfram Language code: ColorBalance[[image], {Quantity[4200, "Kelvins"], .02}]

基準色とターゲット色を指定する：

Wolfram Language code: ColorBalance[[image], RGBColor[1., 0.85, 0.85] -> GrayLevel[1]]

基準と目標のWhitePointを指定することで色順応を行う：

Wolfram Language code: ColorBalance[[image], "D50" -> "F6"]

基準色とターゲットのWhitePointを指定することで色順応を行う：

Wolfram Language code: ColorBalance[[image], RGBColor[1., 0.85, 0.85] -> "D50"]

オプション  (6)

Method  (6)

Method->"RGBScaling"を使ってRGB色空間内で画像を再スケールする：

Wolfram Language code: ColorBalance[[image], Method -> "RGBScaling"]

強いカラーキャストが存在する場合は，RGB空間内で画素をスケーリングしてもカラーキャストが直らないことがある：

Wolfram Language code: image = [image];
Wolfram Language code: ColorBalance[image, Method -> "RGBScaling"]

Method->"LMSScaling"を使ってLMS空間で画素をスケールする：

Wolfram Language code: ColorBalance[image, Method -> "LMSScaling"]

Method->"ChromaticityScaling"を使って平均色を中立（濃淡レベル）にする：

Wolfram Language code: ColorBalance[image, Method -> "ChromaticityScaling"]

基準色あるいはターゲット色なしに"RGBScaling"を使う：

Wolfram Language code: i = [image];
Wolfram Language code: ColorBalance[i, Method -> "RGBScaling"]

これは，各チャンネルについて色の最大値を1に変換することに相当する：

Wolfram Language code: % == ImageMultiply[i, 1 / ImageMeasurements[i, "Max"]]

"ChromaticityScaling"は，よりバランスのとれた画像を作ることが多い：

Wolfram Language code: image = [image];

これは計算的により高価であるので注意が必要である：

Wolfram Language code: Table[Prepend[AbsoluteTiming[ColorBalance[image, Method -> m]], m], {m, {"RGBScaling", "LMSScaling", "ChromaticityScaling"}}]//Transpose//Grid

色が温度と色合いによって指定されている場合は，Method->"ChromaticityScaling"が使われる：

Wolfram Language code: image = ImageResize[ExampleData[{"TestImage", "Peppers"}], 100];
Wolfram Language code: ColorBalance[image, Quantity[3800, "Kelvins"], Method -> #]& /@ {Automatic, "RGBScaling", "ChromaticityScaling"}
Wolfram Language code: SameQ[%]

基準色あるいはターゲット色がない場合，使用可能なメソッドが画像についての仮定をする：

Wolfram Language code: image = [image];
Wolfram Language code: ImageMeasurements[image, "Max"]

"RGBScaling"および"LMSScaling"は画像が白色オブジェクトを含んでいると仮定する：

Wolfram Language code: ColorBalance[image, Method -> #]& /@ {"RGBScaling", "LMSScaling"}
Wolfram Language code: ImageMeasurements[#, "Max"]& /@ %

"ChromaticityScaling"は平均色が中立つまり灰色であると仮定する：

Wolfram Language code: ImageMeasurements[image, "Mean"]
Wolfram Language code: ColorBalance[image, Method -> "ChromaticityScaling"]
Wolfram Language code: ImageMeasurements[%, "Mean"]

アプリケーション  (4)

水中画像  (2)

画像には若干の白があると仮定して，強い青を修正する：

Wolfram Language code: ColorBalance[[image], Method -> "LMSScaling"]

すでに白の画素がある場合，Method"LMSScaling"はほとんどあるいはまったく効果がない：

Wolfram Language code: i = [image];
Wolfram Language code: ImageDifference[ColorBalance[i, Method -> "LMSScaling"], i]

中立の平均色というデフォルトの仮定では，極端な結果になることがある：

Wolfram Language code: ColorBalance[i]

平均色が計算される領域を手動で指定する：

Wolfram Language code: ColorBalance[i, Binarize[i, {.5, 1}]]

1日のうちの時間  (1)

同じ場面が照明によって変わって見える：

Wolfram Language code: i = [image];

温度を低くして日の出のシミュレーションを行う：

Wolfram Language code: ColorBalance[i, Automatic -> Quantity[4000, "Kelvins"]]

5500Kが典型的な垂直の日光の温度である：

Wolfram Language code: ColorBalance[i, Automatic -> Quantity[5500, "Kelvins"]]

より高い温度でもやのかかった空のシミュレーションを行う：

Wolfram Language code: ColorBalance[i, Automatic -> Quantity[7000, "Kelvins"]]

黄ばみを取る  (1)

ドキュメントの経年による黄ばみを修正する：

Wolfram Language code: ColorBalance[[image]]

特性と関係  (2)

画像の画素が暗い場合，ImageAdjustは"RGBscaling"メソッドと同じような結果を与える：

Wolfram Language code: reddish = [image]; ImageAdjust[reddish] == ColorBalance[reddish, Method -> "RGBScaling"]

ColorBalanceが行う色のマッピングは，通常は可逆ではない：

Wolfram Language code: i = [image];
Wolfram Language code: ColorBalance[ColorBalance[i, "D50" -> "D65"], "D65" -> "D50"]
Wolfram Language code: % == i

考えられる問題  (1)

複数の光源による照明がある場面のバランスを取ると問題が起ることがある．

これらの場面は夕闇における太陽の反射光と街灯からの白熱灯の光で照らされている：

Wolfram Language code: i = [image];

街灯を基準としてバランスを取る：

Wolfram Language code: houses = FillingTransform@Binarize[ColorDistance[i, Blue], 1.2]
Wolfram Language code: ColorBalance[i, houses -> Quantity[3000, "Kelvins"]]

空と太陽の反射を使ってバランスを取ったものと比較する：

Wolfram Language code: ColorBalance[i, ColorNegate@houses -> Quantity[8000, "Kelvins"]]

インタラクティブな例題  (1)

基準白色を指定するためにマウスクリックを使って色温度を動的に調整する：

Wolfram Language code: With[{image = [image]}, DynamicModule[{i = image}, ClickPane[Dynamic@i, Function[pos, i = ColorBalance[image, {pos}, Method -> "ChromaticityScaling"]]] ]]
Wolfram Research (2015), ColorBalance, Wolfram言語関数， https://reference.wolfram.com/language/ref/ColorBalance.html.

テキスト

Wolfram Research (2015), ColorBalance, Wolfram言語関数， https://reference.wolfram.com/language/ref/ColorBalance.html.

CMS

Wolfram Language. 2015. "ColorBalance." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/ColorBalance.html.

APA

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

BibTeX

@misc{reference.wolfram_2026_colorbalance, author="Wolfram Research", title="{ColorBalance}", year="2015", howpublished="\url{https://reference.wolfram.com/language/ref/ColorBalance.html}", note=[Accessed: 11-August-2026]}

BibLaTeX

@online{reference.wolfram_2026_colorbalance, organization={Wolfram Research}, title={ColorBalance}, year={2015}, url={https://reference.wolfram.com/language/ref/ColorBalance.html}, note=[Accessed: 11-August-2026]}