saveas - Save figure to specific file format - MATLAB (original) (raw)

Save figure to specific file format

Syntax

Description

saveas([fig](#buou9ii-fig),[filename](#buou9ii-filename)) saves the figure or Simulink® block diagram specified by fig to filefilename. Specify the file name as a character vector or string that includes a file extension, for example, 'myplot.jpg'. The file extension defines the file format. If you do not specify an extension, thensaveas saves the figure to a FIG file. To save the current figure, specify fig as gcf.

example

saveas([fig](#buou9ii-fig),[filename](#buou9ii-filename),[formattype](#buou9ii-formattype)) creates the file using the specified file format, formattype. If you do not specify a file extension in the file name, for example, 'myplot', then the standard extension corresponding to the specified format automatically appends to the file name. If you specify a file extension, it does not have to match the format. saveas uses formattype for the format, but saves the file with the specified extension. Thus, the file extension might not match the actual format used.

example

Examples

collapse all

Create a bar chart and save it as a PNG file.

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

Create a bar chart and save it as an EPS file. Specify the 'epsc' driver to save it in color.

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

saveas saves the bar chart as Barchart.eps.

Save a Simulink block diagram named 'sldemo_tank' as a JPEG file. Use get_param to get the handle of the diagram. You must have Simulink installed to run this code.

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

Input Arguments

collapse all

Figure to save, specified as a figure object or a Simulink block diagram. If you specify other types of graphics objects, such as an axes, then saveas saves the parent figure to the object.

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

To save a Simulink block diagram, use get_param to get the handle of the diagram. For example, save a block diagram named'sldemo_tank'.

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

File name, specified as a character vector or string with or without a file extension.

Example: 'Bar Chart'

Example: 'Bar Chart.png'

If you specify a file extension, then saveas uses the associated format. If you specify a file extension and additionally specify the formattype input argument, then saveas uses formattype for the format and saves the file with the specified file name. Thus, the file extension might not match the actual format used.

You can specify any extension corresponding to a file format. This table lists some common file extensions.

Data Types: char | string

File format, specified as one of these options:

• 'fig' — Save the figure as a MATLAB figure file with the .fig extension. To open figures saved with the .fig extension, use the openfig function. This format is not valid for Simulink block diagrams.
• 'm' or 'mfig' — Save the figure as a MATLAB figure file and additionally create a MATLAB file that opens the figure. To open the figure, run the MATLAB file. This option is not valid for Simulink block diagrams.
• Image file format — Specify the format as one of the image options in the table, Image File Formats.
• Vector graphics file format — Specify the format as one of the vector graphics options in the table, Vector Graphics Formats.

Image File

Images contain a pixel-based representation of the figure. The size of the generated file depends on the figure, the format, and your system resolution. Images are widely used by web browsers and other applications that display graphics. However, they do not support transparency or scale well and you cannot modify individual graphics objects (such as lines and text) in other graphics applications.

Image File Formats

Vector Graphics File

Vector graphics files store commands that redraw the figure. This type of format scales well, but can result in a large file. In some cases, vector graphics might contain stray lines or other visual artifacts. Some applications support extensive editing of vector graphics formats, but others do not support editing beyond resizing the graphic. The best practice is to make all the necessary changes while your figure is still in MATLAB.

Typically, saveas generates vector graphics files that scale well when resized. For some complex figures, the files might contain embedded images instead. These images don't scale well, and the extent to which you can edit them in other applications is limited.

To export a figure containing all vector graphics content, use theexportgraphics function, and specify theContentType name-value argument as"vector".

Vector Graphics Formats

Note

Only the PDF format uses the PaperOrientation property of the figure and the left andbottom elements of thePaperPosition property. Other formats ignore these values.

Tips

• To control the size or resolution when you save a figure, use the print function instead.
• The saveas function and the dialog box (accessed from the menu) do not produce identical results. The dialog box produces images at screen resolution and at screen size. The saveas function uses a resolution of 150 DPI and uses the PaperPosition and PaperPositionMode properties of the figure to determine the size of the image.
• Details of saved and printed figures can differ from the figure on the display. To get output that is more consistent with the display, see Export Figures for Use in Other Applications.

Alternative Functionality

Use the exportgraphics function to save the contents of any axes, figure, chart that can be a child of a figure, tiled chart layout, or container such as a panel. This function provides a better alternative to the saveas function when you want to:

• Save graphics displayed in an app or in MATLAB Online™
• Minimize the white space around the content
• Save a PDF fragment with embeddable fonts
• Save a subset of the content in the figure
• Control the background color without having to modify properties on the figure

Version History

Introduced before R2006a

expand all

The saveas function no longer clips the content of a large figure when the page is smaller than the figure. Instead, it shrinks the content to fit on the page and preserves the aspect ratio of the figure.

The Renderer property of a figure no longer has no effect on the saved graphic.

The InvertHardCopy property of a figure has no effect. Now, the default background color corresponds to the theme of the figure. The background is white if the figure has the light theme. The background is dark gray (almost black) if the figure has the dark theme. If you set the Color property of the figure before calling saveas, the output uses the color you specify regardless of the theme.

The saveas function no longer supports saving UI components in figures.

To export a figure containing UI components, call the exportapp function. For example, create a simple app containing two buttons and a slider. Export the contents of the figure as a PDF file by calling theexportapp function.

% 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")

Alternatively, call the getframe function to capture the contents of the figure. Then call the imwrite function to save the content. This time, save the content as a JPEG file.

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

This change was announced in R2022b. In R2023b through R2024b, thesaveas function issues a warning if you export a figure containing UI components.

The saveas function no longer supports creating full-page PostScript (.ps) files. To export vector graphics files, use one of the following methods:

Call the exportgraphics function. Specify an .svg,.eps, .pdf, or .emf file extension and set the ContentType name-value argument to"vector". This function captures content that is tightly cropped around plots, and it does not create full-page output. For example, create a plot and save the contents of the current figure as a PDF file containing vector graphics.

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

Alternatively, call the saveas function and specify a.pdf, .eps, .emf, or.svg file extension. For example, create a plot and save the contents of the current figure as an EPS file.

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

Before R2025a: See saveas (R2022a) for details about the PostScript options supported in earlier releases.

This change was announced in R2022b. In R2023b through R2024b, thesaveas function issues a warning when you export a figure to a PostScript file.

The BMP, HDF, PBM, PCX, PGM, and PPM file formats are no longer supported.

To export graphics using one of these formats, use the imwrite function instead. For example, create a line plot and capture the contents of the current figure using thegetframe function. Then save the content as a BMP file.

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

Before R2025a: See saveas (R2022a) for the file format options supported in earlier releases.

This change was announced in R2022b. In R2023b through R2024b, thesaveas function issues a warning if you export a figure to one of these file formats.

Saved figures match the size of the figure on the screen by default. Previously, saved figures were 8-by-6 inches by default.