• Ken Thomases's avatar
    winemac: Add a new registry setting, OpenGLSurfaceMode, to control how GL… · 47708c26
    Ken Thomases authored
    winemac: Add a new registry setting, OpenGLSurfaceMode, to control how GL surfaces relate to the window.
    
    The default behavior is that GL surfaces are on top of all non-GL content in
    the window.  This maximizes the performance for the common case of games, but
    clipping by parents, siblings, and child windows isn't respected.
    
    Setting OpenGLSurfaceMode to "behind" pushes the GL surface to be behind the
    Mac window.  The window has transparent holes punched through it so that the GL
    surface shows through.  USER32 and the wineserver take care of making sure the
    holes are only where the GL windows would be unclipped and unoccluded.  Because
    the OS X window server has to composite the GL surface with the window, this
    limits the framerate.
    
    Since the Mac driver has no server-side rendering path, GDI rendering to a
    window which has a GL surface doesn't work.  As a partial workaround, mostly
    for cases where a GL surface is created but never used, setting
    OpenGLSurfaceMode to "transparent" allows the GDI rendering to show through the
    transparent parts of the GL surface.  The GDI rendering is drawn to the
    top-level window's surface as normal.  (The behavior of user32 to exclude the
    portion covered by a GL window from GDI rendering is disabled.)  The GL surface
    is in front of the window but potentially wholly or partially transparent.  It
    is composited with the window behind it.
    
    The GL surface is initially cleared to be completely transparent.  So, if
    no GL rendering is done, the window will appear as though the GL surface didn't
    exist.
    47708c26
Name
Last commit
Last update
..
.gitattributes Loading commit data...
Makefile.in Loading commit data...
clipboard.c Loading commit data...
cocoa_app.h Loading commit data...
cocoa_app.m Loading commit data...
cocoa_clipboard.m Loading commit data...
cocoa_display.m Loading commit data...
cocoa_event.h Loading commit data...
cocoa_event.m Loading commit data...
cocoa_main.m Loading commit data...
cocoa_opengl.h Loading commit data...
cocoa_opengl.m Loading commit data...
cocoa_status_item.m Loading commit data...
cocoa_window.h Loading commit data...
cocoa_window.m Loading commit data...
display.c Loading commit data...
dragdrop.c Loading commit data...
event.c Loading commit data...
gdi.c Loading commit data...
image.c Loading commit data...
ime.c Loading commit data...
keyboard.c Loading commit data...
macdrv.h Loading commit data...
macdrv_cocoa.h Loading commit data...
macdrv_main.c Loading commit data...
mouse.c Loading commit data...
opengl.c Loading commit data...
surface.c Loading commit data...
systray.c Loading commit data...
window.c Loading commit data...
winemac.drv.spec Loading commit data...