NAME

DfSetJust − Set the frame justification

SYNOPSIS

C:

void DfSetJust(frame, left, bottom)
DtObject frame;
DtReal left, bottom;

FORTRAN:

CALL DFSJ(FRAME, LEFT, BOTTOM)
INTEGER∗4 FRAME
REAL∗8 LEFT, BOTTOM

DESCRIPTION

DfSetJust sets the justification of a specified frame, frame.  When the aspect ratios of the frame border and the device viewport are not the same, there will be extra "white space" inside the device viewport.  The frame justification provides a mechanism for controlling where this white space is positioned. 

The left parameter defines a value between 0.0 and 1.0 inclusive specifying the fraction of the white space to be inserted between the bottom left hand corner of the viewport and the left of the displayed image.  Similarly, the bottom parameter specifies the fraction of white space to be inserted between the bottom left hand corner of the viewport and the bottom of the displayed image. 

ERRORS

DfSetJust will fail if the frame handle is invalid. 

[WARNING - invalid frame handle]

DfSetJust will fail if the left or bottom parameters are out of range. 

[WARNING - value out of range]

DEFAULTS

The default is left = 0.5 and bottom = 0.5 creating an even distribution of white space in both directions. 

SEE ALSO

DdSetFrame(3D), DfInqBoundary(3D), DfInqJust(3D), DfUpdate(3D)

September 02, 1992