<<prev file | next file >>    view single page | view frames    summary: fields | routine    details: routine

Picture/

saveimage.pro

Save the current graphics window to an output file (GIF by default). The output formats supported are: GIF 8-bit with color table, BMP 8-bit with color table, PNG 8-bit with color table, PICT 8-bit with color table, JPEG 24-bit true color, TIFF 24-bit true-color. Any conversions necessary to convert 8-bit or 24-bit images onscreen to 8-bit or 24-bit output files are done automatically.

topSAVEIMAGE Input/Output.

SAVEIMAGE, FILE, BMP=BMP, PNG=PNG, PICT=PICT, JPEG=JPEG, TIFF=TIFF, QUALITY=QUALITY, DITHER=DITHER, CUBE=CUBE, QUIET=QUIET, MULTIPLE=MULTIPLE

Parameters

FILE        in required

Name of the output file (GIF format by default).

Keywords

BMP       

Set this keyword to create BMP format (8-bit with color table).

PNG       

Set this keyword to create PNG format (8-bit with color table).

PICT       

Set this keyword to create PICT format (8-bit with color table).

JPEG       

Set this keyword to create JPEG format (24-bit true color).

TIFF       

Set this keyword to create TIFF format (24-bit true color).

QUALITY       

If set to a named variable, specifies the quality for JPEG output (default 75). Ranges from 0 ("terrible") to 100 ("excellent"). Smaller quality values yield higher compression ratios and smaller output files.

DITHER       

If set, dither the output image when creating 8-bit output which is read from a 24-bit display (default is no dithering).

CUBE       

If set, use the color cube method to quantize colors when creating 8-bit output which is read from a 24-bit display (default is to use the statistical method). This may improve the accuracy of colors in the output image, especially white.

QUIET       

Set this keyword to suppress the information message (default is to print an information message).

MULTIPLE       

Examples

IDL> openr, lun, filepath('hurric.dat', subdir='examples/data'), /get_lun IDL> image = bytarr(440, 330) IDL> readu, lun, image IDL> free_lun, lun IDL> loadct, 13 IDL> tvscl, image IDL> saveimage, 'hurric.gif'

Version history

Version

$Id: saveimage.pro 136 2006-07-10 15:20:19Z pinsard $

History

Liam.Gumley@ssec.wisc.edu http://cimss.ssec.wisc.edu/~gumley This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.

Known issues

Restrictions

The output file is overwritten if it exists. requires IDL 5.0 or higher (square bracket array syntax).
Produced by IDLdoc 2.0.