This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English verison of the page.

Note: This page has been translated by MathWorks. Please click here
To view all translated materals including this page, select Japan from the country navigator on the bottom of this page.


Save Image Tool


[filename, user_canceled] = imsave(…)


imsave creates a Save Image tool in a separate figure that is associated with the image in the current figure, called the target image. The Save Image tool displays an interactive file chooser dialog box (shown below) in which you can specify a path and filename. When you click Save, the Save Image tool writes the target image to a file using the image file format you select in the Files of Type menu. imsave uses imwrite to save the image, using default options.

If you specify a filename that already exists, imsave displays a warning message. Select Yes to use the filename or No to return to the dialog to select another filename. If you select Yes, the Save Image tool attempts to overwrite the target file.


The Save Image tool is modal; it blocks the MATLAB® command line until you respond.

imsave(h) creates a Save Image tool associated with the image specified by the handle h. h can be an image, axes, uipanel, or figure handle. If h is an axes or figure handle, imsave uses the first image returned by findobj(h,'Type','image').

[filename, user_canceled] = imsave(…) returns the full path to the file selected in filename. If you press the Cancel button, imsave setsuser_canceled to true (1); otherwise, false (0).


In contrast to the Save as option in the figure File menu, the Save Image tool saves only the image displayed in the figure. The Save as option in the figure window File menu saves the entire figure window, not just the image.


imshow peppers.png

Introduced in R2007b

Was this topic helpful?