clearviewport

Clears the current viewport.

Defined in header <graphics.h>

Syntax

#include <graphics.h>
void far clearviewport(void);

Portability

Remarks

clearviewport erases the viewport and moves the CP (current position) to home (0,0), relative to the viewport.

Return value

None.

See also

• cleardevice
• getviewsettings
• setviewport

Example

#include <graphics.h>
*include <stdlib.h>
#include <stdio.h>
#include <conio.h>
#define CLIP_ON 1   /* activates clipping  in viewport */

int main(void)
{
   /* request autodetection */
   int gdriver = DETECT, gmode, errorcode, ht;
   /* initialize graphics and local variables  */
   initgraph(&gdriver, &gmode,  "");
   /* read result of initialization  */
   errorcode = graphresult ();
   if (errorcode != grOk)  {   /* an error occurred */
      printf("Graphics error: %s\n", grapherrormsg (errorcode));
      printf("Press any key to halt:");
      getchO ;
      exit(l);                /* terminate with an error code */
   }
   setcolor(getmaxcolor ());
   ht = textheight("W");
   /* message in default full-screen viewport  */
   outtextxy(0, 0, "* <--  (0, 0) in default viewport");

   /* create a smaller viewport */
   setviewport(50, 50, getmaxxO -50, getmaxy ()-50, CLIP_ON);

   /* display some messages */
   outtextxy(0, 0, "* <--  (0, 0) in smaller viewport");
   outtextxy(0, 2*ht, "Press any key to clear viewport:");

   getchO;    /* wait for a key */
   clearviewport0 ;   /* clear -the viewport */
   /* output another message */
   outtextxy(0, 0, "Press any key to quit:");

   /* clean up */
   getchO ;
   closegraphO ;
   return 0;

Differences from modern implementations

Nothing recorded yet.

Modern references

• Microsoft C runtime (search)

These are search links, not yet checked by hand.

Stable link: /3.1/graphics.h/clearviewport/ · short form /3.1/clearviewport/