Pic.ScreenSavePart of Pic module

Syntax   Pic.ScreenSave (x1, y1, x2, y2 : int, fileName : string)

Description   Pic.ScreenSave saves a portion of the screen into a file in a format specified by the file name.

The picture saved to the file is the portion of the screen defined by the rectangle (x1, y1) - (x2, y2).

The fileNameparameter must give the format of the file:

 BMP files "BMP:filename" or "filename.BMP"

Details   Various versions of Turing can save different formats of files. Turing 4.1 for Windows can save BMP. Unfortunately, due to strictly enforced patents on the GIF compression algorithm, Turing will not implement saving of GIF pictures until the patents expire in June 2004.

Details   If the Pic.ScreenSave fails, then Error.Last will return a non-zero value indicating the reason for the failure. Error.LastMsg will return a string which contains the textual version of the error.

Example   The program draws a graphic and saves it as a PICT file called draw.

        Draw.FillBox (50, 50, 150, 150, red)
        Draw.FillStar (50, 50, 150, 150, green)
        Draw.FillOval (100, 100, 50, 50, blue)
        
        picID := Pic.ScreenSave (50, 50, 150, 150, "PICT:draw")
Status   Exported qualified.

This means that you can only call the function by calling Pic.ScreenSave, not by calling ScreenSave.