mswapbuffers(3G)

NAME
     mswapbuffers - swap multiple framebuffers simultaneously

C SPECIFICATION
     void mswapbuffers(fbuf)
     long fbuf;

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

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

            NORMALDRAW indicates that the normal framebuffer is to be swapped.

            OVERDRAW indicates that the overlay framebuffer is to be swapped.

            UNDERDRAW indicates that the underlay framebuffer is to be
            swapped.

DESCRIPTION
     mswapbuffers 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 NORMALDRAW, OVERDRAW, and UNDERDRAW.  These masks must be ORed
     together to generate the fbuf argument.  For example, both the normal and
     overlay framebuffers are swapped by the command: mswapbuffers(NORMALDRAW
     | OVERDRAW).

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

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

     The DUALDRAW 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
     doublebuffer, drawmode, swapbuffers, swapinterval

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

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