mswapbuffers(3G)					      mswapbuffers(3G)

NAME    [Toc]    [Back]

     mswapbuffers - swap multiple framebuffers simultaneously

C SPECIFICATION    [Toc]    [Back]

     void mswapbuffers(fbuf)
     long fbuf;

PARAMETERS    [Toc]    [Back]

     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    [Toc]    [Back]

     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    [Toc]    [Back]

     doublebuffer, drawmode, swapbuffers, swapinterval

NOTES    [Toc]    [Back]

     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)


									PPPPaaaaggggeeee 2222