*SAVESW (KEYIN and DISPLAY)

*SAVESW

This list control saves the immediately preceding subwindow's coordinates, and the current subwindow's coordinates and image, on the program's memory stack for later retrieval. The number of subwindows that may be saved is only limited by the amount of memory available. An approximate algorithm for the memory required for each image is as follows: (((rows * columns) * 2) + 15), rounded to the next number divisible by 16. No error message is generated if insufficient memory exists while saving a screen.

Once an image is restored through *RESTSCR or *RESTSW it is no longer available for retrieval and must be saved again if desired for future retrieval. If a specific image is restored that is not at the top of the stack, all images between it and the top of the stack are also lost.