Deprecated CGL Functions

A function identified as deprecated has been superseded and may become unsupported in the future.

Deprecated in Mac OS X v10.6

CGLSetFullScreen

Attaches a rendering context to its full-screen drawable object. (Deprecated in Mac OS X v10.6. Use CGLSetFullScreenOnDisplay instead.)

CGLError CGLSetFullScreen (
   CGLContextObj ctx
);

Parameters

ctx

A rendering context.

Discussion

Before calling this function, you must set up the rendering context using a pixel format object created with the kCGLPFAFullScreen attribute (see “Buffer and Renderer Attributes”). Some OpenGL renderers, such as the software renderer, do not support full-screen mode. After you call the function CGLChoosePixelFormat with the full-screen attribute, you need to check whether the pixel format object is created successfully.

You must capture the display prior to entering full-screen mode and release it after exiting. After calling this function, subsequent OpenGL drawing is rendered into the entire screen. For more information, see OpenGL Programming Guide for Mac OS X.

To exit full-screen mode, call CGLClearDrawable.

---