mswapbuffers(3G) 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.
Page 1
mswapbuffers(3G) mswapbuffers(3G)
Page 2