Topic       : The ATARI Compendium
Author      : Scott Sanders / JAY Software
Version     : 1.25 (20/6/2003)
Subject     : Documentation
Nodes       : 1117
Index Size  : 32614
HCP-Version : 6
Compiled on : Atari
@charset    : UTF-8
@lang       : en
@default    : 
@help       : %About
@options    : +g -i -t4 +y +z
@width      : 100
View Ref-Filevs_clip()                                                               VDI

Syntax

VOID vs_clip( handle, flag, pxy )
WORD handle, flag;
WORD *pxy;

Function      vs_clip() defines the global clipping rectangle and state
              for the specified workstation.

Opcode        129

Availability  Supported by all drivers.

Parameters    handle specifies a valid workstation handle. flag is set to
              CLIP_OFF (0) to turn off clipping or CLIP_ON (1) to enable
              clipping. If flag is CLIP_ON (1) then pxy should point to
              a 4 WORD array containing a VDI format rectangle which will
              serve as the clipping rectangle, otherwise, pxy can be NULL.

Binding       contrl[0] = 129;
              contrl[1] = 2;
              contrl[3] = 1;
              contrl[6] = handle;

              if(intin[0] = flag) {
               ptsin[0] = pxy[0];
               ptsin[1] = pxy[1];
               ptsin[2] = pxy[2];
               ptsin[3] = pxy[3];
              }

              vdi();

Comments      All VDI calls are clipped to that workstations current
              clipping rectangle.

Group         VDI Workstation