setviewport

Sets the current viewport for graphics output.

Defined in header <graphics.h>

Syntax

#include <graphics.h>
void  far setviewport(int    left, int top, int right, int bottom, int clip);

Portability

Remarks

setviewport estabHshes a new viewport for graphics output.

The viewport's corners are given in absolute screen coordinates by {left,top) and {right,bottom). The current position (CP) is moved to (0,0) in the new window.

The parameter clip determines whether drawings are cHpped (truncated) at the current viewport boundaries. If clip is nonzero, all drawings will be clipped to the current viewport.

Return value

If invalid input is passed to setviewport, graphresult returns -11, and the current view settings remain unchanged.

See also

• clearviewport
• getviewsettings
• graphresult

Example

#include <graphics.h>
#include <stdlib.h>
#include <stdio.h>
#include <conio.h>

ttdefine CLIP_ON 1           /* activates  clipping in viewport */

int main(void)

   /* request autodetection */
   int gdriver = DETECT, gmode, errorcode;

   /* 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:");
      getch();
  •exit(l);               /* terminate with  an error code */

setcolor(getmaxcolor 0 ) ;
/* message in default full-screen viewport  */
outtextxylO, 0, "* <--  (0, 0) in default viewport");

/* create a smaller viewport  */
setviewport (50, 50, getmaxxO -50, getmaxy()-50, CLIP_ON);
/* display some text */
outtextxy(0, 0, "* <--  i      in smaller viewport");

/* clean up */
getchO ;
closegraph();
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/setviewport/ · short form /3.1/setviewport/