Click above to get retro games delivered to your door ever month!

GET                      Read Points from Screen                     Graphics

 GET [STEP] (x1,y1)-(x2,y2),arrayname

    Copies attributes from a specified rectangle within the screen buffer
    into a specified array.

        STEP    If included, coordinates are relative to last graphics
                point referenced (LPR). If omitted, coordinates are
                absolute.

       x1,y1    Upper left corner (column, row) of the rectangle to be
                copied in pixels.

       x2,y2    Lower right corner (column, row) of the rectangle to be
                copied in pixels.

   arrayname    The name of a numeric array.

   -------------------------------------------------------------------------

      Notes:    To determine how large the array must be, use the
                following formula:

                    4+INT(((x2-x1+1)*bitsperpixel+7)/8)*((y2-y1)+1)

                where bitsperpixel relates to screen mode as follows:

                    Mode       Bitsperpixel
                    SCREEN 1       2
                    SCREEN 2       1
                    SCREEN 7       4
                    SCREEN 8       4
                    SCREEN 9       2 (EGA memory = 64K)
                                   4 (EGA memory > 64K)
                    SCREEN 10      2

                The amount of memory allocated per array element is as
                follows:

                    Integer:            2 bytes per element
                    Long Integer:       4 bytes per element
                    Single-precision:   4 bytes per element
                    Double-precision:   8 bytes per element

                The first two bytes returned by the GET statement indicate
                the horizontal dimension of the screen rectangle, in bits;
                the second two bytes indicate the vertical dimension. The
                remainder of the data returned by GET are the attributes
                for each pixel in the rectangle.