NAME

DdSetFrame − Attach a frame to a device

SYNOPSIS

C:

void DdSetFrame(device, frame)
DtObject device;
DtObject frame;

FORTRAN:

CALL DDSF(DEVICE, FRAME)
INTEGER∗4 DEVICE
INTEGER∗4 FRAME

DESCRIPTION

DdSetFrame sets the frame, frame, for a device, device.  Only one frame at a time is allowed per device.  A frame is an organizational object used to describe an image composed from one or more views.  A frame can be displayed on one or more devices. 

If a frame is already attached to a particular device when this routine is called, the old frame is detached and the new frame is attached in its place.  To detach a frame from a given device, pass a DcNullObject <DCNULL> for the frame parameter. 

The frame defines a device independent 3-D local coordinate system within which one or more views can be placed.  By default the frame extends from (0.0, 0.0, 0.0) to (1.0, 1.0, 1.0).  The frame boundary can be queried using DfInqBoundary <DFQB>. 

When the frame is displayed on a device the frame boundary 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 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 control where this white space is positioned. 

ERRORS

DdSetFrame will fail if the device handle is invalid. 

[WARNING - invalid device handle]

DdSetFrame will fail if the frame handle is invalid. 

[WARNING - invalid frame handle]

SEE ALSO

DdInqFrame(3D), DoFrame(3D)

September 02, 1992