mswapb(3G)

NAME
     mswapb - swap multiple framebuffers simultaneously

FORTRAN SPECIFICATION
     subroutine mswapb(fbuf)
     integer*4 fbuf

PARAMETERS
     fbuf   Expects a bitfield comprised of the logical OR of one or more of
            the following symbols:

            DUALDR indicates that the framebuffers of two pipes are
            alternately swapped. This is known as Hyper-Pipline or Cyclops
            mode.

            NORMAL indicates that the normal framebuffer is to be swapped.

            OVERDR indicates that the overlay framebuffer is to be swapped.

            UNDERD indicates that the underlay framebuffer is to be swapped.

DESCRIPTION
     mswapb exchanges the front and back buffers of multiple framebuffers
     simultaneously.  Which framebuffers are to have their buffers exchanged
     is specified by the bitfield fbuf, the only argument.  The normal,
     overlay, and underlay framebuffers are specified with bitmasks NORMAL,
     OVERDR, and UNDERD.  These masks must be ORed together to generate the
     fbuf argument.  For example, both the normal and overlay framebuffers are
     swapped by the command: mswapb(NORMAL .OR. OVERDR).

     mswapb is executed during a vertical retrace period that closely follows
     the time of the request (usually the next vertical retrace).

     mswapb is ignored by framebuffers that are not in doublebuffer mode.

     The DUALDR mode interleaves the video output of two graphics pipelines.
     This gives you the opportunity to double your graphics performance or
     increase you scene complexity without sacrificing display update rate.

SEE ALSO
     double, drawmo, swapbu, swapin

NOTES
     The Personal Iris, Iris Entry, Indy, XL, XS, XS24, XZ, Elan and Extreme
     systems do not implement mswapb.

     The DUALDR mode is only supported on the SkyWriter model.  See the
     specific model owners manual for more details.