saveas — Save a figure to a file.
saveas(fig, filename) saves the specified figure or graphics object parent figure. RunMat supports RunMat FIG scene files and PNG image export.
Syntax
ok = saveas(fig, filename)
ok = saveas(fig, filename, formattype)Inputs
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
args | Any | Variadic | — | MATLAB-compatible figure persistence arguments. |
Returns
| Name | Type | Description |
|---|---|---|
ok | LogicalArray | True when the save operation completed. |
Errors
| Identifier | When | Message |
|---|---|---|
RunMat:figurePersistence:InvalidArgument | Arguments are missing, malformed, or incompatible with the requested figure persistence operation. | figure persistence: invalid argument |
RunMat:figurePersistence:UnsupportedFormat | The requested save/load format is recognized but not supported by RunMat's active plotting exporter. | figure persistence: unsupported format |
RunMat:figurePersistence:IoFailure | The target file cannot be read, written, flushed, synced, or atomically replaced. | figure persistence: file I/O failed |
RunMat:figurePersistence:RenderFailed | The plotting renderer or scene exporter cannot serialize the requested figure. | figure persistence: export failed |
RunMat:figurePersistence:ImportFailed | The figure file is missing, corrupt, unsupported, or incompatible with RunMat's scene importer. | figure persistence: import failed |
RunMat:figurePersistence:Internal | Internal runtime control-flow or conversion fails. | figure persistence: internal operation failed |
How saveas works
saveas(fig, filename)infers the output format from.figor.png; names without an extension save as.fig.saveas(fig, filename, formattype)uses the explicit format. Iffilenamehas no extension, RunMat appends the standard extension for that format.- Figure, axes, text, legend, ruler, and plot-child handles save their parent figure.
- PDF, EPS, SVG, JPEG, TIFF, and MATLAB code-generation formats are recognized as unsupported until those exporters exist.
- Figure handles are double graphics identities and format/file arguments are text. Direct typed-integer or gpuArray arguments are invalid and reject before file I/O; integer plot data nested inside a figure remains authoritative scene data.
Does RunMat run saveas on the GPU?
PNG export uses the same renderer path as print.
FIG export serializes plotting state through the replay scene exporter.
Unsupported export formats fail before any partial output is written.
GPU memory and residency
saveas is an I/O sink. It returns a host logical status and does not launch numeric GPU kernels.
Examples
Save a figure scene
plot(1:5, [1 4 2 5 3]);
saveas(gcf, "plot_state.fig");Save a PNG image
plot(0:0.1:1, (0:0.1:1).^2);
saveas(gcf, "quadratic", "png");Using saveas with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how saveas changes the result.
Run a small saveas example, explain the result, then change one input and compare the output.
Related Plotting functions
2D Charts
area · bar · errorbar · heatmap · hist · histogram · loglog · pie · plot · scatter · semilogx · semilogy · stairs · stem
Other
addpoints · ancestor · animatedline · axes · barh · caxis · cla · clf · clim · colorcube · colororder · copyobj · daspect · datacursormode · dataTipTextRow · fcontour · figure · fill · fill3 · findobj · fsurf · gobjects · groot · hgload · hgsave · hidden · histogram2 · hold · line · linkaxes · openfig · opengl · pan · parula · patch · plotmatrix · plotyy · polarhistogram · polarplot · polarscatter · print · quiver3 · ribbon · savefig · sphere · stackedplot · subtitle · suptitle · text · textscatter · textscatter3 · triplot · waitbar · wordcloud · xlabel · xlim · xline · xscale · xtickangle · xtickformat · xticklabels · xticks · ylabel · ylim · yline · yscale · ytickangle · ytickformat · yticklabels · yticks · zlim · zoom
Open-source implementation
Unlike proprietary runtimes, every RunMat function is open-source. Read exactly how saveas is executed, line by line, in Rust.
- View the source for saveas in Rust on GitHub
- Learn how the RunMat runtime works
- Found a bug? Open an issue with a minimal reproduction.
About RunMat
RunMat is an open-source runtime that executes MATLAB-syntax code blazing on any GPU. It is licensed under the Apache 2.0 license.
- RunMat automatically optimizes your math for GPU execution on Apple, Nvidia, and AMD hardware. No code changes needed. Simulations that took hours now take minutes.
- Start running code in seconds. RunMat runs in the browser, on the desktop, or from the CLI. No license server, no IT ticket.