with-double-buffering

Arguments: ((window) &body body

This macro should not be needed by most applications. Normally you would achieve double-buffering by enabling the double-buffered property of a window and ensuring that you draw in the window only in a redisplay-window method that Common Graphics calls automatically. See double-buffered for complete information about this property.

But if for some reason you need to draw on a window directly rather than using the usual redisplay-window callback paradigm, and you still want to use double-buffering, then you can do so by wrapping a call to with-double-buffering around the drawing code. This macro will copy the window's memory bitmap to the visible window at the end of its body, just as Common Graphics otherwise does just after it has called redisplay-window.

When using with-double-buffering, the double-buffered property of the window must still be true in order for double-buffering to occur.

Copyright (c) 1998-2016, Franz Inc. Oakland, CA., USA. All rights reserved.
This page was not revised from the 8.1 page.
Created 2010.1.21.