displayColorPatch

測定色と基準色をカラー パッチとして表示

構文

displayColorPatch(colorValues)

displayColorPatch(colorValues,Name,Value)

説明

displayColorPatch(colorValues) は、テスト チャートにカラー パッチ関心領域 (ROI) の測定色と基準色である colorValues を表示します。この関数は、対応する基準色の太い境界で囲まれた正方形で測定色の値を表示します。

displayColorPatch(colorValues,Name,Value) は、測定色の値を、ディスプレイの特性を制御する名前と値の引数を追加して表示します。

例

ColorChecker チャートからカラー パッチ ダイアグラムを表示

ColorChecker® チャートのイメージをワークスペースに読み取ります。

I = imread("colorCheckerTestImage.jpg");

colorChecker オブジェクトを作成し、ROI 注釈を含むチャートを表示します。

chart = colorChecker(I);
displayChart(chart,"displayRegistrationPoints",false)

各カラー パッチ ROI で色を測定します。

colorTable = measureColor(chart);

カラー パッチ ダイアグラムに、測定色および基準色と、色の誤差 ($\Delta \mathrm{E}$) を表示します。

displayColorPatch(colorTable)

色精度測定値からカラー パッチ ダイアグラムを表示

この例は、Imatest® eSFR チャートの色精度の測定値からカラー パッチ ダイアグラムを表示する方法を示します。

eSFR チャートのイメージをワークスペースに読み取ります。

I = imread("eSFRTestImage.jpg");

esfrChart オブジェクトを作成します。チャートを表示し、16 個のカラー パッチを強調表示します。

chart = esfrChart(I);
displayChart(chart,displayEdgeROIs=false, ...
    displayGrayROIs=false,displayRegistrationPoints=false)

すべてのカラー パッチ ROI で色を測定します。

colorTable = measureColor(chart);

ROI インデックス オーバーレイなしで色精度測定値を表示します。各正方形のカラー パッチは測定色であり、周囲の太い境界線はその ROI の基準色です。色精度測定値は、Delta_E として表示されます。これは、CIE 1976 L*a*b* 色空間における測定色と基準色との間のユークリッド距離です。精度の高い色ほど、Delta_E が小さくなります。

displayColorPatch(colorTable,displayROIIndex=false)

入力引数

colorValues — カラー値

table

各カラー パッチに含まれるカラー値。n 行の table として指定します。n はカラー ROI の数です。カラー値の table を取得するには、関数 measureColor を使用します。

名前と値の引数

オプションの引数のペアを Name1=Value1,...,NameN=ValueN として指定します。ここで、Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後に指定しなければなりませんが、ペアの順序は重要ではありません。

例: displayColorPatch(colorValues,displayROIIndex=false) は、ROI インデックスの表示をオフにします。

R2021a より前では、コンマを使用して名前と値をそれぞれ区切り、Name を引用符で囲みます。

例: displayColorPatch(colorValues,"displayROIIndex",false) は、ROI インデックスの表示をオフにします。

displayROIIndex — ROI インデックス ラベルの表示

true または 1 (既定値) | false または 0

ROI インデックス ラベルの表示。数値または logical の 1 (true) か 0 (false) として指定します。displayROIIndex が true の場合、displayColorPatch は表示されたカラー パッチ上にカラー ROI のインデックス ラベルを重ね合わせます。

displayDeltaE — 色の誤差値の表示

true または 1 (既定値) | false または 0

色の誤差 ("デルタ E") 値の表示。数値または logical の 1 (true) か 0 (false) として指定します。displayDeltaE が true の場合、displayColorPatch は表示されたカラー パッチ上に色の誤差値を重ね合わせます。

Parent — 表示された image オブジェクトの親

Axes オブジェクト

表示された image オブジェクトの親。Axes オブジェクトとして指定します。

ヒント

• colorChecker オブジェクトから測定した色の基準 L*a*b* 値は、ColorChecker^® チャートの "After November 2014" バージョン用です。基準値の白色点は CIE 標準光源 D50 です。

バージョン履歴

R2017b で導入

参考

関数

• measureColor | plotChromaticity | displayChart

オブジェクト

• esfrChart | colorChecker

トピック

• 色補正行列を使用した色補正