src/video/quartz/SDL_QuartzVideo.h
author Sam Lantinga
Sat, 09 Aug 2003 21:13:22 +0000
changeset 679 74b4b9f9e5e1
parent 656 864e2d2a9a55
child 761 c5b2b6d2d1fe
permissions -rw-r--r--
*** empty log message ***
slouken@47
     1
/*
slouken@47
     2
    SDL - Simple DirectMedia Layer
slouken@297
     3
    Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002  Sam Lantinga
slouken@47
     4
slouken@47
     5
    This library is free software; you can redistribute it and/or
slouken@47
     6
    modify it under the terms of the GNU Library General Public
slouken@47
     7
    License as published by the Free Software Foundation; either
slouken@47
     8
    version 2 of the License, or (at your option) any later version.
slouken@47
     9
slouken@47
    10
    This library is distributed in the hope that it will be useful,
slouken@47
    11
    but WITHOUT ANY WARRANTY; without even the implied warranty of
slouken@47
    12
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
slouken@47
    13
    Library General Public License for more details.
slouken@47
    14
slouken@47
    15
    You should have received a copy of the GNU Library General Public
slouken@47
    16
    License along with this library; if not, write to the Free
slouken@47
    17
    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
slouken@47
    18
slouken@47
    19
    Sam Lantinga
slouken@252
    20
    slouken@libsdl.org
slouken@47
    21
*/
slouken@47
    22
slouken@390
    23
/*    
slouken@47
    24
    @file   SDL_QuartzVideo.h
slouken@501
    25
    @author Darrell Walisser, Max Horn, et al.
slouken@47
    26
    
slouken@501
    27
    @abstract SDL video driver for Mac OS X.
slouken@47
    28
    
slouken@47
    29
    @discussion
slouken@47
    30
    
slouken@47
    31
    TODO
slouken@47
    32
        - Hardware Cursor support with NSCursor instead of Carbon
slouken@47
    33
        - Keyboard repeat/mouse speed adjust (if needed)
slouken@47
    34
        - Multiple monitor support (currently only main display)
slouken@47
    35
        - Accelerated blitting support
slouken@501
    36
        - Fix white OpenGL window on minimize (fixed) (update: broken again on 10.2)
slouken@501
    37
        - Find out what events should be sent/ignored if window is minimized
slouken@390
    38
        - Find a way to deal with external resolution/depth switch while app is running
slouken@501
    39
        - Resizeable windows (done)
slouken@272
    40
        - Check accuracy of QZ_SetGamma()
slouken@47
    41
    Problems:
slouken@47
    42
        - OGL not working in full screen with software renderer
slouken@47
    43
        - SetColors sets palette correctly but clears framebuffer
slouken@390
    44
        - Crash in CG after several mode switches (I think this has been fixed)
slouken@272
    45
        - Retained windows don't draw their title bar quite right (OS Bug) (not using retained windows)
slouken@501
    46
        - Cursor in 8 bit modes is screwy (might just be Radeon PCI bug) (update: not just Radeon)
slouken@272
    47
        - Warping cursor delays mouse events for a fraction of a second,
slouken@272
    48
          there is a hack around this that helps a bit
slouken@47
    49
*/
slouken@47
    50
slouken@272
    51
#include <Cocoa/Cocoa.h>
slouken@47
    52
#include <OpenGL/OpenGL.h>
slouken@656
    53
#include <OpenGL/gl.h>
slouken@656
    54
#include <OpenGL/glext.h>
slouken@47
    55
#include <Carbon/Carbon.h>
slouken@390
    56
#include <QuickTime/QuickTime.h>
slouken@561
    57
#include <IOKit/IOKitLib.h>	/* For powersave handling */
slouken@588
    58
#include <pthread.h>
slouken@47
    59
slouken@588
    60
#include "SDL_thread.h"
slouken@47
    61
#include "SDL_video.h"
slouken@47
    62
#include "SDL_error.h"
slouken@272
    63
#include "SDL_timer.h"
slouken@47
    64
#include "SDL_syswm.h"
slouken@47
    65
#include "SDL_sysvideo.h"
slouken@47
    66
#include "SDL_pixels_c.h"
slouken@47
    67
#include "SDL_events_c.h"
slouken@47
    68
slouken@435
    69
/* 
slouken@501
    70
    Add methods to get at private members of NSScreen. 
slouken@501
    71
    Since there is a bug in Apple's screen switching code
slouken@501
    72
    that does not update this variable when switching
slouken@501
    73
    to fullscreen, we'll set it manually (but only for the
slouken@501
    74
    main screen).
slouken@435
    75
*/
slouken@435
    76
@interface NSScreen (NSScreenAccess)
slouken@435
    77
- (void) setFrame:(NSRect)frame;
slouken@435
    78
@end
slouken@435
    79
slouken@435
    80
@implementation NSScreen (NSScreenAccess)
slouken@435
    81
- (void) setFrame:(NSRect)frame;
slouken@435
    82
{
slouken@435
    83
    _frame = frame;
slouken@435
    84
}
slouken@435
    85
@end
slouken@435
    86
slouken@501
    87
/* 
slouken@501
    88
    This is a workaround to directly access NSOpenGLContext's CGL context
slouken@501
    89
    We need this to check for errors NSOpenGLContext doesn't support
slouken@501
    90
*/
slouken@47
    91
@interface NSOpenGLContext (CGLContextAccess)
slouken@47
    92
- (CGLContextObj) cglContext;
slouken@47
    93
@end
slouken@47
    94
slouken@47
    95
@implementation NSOpenGLContext (CGLContextAccess)
slouken@47
    96
- (CGLContextObj) cglContext;
slouken@47
    97
{
slouken@47
    98
    return _contextAuxiliary;
slouken@47
    99
}
slouken@47
   100
@end
slouken@47
   101
slouken@501
   102
/* 
slouken@501
   103
    Structure for rez switch gamma fades
slouken@501
   104
    We can hide the monitor flicker by setting the gamma tables to 0
slouken@501
   105
*/
slouken@272
   106
#define QZ_GAMMA_TABLE_SIZE 256
slouken@272
   107
slouken@272
   108
typedef struct {
slouken@272
   109
slouken@272
   110
    CGGammaValue red[QZ_GAMMA_TABLE_SIZE];
slouken@272
   111
    CGGammaValue green[QZ_GAMMA_TABLE_SIZE];
slouken@272
   112
    CGGammaValue blue[QZ_GAMMA_TABLE_SIZE];
slouken@272
   113
slouken@272
   114
} SDL_QuartzGammaTable;
slouken@272
   115
slouken@272
   116
/* Main driver structure to store required state information */
slouken@47
   117
typedef struct SDL_PrivateVideoData {
slouken@47
   118
slouken@272
   119
    CGDirectDisplayID  display;            /* 0 == main display (only support single display) */
slouken@272
   120
    CFDictionaryRef    mode;               /* current mode of the display */
slouken@272
   121
    CFDictionaryRef    save_mode;          /* original mode of the display */
slouken@272
   122
    CFArrayRef         mode_list;          /* list of available fullscreen modes */
slouken@272
   123
    CGDirectPaletteRef palette;            /* palette of an 8-bit display */
slouken@501
   124
    NSOpenGLContext    *gl_context;        /* OpenGL rendering context */
slouken@272
   125
    Uint32             width, height, bpp; /* frequently used data about the display */
slouken@501
   126
    Uint32             flags;              /* flags for current mode, for teardown purposes */
slouken@272
   127
    Uint32             video_set;          /* boolean; indicates if video was set correctly */
slouken@272
   128
    Uint32             warp_flag;          /* boolean; notify to event loop that a warp just occured */
slouken@272
   129
    Uint32             warp_ticks;         /* timestamp when the warp occured */
slouken@272
   130
    NSWindow           *window;            /* Cocoa window to implement the SDL window */
slouken@501
   131
    NSQuickDrawView    *view;              /* the window's view; draw 2D and OpenGL into this view */
slouken@501
   132
    SDL_Surface        *resize_icon;       /* icon for the resize badge, we have to draw it by hand */
slouken@501
   133
    SDL_GrabMode       current_grab_mode;  /* default value is SDL_GRAB_OFF */
slouken@501
   134
    BOOL               in_foreground;      /* boolean; indicate if app is in foreground or not */
slouken@501
   135
    SDL_Rect           **client_mode_list; /* resolution list to pass back to client */
slouken@501
   136
    SDLKey             keymap[256];        /* Mac OS X to SDL key mapping */
slouken@501
   137
    Uint32             current_mods;       /* current keyboard modifiers, to track modifier state */
slouken@501
   138
    Uint32             last_virtual_button;/* last virtual mouse button pressed */
icculus@563
   139
    io_connect_t       power_connection;   /* used with IOKit to detect wake from sleep */
icculus@563
   140
    Uint8              expect_mouse_up;    /* used to determine when to send mouse up events */
icculus@563
   141
    Uint8              grab_state;         /* used to manage grab behavior */
icculus@563
   142
    NSPoint            cursor_loc;         /* saved cursor coords, for activate/deactivate when grabbed */
slouken@615
   143
    BOOL          	   cursor_visible;     /* tells if cursor was instructed to be hidden or not (SDL_ShowCursor) */
slouken@615
   144
    BOOL               cursor_hidden;      /* tells if cursor is *actually* hidden or not */
slouken@588
   145
    Uint8*             sw_buffers[2];      /* pointers to the two software buffers for double-buffer emulation */
slouken@588
   146
    SDL_Thread         *thread;            /* thread for async updates to the screen */
slouken@588
   147
    SDL_sem            *sem1, *sem2;       /* synchronization for async screen updates */
slouken@588
   148
    Uint8              *current_buffer;    /* the buffer being copied to the screen */
slouken@588
   149
    BOOL               quit_thread;        /* used to quit the async blitting thread */
icculus@563
   150
    
slouken@390
   151
    ImageDescriptionHandle yuv_idh;
slouken@390
   152
    MatrixRecordPtr        yuv_matrix;
slouken@390
   153
    DecompressorComponent  yuv_codec;
slouken@390
   154
    ImageSequence          yuv_seq;
slouken@390
   155
    PlanarPixmapInfoYUV420 *yuv_pixmap;
slouken@390
   156
    Sint16                  yuv_width, yuv_height;
slouken@390
   157
    CGrafPtr                yuv_port;
slouken@390
   158
slouken@47
   159
} SDL_PrivateVideoData ;
slouken@47
   160
slouken@390
   161
#define _THIS    SDL_VideoDevice *this
slouken@47
   162
#define display_id (this->hidden->display)
slouken@47
   163
#define mode (this->hidden->mode)
slouken@47
   164
#define save_mode (this->hidden->save_mode)
slouken@47
   165
#define mode_list (this->hidden->mode_list)
slouken@47
   166
#define palette (this->hidden->palette)
slouken@47
   167
#define gl_context (this->hidden->gl_context)
slouken@47
   168
#define device_width (this->hidden->width)
slouken@47
   169
#define device_height (this->hidden->height)
slouken@47
   170
#define device_bpp (this->hidden->bpp)
slouken@47
   171
#define mode_flags (this->hidden->flags)
slouken@158
   172
#define qz_window (this->hidden->window)
slouken@272
   173
#define window_view (this->hidden->view)
slouken@272
   174
#define video_set (this->hidden->video_set)
slouken@272
   175
#define warp_ticks (this->hidden->warp_ticks)
slouken@272
   176
#define warp_flag (this->hidden->warp_flag)
slouken@501
   177
#define resize_icon (this->hidden->resize_icon)
slouken@501
   178
#define current_grab_mode (this->hidden->current_grab_mode)
slouken@501
   179
#define in_foreground (this->hidden->in_foreground)
slouken@501
   180
#define client_mode_list (this->hidden->client_mode_list)
slouken@501
   181
#define keymap (this->hidden->keymap)
slouken@501
   182
#define current_mods (this->hidden->current_mods)
slouken@501
   183
#define last_virtual_button (this->hidden->last_virtual_button)
icculus@563
   184
#define power_connection (this->hidden->power_connection)
icculus@563
   185
#define expect_mouse_up (this->hidden->expect_mouse_up)
icculus@563
   186
#define grab_state (this->hidden->grab_state)
icculus@563
   187
#define cursor_loc (this->hidden->cursor_loc)
icculus@563
   188
#define cursor_visible (this->hidden->cursor_visible)
slouken@615
   189
#define cursor_hidden (this->hidden->cursor_hidden)
slouken@588
   190
#define sw_buffers (this->hidden->sw_buffers)
slouken@588
   191
#define thread (this->hidden->thread)
slouken@588
   192
#define sem1 (this->hidden->sem1)
slouken@588
   193
#define sem2 (this->hidden->sem2)
slouken@588
   194
#define current_buffer (this->hidden->current_buffer)
slouken@588
   195
#define quit_thread (this->hidden->quit_thread)
slouken@501
   196
slouken@390
   197
#define yuv_idh (this->hidden->yuv_idh)
slouken@390
   198
#define yuv_matrix (this->hidden->yuv_matrix)
slouken@390
   199
#define yuv_codec (this->hidden->yuv_codec)
slouken@390
   200
#define yuv_seq (this->hidden->yuv_seq)
slouken@390
   201
#define yuv_pixmap (this->hidden->yuv_pixmap)
slouken@390
   202
#define yuv_data (this->hidden->yuv_data)
slouken@390
   203
#define yuv_width (this->hidden->yuv_width)
slouken@390
   204
#define yuv_height (this->hidden->yuv_height)
slouken@390
   205
#define yuv_port (this->hidden->yuv_port)
slouken@272
   206
icculus@563
   207
icculus@563
   208
/* grab states - the input is in one of these states */
icculus@563
   209
enum {
icculus@563
   210
    QZ_UNGRABBED = 0,
icculus@563
   211
    QZ_VISIBLE_GRAB,
icculus@563
   212
    QZ_INVISIBLE_GRAB
icculus@563
   213
};
icculus@563
   214
icculus@563
   215
/* grab actions - these can change the grabbed state */
icculus@563
   216
enum {
icculus@563
   217
    QZ_ENABLE_GRAB = 0,
icculus@563
   218
    QZ_DISABLE_GRAB,
icculus@563
   219
    QZ_HIDECURSOR,
icculus@563
   220
    QZ_SHOWCURSOR
icculus@563
   221
};
icculus@563
   222
slouken@501
   223
/* 
slouken@501
   224
    Obscuring code: maximum number of windows above ours (inclusive) 
slouken@501
   225
    
slouken@501
   226
    Note: this doesn't work too well in practice and should be
slouken@501
   227
    phased out when we add OpenGL 2D acceleration. It was never
slouken@501
   228
    enabled in the first place, so this shouldn't be a problem ;-)
slouken@501
   229
*/
slouken@272
   230
#define kMaxWindows 256
slouken@272
   231
slouken@272
   232
/* Some of the Core Graphics Server API for obscuring code */
slouken@272
   233
#define kCGSWindowLevelTop          2147483632
slouken@272
   234
#define kCGSWindowLevelDockIconDrag 500
slouken@272
   235
#define kCGSWindowLevelDockMenu     101
slouken@272
   236
#define kCGSWindowLevelMenuIgnore    21
slouken@272
   237
#define kCGSWindowLevelMenu          20
slouken@272
   238
#define kCGSWindowLevelDockLabel     12
slouken@272
   239
#define kCGSWindowLevelDockIcon      11
slouken@272
   240
#define kCGSWindowLevelDock          10
slouken@272
   241
#define kCGSWindowLevelUtility        3
slouken@272
   242
#define kCGSWindowLevelNormal         0
slouken@272
   243
slouken@501
   244
/* 
slouken@501
   245
    For completeness; We never use these window levels, they are always below us
slouken@501
   246
    #define kCGSWindowLevelMBarShadow -20
slouken@501
   247
    #define kCGSWindowLevelDesktopPicture -2147483647
slouken@501
   248
    #define kCGSWindowLevelDesktop        -2147483648
slouken@272
   249
*/
slouken@47
   250
slouken@272
   251
typedef CGError       CGSError;
slouken@390
   252
typedef long          CGSWindowCount;
slouken@390
   253
typedef void *        CGSConnectionID;
slouken@390
   254
typedef int           CGSWindowID;
slouken@272
   255
typedef CGSWindowID*  CGSWindowIDList;
slouken@272
   256
typedef CGWindowLevel CGSWindowLevel;
slouken@272
   257
typedef NSRect        CGSRect;
slouken@272
   258
slouken@272
   259
extern CGSConnectionID _CGSDefaultConnection ();
slouken@272
   260
slouken@390
   261
extern CGSError CGSGetOnScreenWindowList (CGSConnectionID cid,
slouken@272
   262
                                          CGSConnectionID owner,
slouken@272
   263
                                          CGSWindowCount listCapacity,
slouken@272
   264
                                          CGSWindowIDList list,
slouken@272
   265
                                          CGSWindowCount *listCount);
slouken@272
   266
slouken@272
   267
extern CGSError CGSGetScreenRectForWindow (CGSConnectionID cid,
slouken@272
   268
                                           CGSWindowID wid,
slouken@272
   269
                                           CGSRect *rect);
slouken@272
   270
slouken@272
   271
extern CGWindowLevel CGSGetWindowLevel (CGSConnectionID cid,
slouken@272
   272
                                        CGSWindowID wid,
slouken@272
   273
                                        CGSWindowLevel *level);
slouken@390
   274
slouken@390
   275
extern CGSError CGSDisplayHWFill (CGDirectDisplayID id, unsigned int x, unsigned int y,
slouken@390
   276
                                  unsigned int w, unsigned int h, unsigned int color);
slouken@272
   277
slouken@272
   278
extern CGSError CGSDisplayCanHWFill (CGDirectDisplayID id);
slouken@272
   279
slouken@272
   280
extern CGSError CGSGetMouseEnabledFlags (CGSConnectionID cid, CGSWindowID wid, int *flags);
slouken@47
   281
slouken@588
   282
int CGSDisplayHWSync (CGDirectDisplayID id);
slouken@588
   283
slouken@47
   284
/* Bootstrap functions */
slouken@47
   285
static int              QZ_Available ();
slouken@47
   286
static SDL_VideoDevice* QZ_CreateDevice (int device_index);
slouken@47
   287
static void             QZ_DeleteDevice (SDL_VideoDevice *device);
slouken@47
   288
slouken@47
   289
/* Initialization, Query, Setup, and Redrawing functions */
slouken@47
   290
static int          QZ_VideoInit        (_THIS, SDL_PixelFormat *video_format);
slouken@47
   291
slouken@390
   292
static SDL_Rect**   QZ_ListModes        (_THIS, SDL_PixelFormat *format,
slouken@390
   293
                                         Uint32 flags);
slouken@47
   294
static void         QZ_UnsetVideoMode   (_THIS);
slouken@47
   295
slouken@390
   296
static SDL_Surface* QZ_SetVideoMode     (_THIS, SDL_Surface *current,
slouken@390
   297
                                         int width, int height, int bpp,
slouken@390
   298
                                         Uint32 flags);
slouken@47
   299
static int          QZ_ToggleFullScreen (_THIS, int on);
slouken@390
   300
static int          QZ_SetColors        (_THIS, int first_color,
slouken@390
   301
                                         int num_colors, SDL_Color *colors);
slouken@588
   302
slouken@588
   303
static int          QZ_LockDoubleBuffer   (_THIS, SDL_Surface *surface);
slouken@588
   304
static void         QZ_UnlockDoubleBuffer (_THIS, SDL_Surface *surface);
slouken@588
   305
static int          QZ_ThreadFlip         (_THIS);
slouken@588
   306
static int          QZ_FlipDoubleBuffer   (_THIS, SDL_Surface *surface);
slouken@588
   307
static void         QZ_DoubleBufferUpdate (_THIS, int num_rects, SDL_Rect *rects);
slouken@588
   308
slouken@47
   309
static void         QZ_DirectUpdate     (_THIS, int num_rects, SDL_Rect *rects);
slouken@501
   310
static int          QZ_LockWindow       (_THIS, SDL_Surface *surface);
slouken@498
   311
static void         QZ_UnlockWindow     (_THIS, SDL_Surface *surface);
slouken@47
   312
static void         QZ_UpdateRects      (_THIS, int num_rects, SDL_Rect *rects);
slouken@47
   313
static void         QZ_VideoQuit        (_THIS);
slouken@47
   314
slouken@47
   315
/* Hardware surface functions (for fullscreen mode only) */
slouken@679
   316
#if 0 /* Not used (apparently, it's really slow) */
slouken@47
   317
static int  QZ_FillHWRect (_THIS, SDL_Surface *dst, SDL_Rect *rect, Uint32 color);
slouken@679
   318
#endif
slouken@47
   319
static int  QZ_LockHWSurface(_THIS, SDL_Surface *surface);
slouken@47
   320
static void QZ_UnlockHWSurface(_THIS, SDL_Surface *surface);
slouken@47
   321
static void QZ_FreeHWSurface (_THIS, SDL_Surface *surface);
slouken@47
   322
/* static int  QZ_FlipHWSurface (_THIS, SDL_Surface *surface); */
slouken@47
   323
slouken@47
   324
/* Gamma Functions */
slouken@47
   325
static int QZ_SetGamma     (_THIS, float red, float green, float blue);
slouken@47
   326
static int QZ_GetGamma     (_THIS, float *red, float *green, float *blue);
slouken@47
   327
static int QZ_SetGammaRamp (_THIS, Uint16 *ramp);
slouken@47
   328
static int QZ_GetGammaRamp (_THIS, Uint16 *ramp);
slouken@47
   329
slouken@47
   330
/* OpenGL functions */
slouken@501
   331
static int    QZ_SetupOpenGL       (_THIS, int bpp, Uint32 flags);
slouken@501
   332
static void   QZ_TearDownOpenGL    (_THIS);
slouken@47
   333
static void*  QZ_GL_GetProcAddress (_THIS, const char *proc);
slouken@47
   334
static int    QZ_GL_GetAttribute   (_THIS, SDL_GLattr attrib, int* value);
slouken@47
   335
static int    QZ_GL_MakeCurrent    (_THIS);
slouken@47
   336
static void   QZ_GL_SwapBuffers    (_THIS);
slouken@47
   337
static int    QZ_GL_LoadLibrary    (_THIS, const char *location);
slouken@47
   338
slouken@47
   339
/* Private function to warp the cursor (used internally) */
slouken@272
   340
static void  QZ_PrivateWarpCursor (_THIS, int x, int y);
slouken@47
   341
slouken@47
   342
/* Cursor and Mouse functions */
slouken@47
   343
static void         QZ_FreeWMCursor     (_THIS, WMcursor *cursor);
slouken@390
   344
static WMcursor*    QZ_CreateWMCursor   (_THIS, Uint8 *data, Uint8 *mask,
slouken@390
   345
                                         int w, int h, int hot_x, int hot_y);
slouken@47
   346
static int          QZ_ShowWMCursor     (_THIS, WMcursor *cursor);
slouken@47
   347
static void         QZ_WarpWMCursor     (_THIS, Uint16 x, Uint16 y);
slouken@47
   348
static void         QZ_MoveWMCursor     (_THIS, int x, int y);
slouken@47
   349
static void         QZ_CheckMouseMode   (_THIS);
slouken@47
   350
slouken@47
   351
/* Event functions */
slouken@47
   352
static void         QZ_InitOSKeymap     (_THIS);
slouken@47
   353
static void         QZ_PumpEvents       (_THIS);
slouken@47
   354
slouken@47
   355
/* Window Manager functions */
slouken@501
   356
static void QZ_SetCaption        (_THIS, const char *title, const char *icon);
slouken@501
   357
static void QZ_SetIcon           (_THIS, SDL_Surface *icon, Uint8 *mask);
slouken@501
   358
static int  QZ_IconifyWindow     (_THIS);
slouken@47
   359
static SDL_GrabMode QZ_GrabInput (_THIS, SDL_GrabMode grab_mode);
slouken@47
   360
/*static int  QZ_GetWMInfo     (_THIS, SDL_SysWMinfo *info);*/
slouken@272
   361
slouken@390
   362
/* YUV functions */
slouken@390
   363
static SDL_Overlay* QZ_CreateYUVOverlay (_THIS, int width, int height,
slouken@561
   364
                                         Uint32 format, SDL_Surface *display);