CLIP_RECTANGLE(3G)

NAME

clip_rectangle, intclip_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;

void intclip_rectangle(fildes,lower_left_x,upper_right_x,lower_left_y,
upper_right_y);
int fildes,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,lower_left_y,upper_right_y

subroutine intclip_rectangle(fildes,lower_left_x,upper_right_x,
lower_left_y,upper_right_y)
integer*4 fildes,lower_left_x,upper_right_x,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);

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

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,upper_right_y
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.

Integer operations are only available when using the INT_XFORM gopen mode. When in INT_XFORM mode, floating point operations are not available for that fildes. Floating point operations are the default, or can be specified with FLOAT_XFORM mode. For a list of integer operations, floating point operations and common operations see the starbase.3g manual page.

Note: The clip rectangle area is reset to be the entire vdc_extent area whenever vdc_extent or intvdc_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

Float: (lower_left_x,upper_right_x,lower_left_y,upper_right_y)=(0.0,1.0,0.0,1.0)
Integer: (lower_left_x,upper_right_x,lower_left_y,upper_right_y)=(0,32767,0,32767)

Museum

Related Articles