Main Content


Save Image Tool


Use the imsave function to create a Save Image tool that displays an interactive file chooser dialog box. Use this dialog box to navigate your file system to determine where to save the image file and specify the name of the file. Choose the graphics file format you want to use from among the image file formats listed in the Files of Type menu. For more information about using the tool, see Tips.


imsave creates a Save Image tool in a separate figure that is associated with the image in the current figure, called the target image.

imsave(h) creates a Save Image tool associated with the image specified by the handle h.

[filename,user_canceled] = imsave(___) returns the full path to the file selected in filename and indicates whether you canceled the save operation.


collapse all

Read a grayscale image into the workspace. Display the image.

I = imread('coins.png');

Process the image. This example creates a binary mask in which the background is black and the coins are white.

bw = imbinarize(I);
bw = imfill(bw,'holes');

Save the binary image to file by using the Save Image tool. You can navigate to the desired directory and specify the file name and file format. This example saves the image to the Desktop with the file name myMaskImage in the JPEG file format.


Input Arguments

collapse all

Handle to a figure, axes, uipanel, or image graphics object, specified as a handle. If h is an axes or figure handle, then imsave uses the first image returned by findobj(H,'Type','image').

Output Arguments

collapse all

Full path to file, returned as a character vector. If you cancel the save operation, then filename is an empty character array, ''.

User canceled operation, returned as false or true. If you press the Cancel button or close the save window, then imsave sets user_canceled to true; otherwise, false.


  • 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.

  • imsave uses imwrite to save the image, using default options.

  • If you specify a file name that already exists, then imsave displays a warning message. Select Yes to use the file name or No to return to the dialog to select another file name. If you select Yes, then 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.

Version History

Introduced in R2007b