Routines (alphabetical) > Routines: I > ISAVE

# ISAVE

## Examples

In the following example, we create an iSurface iTool and save it to a JPG file.

file = FILEPATH('surface.dat', $

SUBDIRECTORY = ['examples', 'data'])

data = READ_BINARY(file, DATA_DIMS = [350, 450], DATA_TYPE = 2, $

ENDIAN = 'little')

ISURFACE, data, TITLE = 'Maroon Bells Elevation', $

COLOR = [255, 128, 0]

; Insert a dialog box to pause the flow of action

result = DIALOG_MESSAGE('Click OK to save the image.', $

/INFORMATION)

; Save the iTool to an image file

ISAVE, 'mysurface.jpg'

## Syntax

ISAVE, [Filename] [, RESOLUTION=value] [, /SAVE_AS] [, TARGET_IDENTIFIER=windowID | iToolID] [, TOOL=iToolID]

## Arguments

### Filename

A string containing the full pathname of the file to which the data should be written. If Filename is not supplied, and a save filename is not already associated with the iTool visualization, a file selection dialog is displayed.

The file format of the saved file is determined from the file suffix supplied in the Filename argument. For example, if Filename is `image.bmp`, the file will be saved in bitmap format.

## Keywords

### SAVE_AS

By default, ISAVE mimics the behaviour of the IDL Workbench File > Save menu item. That is, if the iTool visualization has already been saved to a file, saving to the file again (overwriting the old file) will not prompt for a new filename.

If the SAVE_AS keyword is set, and Filename is not supplied, a file selection dialog is displayed.

### RESOLUTION

Set this keyword to the output resolution (in dots per inch) to use when saving the window to an image, WMF, or EPS file. If this keyword is not supplied, a default value of 600 DPI is used. The output resolution is converted into a scale factor using the current screen resolution. The maximum output dimensions are 8192 x 8192. If the output dimensions are larger than these values, the resolution will be automatically reduced.

### TARGET_IDENTIFIER

Set this keyword to the iTools identifier of the window or iTool visualization to save. If set to an item that is not an iTool visualization or window, the window that encompasses the defined object is used. If not supplied, the current iTool visualization is used.

### TOOL

Set this keyword to the iTools identifer of the iTool in which TARGET_IDENTIFIER is found. If not supplied, the current iTool is used.

## Version History

7.1 | Introduced

## See Also