Main Content

このページの翻訳は最新ではありません。ここをクリックして、英語の最新版を参照してください。

imcontrast

コントラスト調整ツール

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

構文

imcontrast
imcontrast(h)
hTool = imcontrast(___)

説明

関数 imcontrast を使用して、コントラスト調整ツールを作成します。コントラスト調整ツールを使用すると、表示されたグレースケール イメージのコントラストと明度を対話的に調整することができます。ツールの使用方法の詳細については、ヒントを参照してください。

Adjust Contrast tool with sliders and editable fields that enable you to adjust the histogram of pixel values.

メモ

コントラスト調整ツールは、イメージを表示するために使用されるピクセルの値を調整しますが、実際のイメージ データは変更されません。イメージ データを変更するには、関数 imadjust を使用します。

例

imcontrast は、コントラスト調整ツールを別の Figure に作成し、現在の Figure 内のグレースケール イメージと関連付けます。

例

imcontrast(h) は、グラフィックス コンテナー h 内のイメージに関連付けられたコントラスト調整ツールを作成します。

hTool = imcontrast(___) は、コントラスト調整ツールを含む Figure hTool を返します。

例

すべて折りたたむ

イメージを表示して、そのイメージのコントラストを調整します。

imshow("pout.tif")
imcontrast

イメージをワークスペースに読み取って、Figure のハンドルを h1 として定義します。2 つ目の Figure ウィンドウを開き、その Figure のハンドルを h2 として定義します。imcontrast の呼び出しで h1 を指定して最初の Figure のコントラストを調整します。

h1 = figure;
imshow("pout.tif")
h2 = figure;
imshow("coins.png")
imcontrast(h1)

入力引数

すべて折りたたむ

イメージを含むグラフィックス オブジェクト。Figure オブジェクト、Panel オブジェクト、Axes オブジェクト、または Image オブジェクトとして指定します。h が Axes または Figure の場合、imcontrast は、findobj(h,Type="image") が返した最初のイメージを使用します。

出力引数

すべて折りたたむ

コントラスト調整ツール。Figure オブジェクトとして返されます。

ヒント

コントラスト調整ツールは、ピクセル値がスケーリングされたヒストグラムを表します (過剰なピクセル値は、明確にするために切り捨てられます)。ヒストグラム表示の左側の赤いバーをドラッグすると、最小値が変わります。最小値および最小値より小さな任意のピクセル値は、黒で表示されます。ヒストグラムの右側の赤いバーをドラッグすると、最大値が変わります。最大値および最大値より大きい任意の値は、白で表示されます。赤いバーの間の値は、薄いグレーで表示されます。

最小値と最大値は共に "ウィンドウ" を作成します。ウィンドウを拡大すると、コントラストが低くなります。ウィンドウを縮小すると、コントラストが高くなります。ウィンドウの中心を変更すると、イメージの明度が変わります。ウィンドウの最小値、最大値、幅、中心値は、手動で入力できます。いずれかの値を変更すると、他の値とイメージが自動的に更新されます。

  • ターゲット イメージ内でマウスをクリック アンド ドラッグすると、ウィンドウの値が対話形式で変更されます。マウスを左から右に横方向にドラッグすると、ウィンドウの幅が変わります。マウスを上下に縦方向にドラッグすると、ウィンドウの中心が変わります。マウスをクリック アンド ドラッグする前に Ctrl キーを押すと、変化の速度が速くなります。マウスをクリック アンド ドラッグする前に Shift キーを押すと、変化の速度が遅くなります。キーは、クリック アンド ドラッグする前に押さなければなりません。

  • ツールを使用すると、imcontrast は、座標軸の CLim プロパティを変更して、表示されたイメージのコントラストを調整します。ターゲット イメージの実際のピクセル値を変更するには、[データの調整] ボタンをクリックします このボタンは、イメージのコントラストを変更するまで使用できません。

  • コントラスト調整ツールは、クラスが double および single でデータ範囲が既定の表示範囲 [0, 1] を超えるグレースケール イメージを処理できます。これらのイメージに対し、imcontrast は、ヒストグラムの範囲を設定し、上限と下限をパディングしてイメージ データ範囲と一致させます。

バージョン履歴

R2006a より前に導入

参考

| |

トピック