NAME

DfSetBoundary − Set the frame boundary

SYNOPSIS

C:

void DfSetBoundary(frame, boundary)
DtObject frame;
DtVolume ∗boundary;

FORTRAN:

CALL DFSB(FRAME, BNDRY)
INTEGER∗4 FRAME
REAL∗8 BNDRY(6)

DESCRIPTION

DfSetBoundary sets the boundary of a specified frame, frame, to the volume specified in boundary.  A frame defines a device-independent 3D local coordinate system within which one or more views can be positioned.  The frame boundary can be queried using DfInqBoundary <DFQB>. 

The frame is mapped onto the largest right rectangular volume that can fit within the device viewport such that aspect ratio in X and Y is preserved and that the Z extent of the frame is mapped to the entire Z extent of the device.  When this mapping is performed, there may be extra "white space" inside the device viewport.  The function DfSetJust <DFSJ> can be used to position this white space. 

ERRORS

DfSetBoundary will fail if the frame handle is invalid. 

[WARNING - invalid frame handle]

DEFAULTS

The default frame boundary extends from (0.0, 0.0, 0.0) to (1.0, 1.0, 1.0). 

SEE ALSO

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

September 02, 1992