CLIP_RECTANGLE(3G)

NAME

clip_rectangle − defines the current clip rectangle boundaries.

SYNOPSIS

C SYNTAX

void clip_rectangle(fildes,lower_left_x,
upper_right_x,lower_left_y,upper_right_y);
int fildes;
float lower_left_x,upper_right_x,lower_left_y,upper_right_y;

FORTRAN77 SYNTAX

        subroutine clip_rectangle(fildes,lower_left_x,
        upper_right_x,lower_left_y,upper_right_y)
        integer*4 fildes
        real lower_left_x,upper_right_x
        real lower_left_y,upper_right_y

PASCAL SYNTAX

procedure clip_rectangle(fildes:integer;lower_left_x,
upper_right_x,lower_left_y,upper_right_y:real);

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 device is opened.
lower_left_x,lower_left_y,upper_right_x,upper_right_y
are the coordinate values which define the lower left and upper right corners of a rectangular extent in Virtual Device Coordinate space, which defines the clip rectangle.

DISCUSSION

When the clip_level parameter is set to CLIP_TO_RECT, with the clip_indicator procedure, output primitives are clipped to the intersection of this rectangular region and the Virtual Device Coordinate extent.

The results of this procedure are also used by the clear_view_surface routine when clear control is set to CLEAR_CLIP_RECTANGLE.

DEFAULTS

(lower_left_x,upper_right_x,lower_left_y,upper_right_y) = (0.0,1.0,0.0,1.0)

Museum

Related Articles