Saves a McIDAS frame to one of several image formats.
FRMSAVE window name TYPE=COMBINE [keywords]
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
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)
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)
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.
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.