FRMSAVE

Saves a McIDAS frame to one of several image formats.

Formats

FRMSAVE frame name [keywords]
FRMSAVE window name TYPE=COMBINE [keywords]

Parameters

frame	image frame number to save (def=current)
window	combined window number (created with COMBINE command); the range is 0-9; you must also specify TYPE=COMBINE with this option
name	name of the file in which to save the frame; if you don't specify an extension, .GIF is appended if FORM=GIF, .PPM is appended if FORM=PPM, .BMP is appended if FORM=BMP, .JPG is appended if FORM=JPG, .PS is appended if FORM=PS, and .CPS is appended if FORM=CPS

Keywords

GRA=	graphics frame to save with the image; valid only for TYPE=FRAME; see the Remarks (default=number specified in frame if the session does not have independent graphics; default=last-associated graphics frame if the session has independent graphics)
FORm=	format of saved file; valid entries are GIF, PPM, BMP, JPG, PS and CPS for graphics interchange, portable pixmap, bitmap, joint photographic experts group, PostScript, and color PostScript formats, respectively (default=GIF for TYPE=FRAME; default=JPG for TYPE=COMBINE)
QUAlity=	JPEG image quality; the range is 0 - 100 with higher numbers representing better quality; you must also specify FORM=JPG with this keyword (default=100)
TYPe=	FRAME	save the frame specified in frame (default)
	COMBINE	save the combined window specified in window; you must specify this keyword when using the FRMSAVE window name format

Remarks

You can view files created with FRMSAVE with a Unix viewer program like xv or xloadimage.

FRMSAVE can be used with single- or multi-panel frames, but it always saves the entire frame (all panels) even if you specify the global keyword PAN.

Image frames and graphics frames are "associated" once they have been viewed together. Sessions without independent graphics automatically associate each image frame with the graphics frame of the same number once the frame has been displayed. However, sessions with independent graphics have separate control (and display) of image and graphics frames so image frames are not necessarily associated with the graphics frames of the same number. For example, if you loop through image frames 1-10 while displaying graphics frame 1, all ten of the image frames are associated with graphics frame 1. This is relevant because the GRA keyword defaults to the last-associated graphics frame for the image frame specified in the frame parameter. In this example, command entry FRMSAVE 7 GOESIR would save graphics frame 1 with image frame 7 in the file GOESIR.GIF.

Examples

FRMSAVE X IMAGE

This entry saves the current image and graphics frame into the file IMAGE.GIF.

FRMSAVE 5 PICTURE FORM=BMP

This entry saves image frame 5 and graphics frame 5 into the bitmap file PICTURE.BMP in sessions without independent graphics. In sessions with independent graphics, the entry saves image frame 5 and its last-associated graphics frame into the bitmap file PICTURE.BMP.

FRMSAVE 11 GOESVIS GRA=1

This entry saves image frame 11 and graphics frame 1 into the file GOESVIS.GIF.

FRMSAVE 1 trucolor.jpg TYPE=COMBINE

This entry saves the contents of combined window 1 into the JPEG file trucolor.jpg. The combined window was created using the COMBINE command.