このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。

displayColorPatch

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

構文

displayColorPatch(colorTable)

displayColorPatch(colorTable,Name,Value)

説明

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

displayColorPatch(colorTable,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)

入力引数

colorTable — カラー値

カラー テーブル

各カラー パッチに含まれるカラー値。m 行 8 列のカラー テーブルとして指定します。m はパッチの数です。8 つの列は、以下の変数を表します。

変数	説明
ROI	サンプリングされた ROI のインデックス。ROI の値は範囲 [1, 16] の整数です。インデックスは、displayChart で表示された ROI 番号と一致します。
Measured_R	ROI 内の赤のチャネル ピクセルの平均値。Measured_R は、chart.Image と同じデータ型のスカラーであり、型は、single、double、uint8、または uint16 のいずれかです。
Measured_G	ROI 内の緑のチャネル ピクセルの平均値。Measured_G は、chart.Image と同じデータ型のスカラーです。
Measured_B	ROI 内の青のチャネル ピクセルの平均値。Measured_B は、chart.Image と同じデータ型のスカラーです。
Reference_L	ROI の Reference L* の値。Reference_L は double 型のスカラーです。
Reference_a	ROI の Reference a* の値。Reference_a は double 型のスカラーです。
Reference_b	ROI の Reference b* の値。Reference_b は double 型のスカラーです。
Delta_E	CIE 1976 で記述されている、L*a*b* 色空間における測定色と基準色との間の色のユークリッド距離。Delta_E は double 型のスカラーです。

名前と値の引数

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

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

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

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

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

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

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

displayDeltaE — 色の誤差値の表示

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

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

Parent — 表示されたイメージ オブジェクトの axes ハンドル

axes のハンドル

表示されたイメージ オブジェクトの axes ハンドル。axes ハンドルとして指定します。Parent は displayColorPatch が作成したイメージ オブジェクトの親を指定します。

ヒント

• esfrChart または colorChecker オブジェクトから正しい形式のカラー テーブルを取得するには、関数 measureColor を使用します。任意の数のカラー ROI の測定色および基準色を含む独自のカラー テーブルを作成することもできます。

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

バージョン履歴

R2017b で導入

参考

関数

• measureColor | plotChromaticity | displayChart

オブジェクト

• esfrChart | colorChecker

トピック

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