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);

DESCRIPTION

Input Parameters

fildes 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_TO_VIEWPORT Clipping is performed to the current viewport area.

CLIP_OFF No clipping is performed; i.e., output primitives are not clipped at all (this may result in device-dependent wraparound 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

clip_level = CLIP_TO_RECT

Museum

Related Articles