CLIP_INDICATOR(3G)

NAME

clip_indicator − enable/disable clipping to clip rectangle and Virtual Device Coordinate extent.

SYNOPSIS

C SYNTAX

void clip_indicator (fildes,clip_level)
int fildes,clip_level;

FORTRAN77 SYNTAX

subroutine clip_indicator(fildes,clip_level)
integer*4 fildes,clip_level

PASCAL SYNTAX

procedure clip_indicator(fildes,clip_level:integer);

HP-UX COMPATIBILITY

Level: HP-UX/STANDARD

Origin: ANSI Computer Graphics Interface

DESCRIPTION

INPUT PARAMETERS

fildes
is an integer file descriptor returned by gopen when the I/O path to the output graphic device is opened.
clip_level
determines whether clipping to clip_rectangle (CLIP_TO_RECT), Virtual Device Coordinate extent (CLIP_TO_VDC), or not at all (CLIP_OFF).

DISCUSSION

The clip_level parameter can be one of the following:

   CLIP_TO_RECT - clipping is performed to the intersection
   of clip rectangle and Virtual Device Coordinate extent.

   CLIP_TO_VDC - clipping is performed to the Virtual Device
   Coordinate extent boundary.

   CLIP_OFF - no clipping is performed; i.e., output
   primitives are not clipped at all (this may result in
   device dependent wrap around or errors if primitives
   need to be clipped).

CLIP_OFF should only be used when the output primitives are known to be within the hard clip area. Performance will be substantially better if clip_indicator is set to CLIP_OFF.

DEFAULTS

Clipping to CLIP_RECTANGLE.

Museum

Related Articles