Specify options that apply globally.
Available in Mac OS X v10.0 and later.
Declaration Syntax| C# | Visual Basic | Visual C++ |
public enum CGLGlobalOption
Public Enumeration CGLGlobalOption
public enum class CGLGlobalOption
Members| Member | Description |
|---|---|
| kCGLGOFormatCacheSize | The pixel format cache size, a positive integer. After an application calls CGLChoosePixelFormat for the last time, it may set the cache size to 1 to minimize the memory used by CGL. If an application intends to use n different attribute lists to choose n different pixel formats repeatedly, then the application should set the cache size to n to maximize performance. The cache size is initially set to 5. Available in Mac OS X v10.0 and later. |
| kCGLGOClearFormatCache | If set to a true value, the pixel format object cache contents are freed. This does not affect the size of the cache for future storage of pixel format objects. To minimize the memory consumed by the cache, the application should also set the cache size to 1 via the kCGLGOFormatCacheSize global option. CGLGetGlobalOption always reports a false value for this constant. Available in Mac OS X v10.0 and later. |
| kCGLGORetainRenderers | If true, CGL does not unload any plug-in renderers even if they are no longer in use. This constant is useful to improve the performance of applications that repeatedly destroy and recreate their only (or last) rendering context. Normally, when the last context created by a particular plug-in renderer is destroyed, that renderer is unloaded from memory. If false, CGL returns to its normal mode of operation and all renderers that are not in use are unloaded. Available in Mac OS X v10.0 and later. |
| kCGLGOResetLibrary | If set to a true value, CGL is reset to its initial state. All contexts created with CGLCreateContext are destroyed, all plug-in renderers are unloaded from memory, and global options are reset to their initial values. Renderer information objects and pixel format objects are not destroyed. CGLGetGlobalOption always reports a false value for this constant. (Deprecated. Deprecated in Mac OS X v10.4 or later.) Available in Mac OS X v10.0 and later. |
| kCGLGOUseErrorHandler | If true, CGL errors are propagated to Core Graphics. Available in Mac OS X v10.0 and later. |
| kCGLGOUseBuildCache | If true, the shader compiler utilizes more memory to cache portions of compiled shaders. Shaders that share similar code may be compiled more quickly when this is enabled. This feature is off by default, and must be enabled at startup. (Deprecated. Deprecated in Mac OS X v 10.6 or later.) Available in Mac OS X v10.5 and later. |
Version Information- Available in Monobjc Bridge: 10.6 (For Mac OS X 10.6 and later), 10.5 (For Mac OS X 10.5 and later)