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