NAME

DoFrame − Create a frame object

SYNOPSIS

C:

DtObject DoFrame()

FORTRAN:

INTEGER∗4 DOFR()

DESCRIPTION

DoFrame creates a new frame organizational object.  A frame is an object that describes an image to be displayed on a device.  It defines a device independent 3D local coordinate system within which one or more views can be positioned. 

A frame can be displayed on 0 or more devices using the function DdSetFrame <DDSF>.  The frame is mapped onto the largest right rectangular volume that can fit within the device viewport such that the 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> is used to position this white space.  A frame’s volume can be specified by DfSetBoundary <DFSB> and queried with DfInqBoundary <DFQB>. 

DEFAULTS

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

SEE ALSO

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

September 02, 1992