Edit AllPages

NSCopyBits() lets you copy raw pixels around. It is a thin wrapper around     memcpy().

NSCopyBits(), or something like it, is used in     NSClipView when it     -copiesOnScroll.

Officially, you can either pass a valid GState or pass NSNullObject (nobody knows what that is, but it apparently means 0) to draw into the current graphics context. Passing a GState seems to do nothing though, so take the latter route. You can use it in -[NSView drawRect:] like normal, but NSCopyBits() is primarily useful for IncrementalDrawing�it relies on what was already drawn�so it can make sense to use it elsewhere. That means bracketing your drawing with -lockFocusIfCanDraw and -unlockFocus.

Copying leaves the source area alone (except where the destination intersects). Normally you will want to draw new content over it.

NSCopyBits() has a number of bugs that prevent me from recommending it wholeheartedly:

If you can require TigerOrLater, consider using CGLayer.

Copying pixels around is faster than redrawing images, and is much faster than rendering complex content. However, it’s slower than:

2007/11/23: The bugs mentioned above seem to have been fixed, either in 10.5 or 10.5.1. Now it works perfectly, and seems to be just as fast as moving an OpenGL texture (Mac Mini 1.83GHz, Intel GMA 950). Since I’m not entirely sure what fixed it, and it may still be relevant for 10.5.0, I won’t remove the list from this page for now.