ドキュメンテーション

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

stretchlim

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

構文

  • Low_High = stretchlim(I)
  • Low_High = stretchlim(I,Tol)
  • Low_High = stretchlim(RGB,Tol)
  • Low_High = stretchlim(gpuarrayI,___)

説明

Low_High = stretchlim(I)Low_High を返します。これは、コントラスト ストレッチ イメージ I に使用可能な下限と上限を指定するピクセル値の 2 つの要素ベクトルです。既定の設定で、Low_High の値は、すべてのピクセル値の下 1% と上 1% を指定します。返された濃淡値は関数 imadjust によって使用でき、イメージのコントラストを増加させます。

Low_High = stretchlim(I,Tol)Low_High を返します。これは、コントラスト ストレッチ イメージ I で使用可能な下限と上限を指定するピクセル値の 2 要素ベクトルです。ここで、Tol は、低ピクセル値と高ピクセル値で飽和するイメージの割合を指定します。

Low_High = stretchlim(RGB,Tol)Low_High を返します。これは、コントラスト ストレッチ トゥルーカラー イメージ RGB で使用可能な下限と上限を指定するピクセル値の 2 要素ベクトルです。

Low_High = stretchlim(gpuarrayI,___) は GPU で演算を実行します。.この構文では Parallel Computing Toolbox™ が必要です。

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

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

すべて折りたたむ

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

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

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

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

グレースケール イメージを読み取り、gpuArray を作成します。

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

範囲を設定する stretchlim を使用してイメージのコントラストを調整します。結果を表示します。

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

入力引数

すべて折りたたむ

グレースケール イメージ。実数、非スパースの数値配列として指定します。

例: I = imread(‘pout.tif’); lohi = stretchlim(I);

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

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

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

例: lohi = stretchlim(I,[.02 .80]);

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

トゥルーカラー イメージ。数値配列として指定します。

例: RGB = imread(‘peppers.png’); lohi = stretchlim(RGB);

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

入力イメージ。gpuArray として指定します。

出力引数

すべて折りたたむ

コントラスト ストレッチの下限と上限。ピクセル値の 2 要素ベクトルとして返されます。

詳細

すべて折りたたむ

コード生成

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

MATLAB Function ブロック

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

R2006a より前に導入

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