ドキュメンテーション

最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

imadjust

イメージの強度値またはカラーマップの調整

構文

J = imadjust(I)
J = imadjust(I,[low_in; high_in],[low_out; high_out])
J = imadjust(I,[low_in; high_in],[low_out; high_out],gamma)
newmap = imadjust(map,[low_in; high_in],[low_out; high_out],gamma)
RGB2 = imadjust(RGB1,___)
gpuarrayB = imadjust(gpuarrayA,___)

説明

J = imadjust(I) は、I の低い強度と高い強度でデータの 1% が飽和するように、グレースケール イメージ I の強度値を J の新しい値にマップします。これにより、出力イメージ J のコントラストが高くなります。この構文は、imadjust(I,stretchlim(I)) と等価です。

J = imadjust(I,[low_in; high_in],[low_out; high_out]) は、low_inhigh_in の間の値が low_outhigh_out の間の値にマップされるように、I の値を J の新しい値にマップします。

    メモ:   high_outlow_out より小さい場合、imadjust は写真のネガのように出力イメージを反転します。

J = imadjust(I,[low_in; high_in],[low_out; high_out],gamma)I の値を J の新しい値にマップし、gammaIJ の間の関係を記述する曲線の形状を指定できます。

newmap = imadjust(map,[low_in; high_in],[low_out; high_out],gamma) はインデックス付きイメージに関連付けられた m 行 3 列の配列のカラーマップを変換します。low_inhigh_inlow_out および high_out は 1 行 3 列のベクトルでなければなりません。gamma は、チャネルごとに固有のガンマ値を指定する 1 行 3 列のベクトルか、3 つすべてのチャネルに使用する値を指定するスカラーにすることができます。再スケーリングされた newmap は、map と同じサイズになります。

RGB2 = imadjust(RGB1,___) は、RGB イメージ RGB1 の各平面 (赤、緑、青) の調整を行います。low_inhigh_inlow_outhigh_out および gamma がスカラーの場合、imadjust はイメージの赤、緑および青の成分に同じマッピングを適用します。イメージの色成分ごとに固有のマッピングを指定するには、low_inhigh_inlow_outhigh_out および gamma に 1 行 3 列のベクトルを指定します。

gpuarrayB = imadjust(gpuarrayA,___) は GPU でコントラスト調整を実行します。入力 gpuArray である gpuarrayA は強度イメージ、RGB イメージまたはカラーマップです。出力 gpuArray である gpuarrayB は入力イメージと同じです。この構文では Parallel Computing Toolbox™ が必要です。

コード生成 サポート: あり。

MATLAB Function ブロック サポート: あり。

すべて折りたたむ

低コントラストのグレースケール イメージをワークスペースに読み取って表示します。

I = imread('pout.tif');
imshow(I);

イメージのコントラストを調整してデータが高強度と低強度で 1 % 飽和するようにし、それを表示します。

J = imadjust(I);
figure
imshow(J)

イメージを gpuArray に読み取り、その gpuArray を imadjust に渡します。

I = gpuArray(imread('pout.tif'));
figure
imshow(I)

J = imadjust(I); 
figure
imshow(J)

低コントラストのグレースケール イメージをワークスペースに読み取って表示します。

I = imread('pout.tif');
imshow(I);

コントラストの範囲を指定して、イメージのコントラストを調整します。

K = imadjust(I,[0.3 0.7],[]);
figure
imshow(K)

イメージを gpuArray に読み取り、その gpuArray を imadjust に渡します。

I = gpuArray(imread('pout.tif'));
figure
imshow(I)

K = imadjust(I,[0.3 0.7],[]);
figure
imshow(K)

RGB イメージをワークスペースに読み取って表示します。

RGB = imread('football.jpg');
imshow(RGB)

コントラストの範囲を指定して、RGB イメージのコントラストを調整します。

RGB2 = imadjust(RGB,[.2 .3 0; .6 .7 1],[]);
figure
imshow(RGB2)

RGB イメージを gpuArray に読み取り、その gpuArray を入力イメージのコントラスト範囲を指定して imadjust に渡します。

RGB = gpuArray(imread('football.jpg'));
RGB2 = imadjust(RGB,[.2 .3 0; .6 .7 1],[]);
figure
imshow(RGB)
figure
imshow(RGB2)

入力引数

すべて折りたたむ

調整されるイメージ。グレースケール イメージとして指定します。

データ型: single | double | int16 | uint8 | uint16 | uint32

入力イメージのコントラストの範囲。0 ~ 1 の範囲の値からなる 2 要素の数値ベクトルとして指定します。low_in より小さい値と high_in より大きい値はクリップされます。つまり、low_in より小さい値は low_out にマップされ、high_in より大きい値は high_out にマップされます。空行列 ([]) を指定すると、imadjust は既定の範囲 [0 1] を使用します。

入力イメージがカラーマップの場合は、1 行 3 列のベクトルでなければなりません。

データ型: single | double

出力イメージのコントラストの範囲。0 ~ 1 の範囲の値からなる 2 要素の数値ベクトルとして指定します。low_in より小さい値と high_in より大きい値はクリップされます。つまり、low_in より小さい値は low_out にマップされ、high_in より大きい値は high_out にマップされます。空行列 ([]) を指定すると、imadjust は既定の範囲 [0 1] を使用します。

データ型: single | double

入力値と出力値の関係を表す曲線の形状。数値として指定します。gamma が 1 より小さい場合、imadjust のマッピングでは高い (明るい) 出力値のほうに重みが加わります。gamma が 1 より大きい場合は、imadjust のマッピングでは低い (暗い) 出力値のほうに重みが加わります。引数を省略した場合、gamma は既定の 1 (線形マッピング) に指定されます。

データ型: double

調整されるカラーマップ。m 行 3 列の配列として指定します。

データ型: single | double | int16 | uint8 | uint16 | uint32

調整されるカラー イメージ。RGB イメージとして指定します。

データ型: single | double | int16 | uint8 | uint16 | uint32

GPU で調整されたイメージ。グレースケール イメージ、RGB イメージまたはカラーマップを含む gpuArray として指定します。

データ型: single | double | int16 | uint8 | uint16 | uint32

出力引数

すべて折りたたむ

調整されたイメージ。グレースケール イメージとして返されます。J は入力イメージと同じクラスです。

データ型: single | double | int16 | uint8 | uint16 | uint32

調整されたカラーマップ。入力カラーマップと同じクラスの m 行 3 列の配列として返されます。

データ型: single | double

調整されたカラー イメージ。RGB イメージとして返されます。RGB2 は入力イメージと同じクラスです。

データ型: single | double | int16 | uint8 | uint16 | uint32

GPU で調整されたイメージまたはカラーマップ。gpuArray として返されます。gpuArray にはグレースケール イメージ、RGB イメージまたはカラーマップが格納されます。

詳細

すべて折りたたむ

コード生成

この関数では MATLAB® Coder™ を使用した C コードの生成がサポートされています。汎用の MATLAB Host Computer ターゲット プラットフォームを選択した場合、プリコンパイルされたプラットフォーム固有の共有ライブラリを使用するコードが、この関数によって生成されます。共有ライブラリを使用するとパフォーマンスの最適化は維持されますが、コードを生成できるターゲット プラットフォームが限定されます。詳細は、「Image Processing Toolbox のコード生成について」を参照してください。

コードを生成する際、imadjust ではインデックス付きイメージがサポートされません。

MATLAB Function ブロック

この関数は Simulink の MATLAB Function ブロックで使用できます。

R2006a より前に導入

この情報は役に立ちましたか?