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.

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