VIEWPORT_JUSTIFICATION(3G)

NAME

viewport_justification − control exact placement of the viewport within the physical region specified by set_p1_p2 when mapping_mode is isotropic.

SYNOPSIS

C SYNTAX

void viewport_justification(fildes,left,bottom);
int fildes;
float left,bottom;

FORTRAN77 SYNTAX

        subroutine viewport_justification(fildes,left,bottom)
        integer*4 fildes
        real left,bottom

PASCAL SYNTAX

procedure viewport_justification(fildes:integer;
left,bottom: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.
left and bottom
defines the fraction of "white space" on the left and bottom sides of the viewport.

DISCUSSION

When the mapping_mode is isotropic, the aspect ratio of the physical region of interest does match the aspect ratio of the vdc extent. In other words, there will be extra "white space" inside the physical region of interest.

If the physical region of interest is wider than the vdc extent when the heights match, left specifies the fraction of the white space which is inserted between P1 and the left side of the image of the vdc extent.

If the physical region of interest is taller than the vdc extent when the widths match, bottom specifies the fraction of the white space which is inserted between P1 and the bottom of the image of the vdc extent.

Left and bottom are decimal fractions between zero (0.0) and one (1.0), inclusive. Parameter(s) out of range generate a parameter error and the command is ignored.

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.

DEFAULTS

left = 0.5, bottom = 0.5

Museum

Related Articles