stretchlim

コントラスト ストレッチ イメージの範囲の確認

ページ内をすべて折りたたむ

構文

lowhigh = stretchlim(I)
lowhigh = stretchlim(I,Tol)

説明

lowhigh = stretchlim(I) は、グレースケール イメージまたは RGB イメージ I のコントラスト ストレッチに使用可能な下限と上限を計算します。この範囲は、lowhigh に返されます。既定の設定で、範囲は、すべてのピクセル値の下位 1% と上位 1% を指定します。

imadjust 関数を使用すると、範囲 lowhigh に応じてイメージ I のコントラストを調整できます。

例

lowhigh = stretchlim(I,Tol) は、低いピクセル値と高いピクセル値で飽和するイメージの割合 Tol を指定します。

例

すべて折りたたむ

ライブ スクリプトを開く

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

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

Figure contains an axes object. The hidden axes object contains an object of type image.

範囲を設定する stretchlim を使用してイメージのコントラストを調整し、結果を表示します。この例では、上側 1%、下側 1% で飽和する既定の範囲 [0.01 0.99] を使用します。

J = imadjust(I,stretchlim(I),[]);
figure
imshow(J)

Figure contains an axes object. The hidden axes object contains an object of type image.

入力引数

すべて折りたたむ

コントラスト ストレッチが行われるイメージ。2 次元グレースケール イメージまたは 2 次元 RGB イメージとして指定します。

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

飽和するイメージの割合。[0, 1] を範囲とする数値スカラーまたは 2 要素ベクトル [Low_Fract High_Fract] として指定します。

値説明
スカラーTol がスカラーの場合、Low_Fract = Tol および High_Fract = 1 - Low_Fract となり、低ピクセル値と高ピクセル値において同じ割合で飽和します。
0Tol = 0 の場合は、lowhigh = [min(I(:)); max(I(:))] となります。
既定の設定引数 Tol を省略すると、[Low_Fract High_Fract] は既定の [0.01 0.99] (飽和 2%) を使用します。
過大低ピクセル値と高ピクセル値を飽和した後にピクセルが残らなくなるほど、Tol が大きすぎる場合、stretchlim は [0 1] を返します。

例: [.02 .80]

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

出力引数

すべて折りたたむ

コントラスト ストレッチの下限と上限。次のいずれかとして返されます。

  • I がグレースケール イメージの場合、2 要素数値ベクトル。

  • I が RGB イメージの場合、2 行 3 列の数値行列。列が 3 つのカラー チャネルそれぞれの上限と下限を示します。

データ型: double

拡張機能

すべて展開する

GPU コード生成
GPU Coder™ を使用して NVIDIA® GPU のための CUDA® コードを生成します。

バージョン履歴

R2006a より前に導入

参考

| | |