exportgraphics
Figure またはプロットをエクスポート
説明
exportgraphics( は、ファイルを保存する追加のオプションを指定します。たとえば、obj,filename,Name,Value)exportgraphics(gca,"myplot.jpg","Resolution",300) は現在の座標軸の内容を 300 DPI のイメージ ファイルとして保存します。
例
ライン プロットを作成して現在の座標軸を取得します。次に、座標軸の内容を JPEG ファイルとして保存します。
plot(rand(5,5))
ax = gca;
exportgraphics(ax,'LinePlot.jpg')
イメージを表示して現在の座標軸を取得します。次に、座標軸の内容を 300-DPI JPEG ファイルとして保存します。
I = imread('peppers.png'); imshow(I) ax = gca; exportgraphics(ax,'Peppers300.jpg','Resolution',300)
R2025a 以降
エクスポート ファイルの幅と高さを指定する場合は、同程度のサイズと縦横比をもつ Figure を作成します。たとえば、サイズが 500×400 ピクセルの Figure にステム プロットを作成します。その後、両側に 10 ピクセルのパディングを含む 500×400 ピクセルの PNG ファイルとして Figure をエクスポートします。
f = figure; f.Position(3:4) = [500 400]; stem(1:10,"filled",LineWidth=2) ylim padded exportgraphics(f,"stemplot.png",Units="pixels", ... Width=500,Height=400,Padding=10)
注釈が座標軸の境界からはみ出しているプロットを表示します。Figure の内容を PDF ファイルとして保存します。
plot(1:10) annotation('textarrow',[0.06 0.5],[0.73 0.5],'String','y = x ') f = gcf; exportgraphics(f,'AnnotatedPlot.pdf')
棒グラフを表示して現在の座標軸を取得します。次に、座標軸の内容をベクトル グラフィックスのみを含む PDF として保存します。
bar([10 22 31 43]) ax = gca; exportgraphics(ax,'BarChart.pdf','ContentType','vector')
マルチページ PDF を作成するには、名前と値の引数 'Append' を true に設定します。
たとえば、ライン プロットを作成し、座標軸の内容をファイル myplots.pdf に保存します。
plot([0 0.3 0.1 0.6 0.4 1])
ax = gca;
exportgraphics(ax,'myplots.pdf')
次に、棒グラフを作成し、座標軸の内容を myplots.pdf の 2 番目のページとして保存します。
bar(1:10) exportgraphics(ax,'myplots.pdf','Append',true)
放物線と 1 つのマーカーをプロットします。for ループの反復ごとにマーカーの位置を変更し、その変更をアニメーション GIF のフレームとして取得します。
x = -10:0.5:10; y = x.^2; p = plot(x,y,"-o","MarkerFaceColor","red"); for i=1:41 p.MarkerIndices = i; exportgraphics(gca,"parabola.gif","Append",true) end
2 つのプロットをタイル表示チャート レイアウトで表示します。次に、TiledChartLayout オブジェクトを関数 exportgraphics に渡して両方のプロットを PDF として保存します。
t = tiledlayout(2,1);
nexttile
plot([1 2 3])
nexttile
plot([3 2 1])
exportgraphics(t,'Layout.pdf')
レイアウト内のプロットのいずれか 1 つのみ保存する場合は、軸の戻り引数を使用して関数 nexttile を呼び出します。次に、座標軸を関数 exportgraphics に渡します。
ヒートマップ チャートを表示します。次に、チャートを透明な背景のベクトル グラフィックスのみを含む PDF として保存します。
h = heatmap(rand(10,10)); exportgraphics(h,'Hmap.pdf','BackgroundColor','none','ContentType','vector')
座標軸の内容を保存するプロットとボタンを表示する saveapp.m と呼ばれるプログラム ファイルを作成します。ボタンのコールバック関数では、関数 uiputfile を呼び出して、ファイル名と場所についてユーザーにプロンプトを表示します。次に、指定されたファイルの絶対パスを使用して関数 exportgraphics を呼び出します。
function saveapp f = uifigure; ax = uiaxes(f,"Position",[25 25 400 375]); plot(ax,[0 0.3 0.1 0.6 0.4 1]) b = uibutton(f,"Position",[435 200 90 30],"Text","Save Plot"); b.ButtonPushedFcn = @buttoncallback; function buttoncallback(~,~) filter = {"*.jpg";"*.png";"*.tif";"*.pdf";"*.eps"}; [filename,filepath] = uiputfile(filter); if ischar(filename) exportgraphics(ax,[filepath filename]); end end end
関数 saveapp を呼び出してアプリを実行します。アプリで [Save Plot] ボタンをクリックすると、ダイアログ ボックスにファイル名と場所のプロンプトが表示されます。次に、座標軸の内容が指定されたファイルに保存されます。ボタンを含む座標軸を囲む領域は、ファイルに含まれません。
saveapp
入力引数
名前と値の引数
オプションの引数のペアを Name1=Value1,...,NameN=ValueN として指定します。ここで、Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後に指定しなければなりませんが、ペアの順序は重要ではありません。
R2021a より前では、コンマを使用して名前と値をそれぞれ区切り、Name を引用符で囲みます。
例: exportgraphics(gca,"myplot.jpg","Resolution",300) は、現在の座標軸の内容を 300-DPI イメージ ファイルに保存します。
EMF、EPS、PDF ファイルとして保存するときの、保存する内容のタイプ。次のいずれかの値を指定します。
"auto"— MATLAB は、内容がベクトル グラフィックスかイメージかを制御します。"vector"— 任意のサイズに拡大できるベクトル グラフィックスとして内容を保存します。PDF ファイルを保存している場合は、組み込み可能なフォントがファイルに含まれます。"image"— ファイル内の 1 つ以上のイメージにコンテンツを保存します。
メモ
JPEG、TIFF、PNG、および GIF ファイルでは
"vector"オプションはサポートされていません。"vector"オプションを指定した場合、一部の可視化では漂遊線などのアーティファクトが含まれることがあります。
インチあたりのドット数 (DPI) の解像度。1 以上の正の整数として指定します。
ContentType が "vector" の場合は、解像度を指定しても効果はありません。
データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64
背景色。"current"、"none"、RGB 3 成分、16 進数カラー コード、または色名として指定します。背景色により、座標軸またはチャート周囲の余白の色が制御されます。
値が
"current"の場合、背景色は親コンテナーの色に応じて設定されます。たとえばfigure(Color="red")を使用して赤の Figure を作成するなど、プロパティを設定して親コンテナーの色を明示的に設定している場合、その色がエクスポート ファイルで使用されます。親コンテナーの色が設定されていない場合、エクスポート ファイルの背景色はテーマによって決まります。ライト テーマの背景は白です。ダーク テーマの背景は濃いグレー (ほぼ黒) になります。 (R2025a 以降)
値が
"none"の場合、背景色は、ContentTypeの値に応じて、透明、白、または濃いグレー (ほぼ黒) に設定されます。ContentType="vector"の場合、背景色は透明です。ContentType="image"の場合、ライト テーマの Figure の背景色は白、ダーク テーマの Figure の背景色は濃いグレー (ほぼ黒) になります。ContentType="auto"の場合、背景色は MATLAB により、エクスポートする内容のタイプを判別するためのヒューリスティックな方法に従って設定されます。
あるいは、カスタム色または名前の付いた色を指定します。
カスタム色および名前の付いた色
RGB 3 成分および 16 進数カラー コードは、カスタム色を指定するのに役立ちます。
RGB 3 成分は、色の赤、緑、青成分の強度を指定する 3 成分の行ベクトルです。強度値は
[0,1]の範囲でなければなりません。たとえば[0.4 0.6 0.7]のようになります。16 進数カラー コードは、ハッシュ記号 (
#) で始まり、3 桁または 6 桁の0からFまでの範囲の 16 進数が続く文字ベクトルまたは string スカラーです。この値は大文字と小文字を区別しません。したがって、カラー コード"#FF8800"、"#ff8800"、"#F80"、および"#f80"は等価です。
あるいは、名前を使用して一部の一般的な色を指定できます。次の表に、名前の付いた色オプション、等価の RGB 3 成分、および 16 進数カラー コードを示します。
| 色名 | 省略名 | RGB 3 成分 | 16 進数カラー コード | 外観 |
|---|---|---|---|---|
"red" | "r" | [1 0 0] | "#FF0000" |
|
"green" | "g" | [0 1 0] | "#00FF00" |
|
"blue" | "b" | [0 0 1] | "#0000FF" |
|
"cyan" | "c" | [0 1 1] | "#00FFFF" |
|
"magenta" | "m" | [1 0 1] | "#FF00FF" |
|
"yellow" | "y" | [1 1 0] | "#FFFF00" |
|
"black" | "k" | [0 0 0] | "#000000" |
|
"white" | "w" | [1 1 1] | "#FFFFFF" |
|
次の表に、ライト テーマとダーク テーマでのプロットの既定のカラー パレットを示します。
| パレット | パレットの色 |
|---|---|
R2025a より前: ほとんどのプロットで、これらの色が既定で使用されます。 |
|
|
|
orderedcolors 関数と rgb2hex 関数を使用すると、これらのパレットの RGB 3 成分および 16 進数カラー コードを取得できます。たとえば、"gem" パレットの RGB 3 成分を取得し、16 進数カラー コードに変換します。
RGB = orderedcolors("gem");
H = rgb2hex(RGB);R2023b より前: RGB = get(groot,"FactoryAxesColorOrder") を使用して、RGB 3 成分を取得します。
R2024a より前: H = compose("#%02X%02X%02X",round(RGB*255)) を使用して、16 進数カラー コードを取得します。
既存のファイルへの内容の追加。true または false として指定します。
このオプションは、以下の場合に便利です。
内容を既存の PDF ファイルの最後のページとしてエクスポートする。複数のページを追加するには、
Appendオプションを使用してexportgraphicsを複数回呼び出します。内容をアニメーション GIF ファイルの最後のフレームとしてエクスポートする。複数のフレームを追加するには、
Appendオプションを使用してexportgraphicsを複数回呼び出します。
メモ
引数 Append を使用すると、座標軸の範囲が同じであるチャートから基本的なアニメーション GIF ファイルを作成できます。チャート間で座標軸の範囲が異なる場合は、axis("manual") を使用するか、または関数 xlim、ylim または zlim を使用して、チャートの作成時に座標軸の範囲を固定することを検討してください。
イメージやより詳細なグラフィックスのアニメーションを作成するには、imwrite を使用します。imwrite の使用の詳細については、アニメーション GIF を書き込むを参照してください。
既存のファイルの名前を指定した場合に Append オプションを false に設定すると、MATLAB はそのファイルの内容を新しい内容で上書きします。
このオプションでサポートされるのは PDF および GIF ファイルのみです。
保存されるグラフィックスの色空間。"rgb"、"gray" または "cmyk" として指定します。
"rgb"— トゥルーカラー RGB の内容をエクスポートします。"gray"— 内容をグレースケールに変換します。"cmyk"— 内容をシアン、マゼンタ、黄色、黒 (CMYK) に変換します。この色空間は EPS ファイルでのみサポートされます。
R2025a 以降
保存されるグラフィックスの幅。"auto" または正の数値として指定します。カスタムの幅を指定するには、数値を指定します。既定の単位は、イメージ ファイルの場合はピクセル、ベクトル グラフィックス ファイルの場合はポイントです。名前と値の引数 Units を使用して、異なる単位を指定できます。すべての幅の値には、グラフィックスの周囲のパディングが含まれます。保存されたグラフィックスには既定でパディングの小さい余白が含まれますが、これは名前と値の引数 Padding を指定して変更できます。
Width の値が "auto" の場合、Height の値に基づいて縦横比を維持する幅が選択されます。
メモ
イメージ ファイルを保存する際、既定の Width ("auto") は名前と値の引数 Resolution (既定では 150) によって異なります。既定の幅を使用し、サイズを画面上とより厳密に一致させるには、名前と値の引数 Resolution を get(groot,"ScreenPixelsPerInch") によって返される値に指定します。以下に例を示します。
sppi = get(groot,"ScreenPixelsPerInch"); exportgraphics(gca,"myplot.png","Resolution",sppi)
R2025a 以降
保存されるグラフィックスの高さ。"auto" または正の数値として指定します。カスタムの高さを指定するには、数値を指定します。既定の単位は、イメージ ファイルの場合はピクセル、ベクトル グラフィックス ファイルの場合はポイントです。名前と値の引数 Units を使用して、異なる単位を指定できます。すべての高さの値には、グラフィックスの周囲のパディングが含まれます。保存されたグラフィックスには既定でパディングの小さい余白が含まれますが、これは名前と値の引数 Padding を指定して変更できます。
Height の値が "auto" の場合、Width の値に基づいて縦横比を維持する高さが選択されます。
メモ
イメージ ファイルを保存する際、既定の Height ("auto") は名前と値の引数 Resolution (既定では 150) によって異なります。既定の高さを使用し、サイズを画面上とより厳密に一致させるには、名前と値の引数 Resolution を get(groot,"ScreenPixelsPerInch") によって返される値として指定します。以下に例を示します。
sppi = get(groot,"ScreenPixelsPerInch"); exportgraphics(gca,"myplot.png","Resolution",sppi)
R2025a 以降
保存されるグラフィックスの周囲のパディング。次の表のいずれかの値として指定します。
| 値 | 説明 | 例 |
|---|---|---|
| x 軸と y 軸のラベル、タイトル、および装飾 (凡例やカラー バーなど) が十分収まるパディングを含めます。 | 棒グラフを作成し、 イメージ周囲のグレーの境界線が取得領域の輪郭です。境界線は保存されるイメージの一部ではありません。
bar(1:5) title("My Bar Chart") ax = gca; exportgraphics(ax,"tightpadding.png")
|
| Figure ウィンドウに示されているのと同じ相対量のパディングを含めます。 | 棒グラフを作成し、 イメージ周囲のグレーの境界線が取得領域の輪郭です。
bar(1:5) title("My Bar Chart") ax = gca; exportgraphics(ax,"figurepadding.png","Padding","figure")
|
正の数値 | 指定した量のパディングを含めます。既定の単位は、イメージ ファイルの場合はピクセル、ベクトル グラフィックス ファイルの場合はポイントです。名前と値の引数 | 棒グラフを作成し、100 ピクセルのパディングを含むイメージとしてエクスポートします。 イメージ周囲のグレーの境界線が取得領域の輪郭です。
bar(1:5) title("My Bar Chart") ax = gca; exportgraphics(ax,"100pixelpadding.png","Padding",100)
|
R2025a 以降
Width、Height、Padding の値の単位。"auto"、"pixels" (イメージのみ)、"inches"、"centimeters" または "points" (1 ポイントは 1/72 インチ) として指定します。
既定値の "auto" では、単位はイメージ ファイルの場合は "pixels"、ベクトル グラフィックス ファイルの場合は "points" に設定されます。
R2025a 以降
元の縦横比の維持。"auto"、"on" または "off" として指定します。
値が "auto" の場合、exportgraphics では、名前と値の引数 Width および Height が指定されているかどうか、その組み合わせによって縦横比が変化するかどうかに応じて、"on" または "off" を選択できます。exportgraphics は、名前と値の引数 Width または Height (両方ではない) が指定されている場合は元の縦横比を維持します。両方の次元の値が指定されており、それらの値によって縦横比が変化する場合は、元の縦横比を維持しません。
次の表は、"on" と "off" の値の動作をまとめています。
| 値 | 説明 | 例 |
|---|---|---|
| 元のグラフィックスの縦横比を維持します。
| 棒グラフを作成します。次に、チャートをイメージとして保存します。 イメージ周囲のグレーの境界線が取得領域の輪郭です。境界線は保存されるイメージの一部ではありません。
bar(1:5) ax = gca; exportgraphics(ax,"scaledchart.png",Width=250, ... PreserveAspectRatio="on")
チャートをイメージとして保存し、
exportgraphics(ax,"paddedchart.png",Width=250,... Height=350,PreserveAspectRatio="on")
|
| 元の縦横比を維持しません。 | 棒グラフを作成します。次に、チャートをイメージとして保存し、 イメージは、引き伸ばされたバージョンのチャートを示します。イメージ周囲のグレーの境界線が取得領域の輪郭です。
bar(1:5) ax = gca; exportgraphics(ax,"stretched-chart.png",Width=250,... Height=350,PreserveAspectRatio="off")
|
代替機能
Figure ツールストリップを使用 (R2025a 以降)
[Figure] タブで [名前を付けて保存] ボタンの下半分をクリックし、[出力場所] メニュー項目を選択します。詳細については、Figure ツールストリップからの Figure の印刷またはエクスポートを参照してください。
座標軸ツール バーを使用
座標軸ツール バーの [エクスポート] ボタン 
にカーソルを合わせると、ドロップダウン メニューが表示され、内容をエクスポートするためのオプションが示されます。
:内容を、余白なくトリミングしたイメージまたは PDF として保存します。
:内容をイメージとしてコピーします。
:内容をベクトル グラフィックスとしてコピーします。
