vdc_justification(3G)

NAME

vdc_justification − control exact placement of VDC extent within physical region specified by set_p1_p2 when mapping_mode is isotropic. This used to be called viewport_justification.

SYNOPSIS

C Syntax:

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

FORTRAN77 Syntax:

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

Pascal Syntax:

procedure vdc_justification(fildes:integer;
left,bottom:real);

DESCRIPTION

Input Parameters

fildes 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 mapping_mode is isotropic, the aspect ratio of the physical region of interest does not 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 total white space that 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 to be 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. Out-of-range parameter(s) generate a parameter error and the command is ignored.

This procedure updates the current vdc-to-device units transformation matrix. If no matrices have been placed on the matrix stack and no viewing transformations have been defined, the new vdc matrix becomes the current viewing transformation. Otherwise, no other transformation matrices are affected.

Note: This function was called viewport_justification in previous releases. For compatibility, there is still a viewport_justification function that just calls vdc_justification.

DEFAULTS

left = 0.5, bottom = 0.5

Museum

Related Articles