imsave

対話型ダイアログ ウィンドウを使用したイメージの保存

構文

imsave

imsave(h)

filename = imsave(___)

[filename,user_canceled] = imsave(___)

説明

関数 imsave を使用して、対話型のダイアログ ウィンドウでイメージを保存します。ファイル システムをナビゲートし、イメージ ファイルの保存場所を決定してファイル名を指定します。[ファイルの種類] メニューに表示されたイメージ ファイル形式から必要なグラフィックス ファイル形式を選択します。ツールの使用方法の詳細については、ヒントを参照してください。

imsave は、[イメージの保存] ダイアログ ウィンドウを使用して、現在の Figure 内のイメージを保存します。

imsave(h) は、[イメージの保存] ダイアログ ウィンドウを使用して、グラフィックス コンテナー h 内のイメージを保存します。現在の Figure 内に親が存在しないイメージを保存する場合に、この構文を使用します。

filename = imsave(___) は、ファイル filename の絶対パスを返します。

[filename,user_canceled] = imsave(___) は、保存操作をキャンセルしたかどうかを示します。

例

表示イメージの保存

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

I = imread('coins.png');
imshow(I)

イメージを処理します。この例では、背景が黒でコインが白のバイナリ マスクを作成します。

bw = imbinarize(I);
bw = imfill(bw,'holes');
imshow(bw,[])

イメージの保存ツールを使用して、バイナリ イメージをファイルに保存します。目的のディレクトリへ移動し、ファイル名とファイル形式を指定できます。この例では、イメージを myMaskImage というファイル名で、デスクトップに JPEG ファイル形式で保存します。

imsave

入力引数

h — イメージを含むグラフィックス オブジェクト

Figure オブジェクト | Panel オブジェクト | Axes オブジェクト | Image オブジェクト

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

出力引数

filename — ファイルの絶対パス

文字ベクトル | ''

ファイルへの絶対パス。文字ベクトルとして返されます。保存操作をキャンセルする場合、filename は空の文字配列 '' となります。

user_canceled — ユーザーのキャンセル操作

false (既定値) | true

ユーザーのキャンセル操作。false または true として返されます。[キャンセル] ボタンをクリックする、または保存ウィンドウを閉じると、imsave は user_canceled を true に設定します。それ以外の場合は、false に設定します。

ヒント

• イメージの保存ツールは、Figure の [ファイル] メニューの [名前を付けて保存] オプションとは異なり、Figure に表示されたイメージのみを保存します。Figure ウィンドウの [ファイル] メニューの [名前を付けて保存] オプションを指定すると、イメージだけでなく、Figure ウィンドウ全体が保存されます。

• imsave は imwrite で既定のオプションを使用してイメージを保存します。

• 既に使用されているファイル名を指定すると、imsave によって警告メッセージが表示されます。ファイル名をそのまま使用するには [はい] を選択し、ダイアログに戻って他のファイル名を選択するには [いいえ] を選択します。[はい] を選択すると、イメージの保存ツールはターゲット ファイルを上書きします。

• イメージの保存ツールは、イメージを保存または操作をキャンセルするまで MATLAB^® コマンド ラインをブロックします。

バージョン履歴

R2007b で導入

参考

imformats | imgetfile | imputfile | imwrite