imsave() - Image Processing
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.Note:
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).RemarksIn 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.
Syntax
imsaveimsave(h)[filename, user_canceled] = imsave(…)
Example
imshow peppers.png
imsave
Output / Return Value
Limitations
Alternatives / See Also
Reference