GRAPHIC GET OVERLAP statement  

Purpose

Retrieves the status of Graphic Overlap Mode.

Syntax

GRAPHIC GET OVERLAP To OverlapVar&

Function Form:

OverlapVar& = GRAPHIC(OVERLAP)

Remarks

GRAPHIC GET OVERLAP retrieves the status of overlap mode and assigns it to the variable specified by OverlapVar&.  If Overlap Mode is enabled, the value true (non-zero) is assigned.  If it's disabled, the value false (zero) is assigned instead.  The value returned reflects the status of the graphic target which is currently attached to the graphic stream.

With Overlap Mode, you control how PowerBASIC treats graphic operations which involve a RECT structure in their definition.  Windows graphic conventions consider the bottom and right coordinates of a RECT to be exclusive.  In other words, the pixels at the bottom and right edges lie immediately outside the rectangle.  They are not drawn, but are ignored.  For example:

GRAPHIC BOX (0,0) - (50,50)

In this case, a box is drawn from 0,0 to 49,49.  The final pixels at the bottom and right edge are simply not drawn.  However, if Overlap Mode is enabled with GRAPHIC SET OVERLAP, the box is drawn from 0,0 to 50,50.

The Overlap Mode affects drawing operations involving GRAPHIC SCALE, GRAPHIC BOX, GRAPHIC ELLIPSE, GRAPHIC LINE, GRAPHIC POLYLINE, etc.

See also

GRAPHIC SET OVERLAP