DfSetBoundary(3D)

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)