EDEN_CGL_DISPLAY_MODE


Structure to specify a mode at which to drive a display for a fullscreen OpenGL context.

typedef struct { 
    size_t width; 
    size_t height; 
    size_t depth; 
    CGRefreshRate refresh; 
    int display; 
    EDEN_BOOL syncToVBL; 
    EDEN_BOOL stereo; 
} EDEN_CGL_DISPLAY_MODE;  
Fields
width
Width of the desired display mode, in pixels (e.g. 640).
height
Height of the desired display mode, in pixels (e.g. 480).
depth
Depth of the desired display mode, in bits per pixel (e.g. 32).
refresh
Refresh rate of the desired display mode, in hertz (e.g. 60.0), or 0.0 if any available refresh rate may be used. Specifying a non-zero value for this parameter may have no effect on digitally-driven displays (e.g. LCD panels) which do not have a conventional refresh cycle.
display
Index to the display which is to be set to this mode. This is a zero-based index, where display 0 is always the main display.
display
A value of TRUE indicates that buffer swaps on this display should be synced to the vertical blanking interval (VBL) to prevent "tearing" which might occur when a swap occurs part way through a display refresh. Specifying a value for this parameter may have no effect for digitally-driven displays which do not have a VBL period.
Discussion

Prior to building an OpenGL fullscreen context on a display, it switches the display to a mode requested by user. This structure is used to specify the requested mode for a single display.

© 2001-2006 Philip Lamb Last Updated: Tuesday, April 05, 2005