CLIP_RECTANGLE(3G)

NAME

clip_rectangle − define 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);

DESCRIPTION

Input Parameters

fildes 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,
Coordinate values defining the lower left and upper right corners of a rectangular extent in Virtual Device Coordinate space, thus defining the clip rectangle.

Discussion

When clip_level is set to CLIP_TO_RECT by using clip_indicator, 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 clear_view_surface when clear control is set to CLEAR_CLIP_RECTANGLE.

The clip rectangle area is reset to be the entire vdc_extent area whenever vdc_extent is changed. This is a change present in all revisions beginning with and including HP-UX Release 5.18 (on Series 300 Model 320), and is different from previous behavior.

DEFAULTS

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

Museum

Related Articles