saveas

特定のファイル形式への Figure の保存

構文

saveas(fig,filename)

saveas(fig,filename,formattype)

説明

saveas(fig,filename) は、fig で指定された Figure または Simulink^® ブロック線図をファイル filename に保存します。ファイル名は、たとえば 'myplot.jpg' のように、ファイル拡張子を含む文字ベクトルまたは string として指定します。ファイル拡張子はファイル形式を定義します。拡張子を指定しない場合、saveas は Figure を FIG ファイルに保存します。現在の Figure を保存するには、fig に gcf を指定します。

saveas(fig,filename,formattype) は、formattype で指定されたファイル形式でファイルを作成します。たとえば 'myplot' のように、ファイル名で拡張子を指定しない場合、ファイル名には指定された形式に対応する標準の拡張子が自動的に追加されます。ファイル拡張子を指定する場合、この拡張子をファイル形式に一致させる必要はありません。saveas は形式に formattype を使用しますが、指定された拡張子が付いた名前でファイルを保存します。したがって、ファイル拡張子が実際に使用されるファイル形式と一致しないこともあります。

例

Figure を PNG ファイルとして保存

棒グラフを作成して PNG ファイルとして保存します。

x = [2 4 7 2 4 5 2 5 1 4];
bar(x);
saveas(gcf,'Barchart.png')

Figure を EPS ファイルとして保存

棒グラフを作成して EPS ファイルとして保存します。カラーで保存するには 'epsc' ドライバーを指定します。

x = [2 4 7 2 4 5 2 5 1 4];
bar(x);
saveas(gcf,'Barchart','epsc')

saveas は、棒グラフを Barchart.eps として保存します。

Simulink ブロック線図を JPEG ファイルとして保存

'sldemo_tank' という名前の Simulink ブロック線図を JPEG ファイルとして保存します。get_param を使用して線図のハンドルを取得します。このコードを実行するには Simulink がインストールされていなければなりません。

openExample('sldemo_tank')
fig = get_param('sldemo_tank','Handle');
saveas(fig,'MySimulinkDiagram.jpg');

入力引数

fig — 保存する Figure

figure オブジェクト | Simulink ブロック線図

保存する Figure。figure オブジェクトまたは Simulink ブロック線図として指定します。座標軸などの他のタイプのグラフィックス オブジェクトを指定すると、saveas はそのオブジェクトの親 Figure を保存します。

例: saveas(gcf,'MyFigure.png')

Simulink ブロック線図を保存するには、get_param を使用してブロック線図のハンドルを取得します。たとえば、'sldemo_tank' という名前のブロック線図を保存します。

openExample('sldemo_tank')
saveas(get_param('sldemo_tank','Handle'),'MySimulinkDiagram.png');

filename — ファイル名

文字ベクトル | string

ファイル名。文字ベクトルまたは string として指定します。ファイル拡張子の指定はオプションです。

例: 'Bar Chart'

例: 'Bar Chart.png'

ファイル拡張子を指定した場合、saveas はこれに関連付けられた形式を使用します。ファイル拡張子に加えて formattype 入力引数も指定した場合、saveas はファイル形式として formattype を使用しますが、指定されたファイル名でファイルを保存します。したがって、ファイル拡張子が実際に使用されるファイル形式と一致しないこともあります。

ファイル形式に対応する任意の拡張子を指定できます。次の表に、一般的なファイル拡張子を示します。

拡張子	使用される形式
.fig	MATLAB® FIG ファイル (Simulink ブロック線図には使用不可)
.m	MATLAB FIG ファイルおよび Figure を開く MATLAB コード (Simulink ブロック線図には使用不可)
.jpg	JPEG イメージ
.png	Portable Network Graphics
.eps	EPS レベル 3 モノクロ
.pdf	Portable Document Format
.tif	TIFF イメージ、圧縮データ

データ型: char | string

formattype — ファイル形式

'fig' | 'm' | 'mfig' | イメージ ファイル形式 | ベクトル グラフィックス ファイル形式

ファイル形式。次のオプションのいずれかとして指定します。

• 'fig' — Figure を MATLAB Figure ファイルとして .fig 拡張子を付けて保存します。.fig 拡張子で保存された Figure を開くには、関数 openfig を使用します。この形式は Simulink ブロック線図では無効です。

• 'm' または 'mfig' — Figure を MATLAB Figure ファイルとして保存し、さらにこの Figure を開く MATLAB ファイルを作成します。Figure を開くには、MATLAB ファイルを実行します。このオプションは、Simulink ブロック線図では無効です。

• イメージ ファイル形式 — 形式をイメージ ファイル形式の表にあるイメージ オプションのいずれかに指定します。

• ベクトル グラフィックス ファイル形式 — 形式をベクトル グラフィックス形式の表にあるベクトル グラフィックス オプションのいずれかに指定します。

イメージ ファイル

イメージには Figure のピクセル ベースの表現が含まれています。生成されるファイルのサイズは、使用する Figure と形式およびシステムの解像度によって異なります。イメージは、グラフィックスを表示する Web ブラウザーや他のアプリケーションで広く使用されています。ただし、透明度をサポートしていないか、あるいはスケーリングが適切に処理されません。また、他のグラフィックス アプリケーションでラインやテキストなど個々のグラフィックス オブジェクトを変更することはできません。

イメージ ファイル形式

オプション	形式	既定のファイル拡張子
'jpeg'	JPEG 24 ビット	.jpg
'png'	PNG 24 ビット	.png
'tiff'	TIFF 24 ビット (圧縮)	.tif
'tiffn'	TIFF 24 ビット (圧縮なし)	.tif
'meta'	拡張メタファイル (Windows のみ)	.emf

ベクトル グラフィックス ファイル

ベクトル グラフィックス ファイルには、Figure を再描画するコマンドが保存されています。このタイプの形式はスケーリングに適していますが、大きなファイルが作成されることがあります。場合によっては、ベクトル グラフィックスには漂遊線などのビジュアル アーティファクトが含まれることがあります。一部のアプリケーションではベクトル グラフィックス形式の高度な編集がサポートされていますが、アプリケーションによっては、グラフィックスのサイズ変更以外の編集作業はサポートされていません。ベスト プラクティスとして、Figure が MATLAB 内にある間にすべての必要な変更を行ってください。

通常、saveas は Painters レンダラーを使ってベクトル グラフィックス ファイルを生成します。ただし、一部の複雑な Figure の場合、saveas は代わりに OpenGL^® レンダラーを使用します。OpenGL レンダラーを使用する場合、ベクトル グラフィックス ファイルに埋め込みイメージが使用されるため、他のアプリケーションでこの図を編集できる範囲が制限されることがあります。また、saveas が OpenGL レンダラーを使用してファイルを生成する場合、透明度はサポートされません。saveas が Painters レンダラーを使用するよう指定するには、Figure の Renderer プロパティを 'painters' に設定します。

Figure の Renderer プロパティを設定すると、saveas はそのレンダラーを使用します。それ以外の場合、関数が適切なレンダラーを選択します。ただし、Figure の表示に使用されるものと異なるレンダラーを saveas が選択した場合には、保存した Figure の詳細が表示された Figure と若干異なることもあります。必要に応じて、Figure の Renderer プロパティを設定し、表示される Figure と保存される Figure に同じレンダラーを使用することもできます。

ベクトル グラフィックス形式

オプション	形式	既定のファイル拡張子
'pdf'	フル ページ Portable Document Format (PDF) カラー	.pdf
'eps'	Encapsulated PostScript® (EPS) レベル 3 モノクロ	.eps
'epsc'	Encapsulated PostScript (EPS) レベル 3 カラー	.eps
'eps2'	Encapsulated PostScript (EPS) レベル 2 モノクロ	.eps
'epsc2'	Encapsulated PostScript (EPS) レベル 2 カラー	.eps
'meta'	拡張メタファイル (Windows® のみ)	.emf
'svg'	SVG (Scalable Vector Graphics)	.svg

メモ

PDF 形式のみが、Figure の PaperOrientation プロパティと、PaperPosition プロパティの left 要素および bottom 要素を使用します。その他の形式ではこれらの値が無視されます。

ヒント

• Figure の保存時にサイズや解像度を指定するには、代わりに関数 print を使用してください。

• 関数 saveas と [ファイル] メニューの [名前を付けて保存] ダイアログ ボックスで得られる結果は異なります。[名前を付けて保存] ダイアログ ボックスでは、画面の解像度およびサイズに一致するイメージが作成されます。関数 saveas は 150 DPI の解像度を使用し、Figure の PaperPosition プロパティと PaperPositionMode プロパティを使ってイメージのサイズを決定します。

• 保存および印刷された Figure の詳細は、画面に表示される Figure と異なる場合があります。画面の表示とより一貫性のある出力を生成するには、特定のサイズ、解像度または背景色で Figure を保存を参照してください。

代替機能

R2020a 以降、関数 exportgraphics を使用して、Figure の子、タイル表示チャート レイアウトまたはパネルなどのコンテナーになり得る座標軸、Figure、グラフの内容を保存できます。この関数は、以下を行う場合に関数 saveas の優れた代替関数となります。

• アプリまたは MATLAB Online™ に表示されるグラフィックスを保存

• 内容の周りの空白を最小化

• PDF フラグメントを組み込み可能なフォントと共に保存

• Figure 内の内容のサブセットを保存

• Figure のプロパティを変更する必要なく背景色を制御

バージョン履歴

R2006a より前に導入

R2023b: UI コンポーネントは将来のリリースでサポート終了予定

将来のリリースでは、関数 saveas は、Figure の UI コンポーネントの保存をサポートしません。

UI コンポーネントを含む Figure をエクスポートするには、関数 exportapp を呼び出します。たとえば、2 つのボタンと 1 つのスライダーを含むシンプルなアプリを作成します。関数 exportapp を呼び出して、Figure の内容を PDF ファイルとしてエクスポートします。

% Create figure with three UI components
f = uifigure;
button1 = uibutton(f,"Position",[150 300 100 50]);
button2 = uibutton(f,"Position",[300 300 100 50]);
slider1 = uislider(f,"Position",[150 250 250 3]);

% Export the contents of the figure
exportapp(f,"myapp.pdf")

あるいは、関数 getframe を呼び出して、Figure の内容を取得します。その後、関数 imwrite を呼び出して、その内容を保存します。今度は、内容を JPEG ファイルとして保存します。

F = getframe(f);
imwrite(F.cdata,"myapp.jpg");

この変更は R2022b で発表されました。R2023b では、UI コンポーネントを含む Figure を保存すると、関数 saveas は警告を出します。

R2023b: PostScript (.ps) ファイルは将来のリリースでサポート終了予定

将来のリリースで、関数 saveas は、フルページの PostScript (.ps) ファイルの作成をサポートしません。ベクトル グラフィックス ファイルをエクスポートするには、次のいずれかの方法を使用します。

関数 exportgraphics を呼び出します。ファイル拡張子 .eps、.pdf、または .emf を指定し、ContentType オプションを "vector" に設定します。この関数は、プロット周囲を余白なくトリミングした内容を取得し、フルページの出力を作成しません。たとえば、プロットを作成し、現在の Figure の内容を、ベクトル グラフィックスを含む PDF ファイルとして保存します。

plot([0 3 2 4 1]);
exportgraphics(gcf,"myplot.pdf","ContentType","vector")

あるいは、関数 saveas を呼び出し、ファイル拡張子 .eps、.emf、または .svg を指定します。たとえば、プロットを作成して、現在の Figure のコンテンツを EPS ファイルとして保存します。

plot([0 3 2 4 1]);
saveas(gcf,"myplot.eps","epsc")

以前のリリースでサポートされる PostScript オプションについては、saveas (R2022a) (R2022a) を参照してください。

この変更は R2022b で発表されました。R2023b では、Figure を PostScript ファイルに保存すると、関数 saveas は警告を出します。

R2023b: BMP、HDF、PBM、PCX、PGM、および PPM ファイルは将来のリリースでサポート終了予定

BMP、HDF、PBM、PCX、PGM、および PPM ファイル形式は、将来のリリースではサポートされません。

これらの形式のいずれかを使用してグラフィックスをエクスポートするには、代わりに関数 imwrite を使用します。たとえば、ライン プロットを作成し、関数 getframe を使用して、現在の Figure の内容を取得します。その後、その内容を BMP ファイルとして保存します。

plot([0 3 2 4 1]);
F = getframe(gcf);
imwrite(F.cdata,"myplot.bmp");

以前のリリースでサポートされるファイル形式のオプションについては、saveas (R2022a) (R2022a) を参照してください。

この変更は R2022b で発表されました。R2023b では、Figure をこれらのファイル形式のいずれかにエクスポートすると、関数 saveas は警告を出します。

R2016a: 保存される Figure のサイズが画面上と一致

保存される Figure のサイズは、既定で画面上の Figure のサイズに一致します。以前は、保存される Figure は既定で 8 × 6 インチでした。

参考

savefig | copygraphics | print | exportgraphics | open

トピック

• Compare Ways to Export Graphics from Figures
• プロットをイメージまたはベクトル グラフィックス ファイルとして保存