SET_P1_P2(3G)

NAME

set_p1_p2 − sets physical device limits.

SYNOPSIS

C SYNTAX

void set_p1_p2(fildes,units,p1_x,p1_y,p1_z,p2_x,p2_y,p2_z);
int fildes,units;
float p1_x,p1_y,p1_z,p2_x,p2_y,p2_z;

FORTRAN SYNTAX

        subroutine set_p1_p2(fildes,units,p1_x,p1_y,p1_z,
        p2_x,p2_y,p2_z)
        integer*4 fildes,units
        real p1_x,p1_y,p2_z,p2_x,p2_y,p2_z

PASCAL SYNTAX

procedure set_p1_p2(fildes,units:integer;p1_x,p1_y,p1_z,
p2_x,p2_y,p2_z: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 an I/O path to a graphic device is opened.
units
If set to FRACTIONAL, the parameters for P1 and P2 represent decimal fractions of the physical device limits. (0.0,0.0,0.0) represents the lower-left-front corner and (1.0,1.0,1.0) the upper-right-rear corner of the physical display surface. All values of P1 and P2 must be in the range 0.0 to 1.0 and simply denote the fraction of the total surface in x or y. These units will be anisotropic except in the rare case of a square device.

If set to METRIC, the area specification is represented in millimeters. To inquire the current P1 and P2 in millimeters, use starbase inquire_sizes command.

p1_x,p1_y,p1_z
specify P1 (lower-left-front corner) of the region of interest.
p2_x,p2_y,p2_z
specify P2 (upper-right-rear corner) of the region of interest.

DISCUSSION

P1 may be in any position relative to P2. This could cause mirroring in either or both axes.

This procedure updates the current vdc-to-device units transformation matrix. This means the matrix at the bottom of the matrix stack is changed. No other matrices in the matrix stack are altered.

Changes to P1 and P2 may not effect previously set values such as text size or tracking relationships. P1 and P2 should be set before setting related values.

DEFAULTS

Units is FRACTIONAL. P1 = (0,0,0) and P2 = (1,1,1).

Museum

Related Articles