statement/GSHAPE                                             statement/GSHAPE
 
 NAME
     GSHAPE -- Displays a shape on a graphic screen
 
 ABBREVIATION
     g <shift> S

 SYNOPSIS
     GSHAPE <shape>[,[<x>,<y>][,<mode>]]

 FUNCTION
     A rectangular graphic clips can be displayed on a multicolor or high 
     resolution graphics screen by the GSHAPE statement. If you type GSHAPE 
     with the shape variable (<shape>) the shape will be drawn with the top 
     left of the shape positioned at the pixel cursor. The shape variable may
     be followed by a graphic coordinates (<x> and <y>) and a replacement 
     mode value (<mode>). The coordinates tell where the shape should be 
     drawn on the screen and the mode value how it should be drawn.
     There are five possible replacement mode values:
 
         Mode   Description
         ----------------------------------
          0     place shape as is (default)
          1     place field inverted shape
          2     OR shape with area 
          3     AND shape with area
          4     XOR shape with area
 
     In mode 0 the shape is drawn to the graphic screen as it is. In this 
     mode shape overwrites completely the graphic area where it is drawn.
     In mode 1 the shape overwrites the graphic area just like in mode 0 but 
     this time the overwriting shape is inverted.
     In mode 2 logical operation OR is executed with the shape data and the 
     bit map to be replaced (the graphic area). Result is a transparent shape
     on top of the bit map.
     In mode 3 logical operation AND is executed with the shape data and the 
     bit map to be replaced. Result is a shape filtered bit map.
     In mode 4 logical operation XOR is executed with the shape data and the 
     bit map to be replaced. Result is a shape filtered bit map.
 
 INPUTS
     <shape> - string variable containing a shape to be drawn
     <x>     - scaled x coordinate. The default display position is the PC 
               (pixel cursor)
     <y>     - scaled y coordinate. The default display position is the PC 
               (pixel cursor)
     <mode>  - replacement mode (0-4)
 
 RESULT
     Displays a shape on a graphic screen.

 EXAMPLES
     GSHAPE V$,,,1
         Displays V$ shape with background and foreground colors reversed, 
         with the top left of the shape positioned at the pixel cursor (PC).
 
 NOTES
     None
 
 BUGS
     None
 
 SEE ALSO
     GRAPHIC
     SSHAPE