imwrite - Write image to file

Calling Sequence

ret=imwrite(im, filename)

Parameters

• im:im can be an M-by-N (greyscale image) or M-by-N-by-3 (color image) matrix. If im is not of class uint8, imwrite will convert the datatype before writing using im2uint8(im).
• filename: A string that specifies the name of the output file.
• ret: Return value. If the image is successfully writed into a file, ret will be 1.

Description

imwrite writes a matrix into a image file. The format of the file is inferred from the extension in the filename parameter. Currently the following file formats are supported:

* Windows bitmaps - BMP, DIB;

* JPEG files - JPEG, JPG, JPE;

* Portable Network Graphics - PNG;

* Portable image format - PBM, PGM, PPM;

* Sun rasters - SR, RAS;

* TIFF files - TIFF, TIF.

Examples

    im=rand(200,300);
    ret = imwrite(im, 'rand.png');

Authors

Shiqi Yu <shiqi.yu[at]gmail.com>

Bugs and Shortcomings

Images with a palette are not supported.

Availability

http://sivp.sourceforge.net

See Also

imread,  imshow,  imfinfo,