SetCurClip Function (ROM Call 0x19B)

graph.h

void SetCurClip (const SCR_RECT *clip);

Sets the default clipping area.

SetCurClip sets the default clipping area for commands which are sensitive to clipping, but which do not need a clipping area as an explicit parameter (such commands are LineTo and DrawClipPix). The clipping area is a rectangle with corners (x0, y0) and (x1, y1) which is given using a SCR_RECT structure clip. All clip-sensitive drawings will be clipped (truncated) at the current clipping area boundaries. Be warned: the default clipping area at the beginning of the program is not the full screen!

Note: TIGCC is GNU C, so it allows cast constructors. That's why constructions like

SetCurClip (&(SCR_RECT){{0, 0, 159, 99}});
are legal.


Used by: DrawClipLine, DrawClipRect, MenuKey, MenuOff, MenuOn, MenuTopRedef, MenuTopSelect, DrawWinBorder, WinLineNC, ROM Call 0x421