Skip to content

Latest commit

 

History

History
1663 lines (1296 loc) · 55.2 KB

SDL_QuartzVideo.m

File metadata and controls

1663 lines (1296 loc) · 55.2 KB
 
1
2
/*
SDL - Simple DirectMedia Layer
Jan 4, 2004
Jan 4, 2004
3
Copyright (C) 1997-2003 Sam Lantinga
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Library General Public
License as published by the Free Software Foundation; either
version 2 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Library General Public License for more details.
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
Sam Lantinga
Dec 14, 2001
Dec 14, 2001
20
slouken@libsdl.org
Feb 21, 2006
Feb 21, 2006
22
#include "SDL_config.h"
23
24
#include "SDL_QuartzVideo.h"
Jan 4, 2004
Jan 4, 2004
25
#include "SDL_QuartzWindow.h"
Jan 4, 2004
Jan 4, 2004
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
/*
Add methods to get at private members of NSScreen.
Since there is a bug in Apple's screen switching code
that does not update this variable when switching
to fullscreen, we'll set it manually (but only for the
main screen).
*/
@interface NSScreen (NSScreenAccess)
- (void) setFrame:(NSRect)frame;
@end
@implementation NSScreen (NSScreenAccess)
- (void) setFrame:(NSRect)frame;
{
_frame = frame;
}
@end
/* Bootstrap functions */
static int QZ_Available ();
static SDL_VideoDevice* QZ_CreateDevice (int device_index);
static void QZ_DeleteDevice (SDL_VideoDevice *device);
/* Initialization, Query, Setup, and Redrawing functions */
static int QZ_VideoInit (_THIS, SDL_PixelFormat *video_format);
static SDL_Rect** QZ_ListModes (_THIS, SDL_PixelFormat *format,
Uint32 flags);
Feb 7, 2006
Feb 7, 2006
56
static void QZ_UnsetVideoMode (_THIS, BOOL to_desktop);
Jan 4, 2004
Jan 4, 2004
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
static SDL_Surface* QZ_SetVideoMode (_THIS, SDL_Surface *current,
int width, int height, int bpp,
Uint32 flags);
static int QZ_ToggleFullScreen (_THIS, int on);
static int QZ_SetColors (_THIS, int first_color,
int num_colors, SDL_Color *colors);
static int QZ_LockDoubleBuffer (_THIS, SDL_Surface *surface);
static void QZ_UnlockDoubleBuffer (_THIS, SDL_Surface *surface);
static int QZ_ThreadFlip (_THIS);
static int QZ_FlipDoubleBuffer (_THIS, SDL_Surface *surface);
static void QZ_DoubleBufferUpdate (_THIS, int num_rects, SDL_Rect *rects);
static void QZ_DirectUpdate (_THIS, int num_rects, SDL_Rect *rects);
static int QZ_LockWindow (_THIS, SDL_Surface *surface);
static void QZ_UnlockWindow (_THIS, SDL_Surface *surface);
static void QZ_UpdateRects (_THIS, int num_rects, SDL_Rect *rects);
static void QZ_VideoQuit (_THIS);
/* Hardware surface functions (for fullscreen mode only) */
#if 0 /* Not used (apparently, it's really slow) */
static int QZ_FillHWRect (_THIS, SDL_Surface *dst, SDL_Rect *rect, Uint32 color);
#endif
static int QZ_LockHWSurface(_THIS, SDL_Surface *surface);
static void QZ_UnlockHWSurface(_THIS, SDL_Surface *surface);
Aug 18, 2005
Aug 18, 2005
83
static int QZ_AllocHWSurface(_THIS, SDL_Surface *surface);
Jan 4, 2004
Jan 4, 2004
84
85
static void QZ_FreeHWSurface (_THIS, SDL_Surface *surface);
/* static int QZ_FlipHWSurface (_THIS, SDL_Surface *surface); */
86
87
88
/* Bootstrap binding, enables entry point into the driver */
VideoBootStrap QZ_bootstrap = {
Jan 22, 2002
Jan 22, 2002
89
"Quartz", "Mac OS X CoreGraphics", QZ_Available, QZ_CreateDevice
Feb 1, 2003
Feb 1, 2003
92
93
94
95
96
97
98
99
/* Bootstrap functions */
static int QZ_Available () {
return 1;
}
static SDL_VideoDevice* QZ_CreateDevice (int device_index) {
Jan 22, 2002
Jan 22, 2002
100
#pragma unused (device_index)
101
102
103
104
SDL_VideoDevice *device;
SDL_PrivateVideoData *hidden;
May 1, 2006
May 1, 2006
105
106
device = (SDL_VideoDevice*) SDL_malloc (sizeof (*device) );
hidden = (SDL_PrivateVideoData*) SDL_malloc (sizeof (*hidden) );
107
108
109
110
if (device == NULL || hidden == NULL)
SDL_OutOfMemory ();
May 1, 2006
May 1, 2006
111
112
SDL_memset (device, 0, sizeof (*device) );
SDL_memset (hidden, 0, sizeof (*hidden) );
Jan 22, 2002
Jan 22, 2002
113
114
115
116
117
118
119
device->hidden = hidden;
device->VideoInit = QZ_VideoInit;
device->ListModes = QZ_ListModes;
device->SetVideoMode = QZ_SetVideoMode;
device->ToggleFullScreen = QZ_ToggleFullScreen;
Jan 2, 2006
Jan 2, 2006
120
device->UpdateMouse = QZ_UpdateMouse;
121
122
123
device->SetColors = QZ_SetColors;
/* device->UpdateRects = QZ_UpdateRects; this is determined by SetVideoMode() */
device->VideoQuit = QZ_VideoQuit;
Jan 22, 2002
Jan 22, 2002
124
125
126
device->LockHWSurface = QZ_LockHWSurface;
device->UnlockHWSurface = QZ_UnlockHWSurface;
Aug 18, 2005
Aug 18, 2005
127
device->AllocHWSurface = QZ_AllocHWSurface;
128
129
130
131
132
133
134
135
136
137
138
139
140
device->FreeHWSurface = QZ_FreeHWSurface;
/* device->FlipHWSurface = QZ_FlipHWSurface */;
device->SetGamma = QZ_SetGamma;
device->GetGamma = QZ_GetGamma;
device->SetGammaRamp = QZ_SetGammaRamp;
device->GetGammaRamp = QZ_GetGammaRamp;
device->GL_GetProcAddress = QZ_GL_GetProcAddress;
device->GL_GetAttribute = QZ_GL_GetAttribute;
device->GL_MakeCurrent = QZ_GL_MakeCurrent;
device->GL_SwapBuffers = QZ_GL_SwapBuffers;
device->GL_LoadLibrary = QZ_GL_LoadLibrary;
Jan 22, 2002
Jan 22, 2002
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
device->FreeWMCursor = QZ_FreeWMCursor;
device->CreateWMCursor = QZ_CreateWMCursor;
device->ShowWMCursor = QZ_ShowWMCursor;
device->WarpWMCursor = QZ_WarpWMCursor;
device->MoveWMCursor = QZ_MoveWMCursor;
device->CheckMouseMode = QZ_CheckMouseMode;
device->InitOSKeymap = QZ_InitOSKeymap;
device->PumpEvents = QZ_PumpEvents;
device->SetCaption = QZ_SetCaption;
device->SetIcon = QZ_SetIcon;
device->IconifyWindow = QZ_IconifyWindow;
/*device->GetWMInfo = QZ_GetWMInfo;*/
device->GrabInput = QZ_GrabInput;
Jan 22, 2002
Jan 22, 2002
156
Jun 1, 2002
Jun 1, 2002
157
158
159
device->CreateYUVOverlay = QZ_CreateYUVOverlay;
device->free = QZ_DeleteDevice;
Jan 22, 2002
Jan 22, 2002
160
161
162
163
164
165
return device;
}
static void QZ_DeleteDevice (SDL_VideoDevice *device) {
May 1, 2006
May 1, 2006
166
167
SDL_free (device->hidden);
SDL_free (device);
168
169
170
171
}
static int QZ_VideoInit (_THIS, SDL_PixelFormat *video_format) {
Jul 11, 2007
Jul 11, 2007
172
NSRect r = NSMakeRect(0.0, 0.0, 0.0, 0.0);
Apr 6, 2007
Apr 6, 2007
173
174
const char *env = NULL;
Jan 22, 2002
Jan 22, 2002
175
176
177
178
179
/* Initialize the video settings; this data persists between mode switches */
display_id = kCGDirectMainDisplay;
save_mode = CGDisplayCurrentMode (display_id);
mode_list = CGDisplayAvailableModes (display_id);
palette = CGPaletteCreateDefaultColorPalette ();
Apr 6, 2007
Apr 6, 2007
181
182
183
env = SDL_getenv("SDL_VIDEO_ALLOW_SCREENSAVER");
allow_screensaver = ( env && SDL_atoi(env) ) ? YES : NO;
Jan 22, 2002
Jan 22, 2002
184
185
186
/* Gather some information that is useful to know about the display */
CFNumberGetValue (CFDictionaryGetValue (save_mode, kCGDisplayBitsPerPixel),
kCFNumberSInt32Type, &device_bpp);
Jan 22, 2002
Jan 22, 2002
188
189
190
191
192
193
CFNumberGetValue (CFDictionaryGetValue (save_mode, kCGDisplayWidth),
kCFNumberSInt32Type, &device_width);
CFNumberGetValue (CFDictionaryGetValue (save_mode, kCGDisplayHeight),
kCFNumberSInt32Type, &device_height);
Mar 15, 2006
Mar 15, 2006
194
195
196
197
198
/* Determine the current screen size */
this->info.current_w = device_width;
this->info.current_h = device_height;
/* Determine the default screen depth */
Jan 22, 2002
Jan 22, 2002
199
200
video_format->BitsPerPixel = device_bpp;
Oct 5, 2002
Oct 5, 2002
201
202
/* Set misc globals */
current_grab_mode = SDL_GRAB_OFF;
Jan 4, 2004
Jan 4, 2004
203
cursor_should_be_visible = YES;
Jan 7, 2004
Jan 7, 2004
204
cursor_visible = YES;
Feb 15, 2004
Feb 15, 2004
205
current_mods = 0;
Jul 11, 2007
Jul 11, 2007
206
field_edit = [[NSTextView alloc] initWithFrame:r];
Oct 5, 2002
Oct 5, 2002
207
Mar 22, 2004
Mar 22, 2004
208
209
if ( Gestalt(gestaltSystemVersion, &system_version) != noErr )
system_version = 0;
Aug 20, 2004
Aug 20, 2004
210
Dec 7, 2002
Dec 7, 2002
211
212
213
/* register for sleep notifications so wake from sleep generates SDL_VIDEOEXPOSE */
QZ_RegisterForSleepNotifications (this);
Jan 26, 2006
Jan 26, 2006
214
215
216
/* Fill in some window manager capabilities */
this->info.wm_available = 1;
Jan 22, 2002
Jan 22, 2002
217
return 0;
218
219
220
}
static SDL_Rect** QZ_ListModes (_THIS, SDL_PixelFormat *format, Uint32 flags) {
Jun 1, 2002
Jun 1, 2002
221
Jan 22, 2002
Jan 22, 2002
222
CFIndex num_modes;
223
224
225
CFIndex i;
int list_size = 0;
Jun 1, 2002
Jun 1, 2002
226
227
228
229
/* Any windowed mode is acceptable */
if ( (flags & SDL_FULLSCREEN) == 0 )
return (SDL_Rect**)-1;
Jun 1, 2002
Jun 1, 2002
230
231
/* Free memory from previous call, if any */
Oct 5, 2002
Oct 5, 2002
232
if ( client_mode_list != NULL ) {
Jun 1, 2002
Jun 1, 2002
234
int i;
Oct 5, 2002
Oct 5, 2002
236
for (i = 0; client_mode_list[i] != NULL; i++)
May 1, 2006
May 1, 2006
237
SDL_free (client_mode_list[i]);
May 1, 2006
May 1, 2006
239
SDL_free (client_mode_list);
Oct 5, 2002
Oct 5, 2002
240
client_mode_list = NULL;
Jun 1, 2002
Jun 1, 2002
242
Jan 22, 2002
Jan 22, 2002
243
244
num_modes = CFArrayGetCount (mode_list);
245
/* Build list of modes with the requested bpp */
Aug 19, 2001
Aug 19, 2001
246
for (i = 0; i < num_modes; i++) {
Jun 1, 2002
Jun 1, 2002
247
Aug 19, 2001
Aug 19, 2001
248
249
CFDictionaryRef onemode;
CFNumberRef number;
Jun 1, 2002
Jun 1, 2002
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
int bpp;
onemode = CFArrayGetValueAtIndex (mode_list, i);
number = CFDictionaryGetValue (onemode, kCGDisplayBitsPerPixel);
CFNumberGetValue (number, kCFNumberSInt32Type, &bpp);
if (bpp == format->BitsPerPixel) {
int intvalue;
int hasMode;
int width, height;
number = CFDictionaryGetValue (onemode, kCGDisplayWidth);
CFNumberGetValue (number, kCFNumberSInt32Type, &intvalue);
width = (Uint16) intvalue;
number = CFDictionaryGetValue (onemode, kCGDisplayHeight);
CFNumberGetValue (number, kCFNumberSInt32Type, &intvalue);
height = (Uint16) intvalue;
/* Check if mode is already in the list */
{
int i;
hasMode = SDL_FALSE;
for (i = 0; i < list_size; i++) {
Oct 5, 2002
Oct 5, 2002
275
276
if (client_mode_list[i]->w == width &&
client_mode_list[i]->h == height) {
Jun 1, 2002
Jun 1, 2002
277
278
279
hasMode = SDL_TRUE;
break;
}
Aug 19, 2001
Aug 19, 2001
280
281
}
}
Jun 1, 2002
Jun 1, 2002
282
283
284
285
286
287
288
289
/* Grow the list and add mode to the list */
if ( ! hasMode ) {
SDL_Rect *rect;
list_size++;
Oct 5, 2002
Oct 5, 2002
290
291
if (client_mode_list == NULL)
client_mode_list = (SDL_Rect**)
May 1, 2006
May 1, 2006
292
SDL_malloc (sizeof(*client_mode_list) * (list_size+1) );
Jun 1, 2002
Jun 1, 2002
293
else
Oct 5, 2002
Oct 5, 2002
294
client_mode_list = (SDL_Rect**)
May 1, 2006
May 1, 2006
295
SDL_realloc (client_mode_list, sizeof(*client_mode_list) * (list_size+1));
Jun 1, 2002
Jun 1, 2002
296
May 1, 2006
May 1, 2006
297
rect = (SDL_Rect*) SDL_malloc (sizeof(**client_mode_list));
Jun 1, 2002
Jun 1, 2002
298
Oct 5, 2002
Oct 5, 2002
299
if (client_mode_list == NULL || rect == NULL) {
Jun 1, 2002
Jun 1, 2002
300
301
302
303
SDL_OutOfMemory ();
return NULL;
}
Jan 2, 2006
Jan 2, 2006
304
rect->x = rect->y = 0;
Jun 1, 2002
Jun 1, 2002
305
306
307
rect->w = width;
rect->h = height;
Oct 5, 2002
Oct 5, 2002
308
309
client_mode_list[list_size-1] = rect;
client_mode_list[list_size] = NULL;
Jan 22, 2002
Jan 22, 2002
310
}
Jun 1, 2002
Jun 1, 2002
313
Aug 19, 2001
Aug 19, 2001
314
315
316
317
318
/* Sort list largest to smallest (by area) */
{
int i, j;
for (i = 0; i < list_size; i++) {
for (j = 0; j < list_size-1; j++) {
Jun 1, 2002
Jun 1, 2002
319
Aug 19, 2001
Aug 19, 2001
320
int area1, area2;
Oct 5, 2002
Oct 5, 2002
321
322
area1 = client_mode_list[j]->w * client_mode_list[j]->h;
area2 = client_mode_list[j+1]->w * client_mode_list[j+1]->h;
Jun 1, 2002
Jun 1, 2002
323
Aug 19, 2001
Aug 19, 2001
324
if (area1 < area2) {
Oct 5, 2002
Oct 5, 2002
325
326
327
SDL_Rect *tmp = client_mode_list[j];
client_mode_list[j] = client_mode_list[j+1];
client_mode_list[j+1] = tmp;
Aug 19, 2001
Aug 19, 2001
328
329
330
331
}
}
}
}
Oct 5, 2002
Oct 5, 2002
332
return client_mode_list;
Jul 23, 2003
Jul 23, 2003
335
336
337
338
339
340
341
342
343
344
345
static SDL_bool QZ_WindowPosition(_THIS, int *x, int *y)
{
const char *window = getenv("SDL_VIDEO_WINDOW_POS");
if ( window ) {
if ( sscanf(window, "%d,%d", x, y) == 2 ) {
return SDL_TRUE;
}
}
return SDL_FALSE;
}
Feb 7, 2006
Feb 7, 2006
346
static void QZ_UnsetVideoMode (_THIS, BOOL to_desktop) {
347
348
/* Reset values that may change between switches */
Oct 5, 2002
Oct 5, 2002
349
350
351
352
353
354
this->info.blit_fill = 0;
this->FillHWRect = NULL;
this->UpdateRects = NULL;
this->LockHWSurface = NULL;
this->UnlockHWSurface = NULL;
Jan 22, 2002
Jan 22, 2002
355
/* Release fullscreen resources */
356
if ( mode_flags & SDL_FULLSCREEN ) {
Jan 22, 2002
Jan 22, 2002
357
Aug 12, 2002
Aug 12, 2002
358
359
NSRect screen_rect;
Feb 1, 2003
Feb 1, 2003
360
/* Release double buffer stuff */
Sep 27, 2005
Sep 27, 2005
361
if ( mode_flags & SDL_DOUBLEBUF) {
Feb 1, 2003
Feb 1, 2003
362
363
364
365
366
quit_thread = YES;
SDL_SemPost (sem1);
SDL_WaitThread (thread, NULL);
SDL_DestroySemaphore (sem1);
SDL_DestroySemaphore (sem2);
May 1, 2006
May 1, 2006
367
SDL_free (sw_buffers[0]);
Feb 1, 2003
Feb 1, 2003
368
369
}
Jul 14, 2007
Jul 14, 2007
370
371
372
373
374
375
376
/* If we still have a valid window, close it. */
if ( qz_window ) {
[ qz_window close ];
[ qz_window release ];
qz_window = nil;
window_view = nil;
}
Oct 5, 2002
Oct 5, 2002
377
378
379
380
381
382
/*
Release the OpenGL context
Do this first to avoid trash on the display before fade
*/
if ( mode_flags & SDL_OPENGL ) {
Jan 22, 2002
Jan 22, 2002
383
QZ_TearDownOpenGL (this);
Oct 5, 2002
Oct 5, 2002
384
385
CGLSetFullScreen (NULL);
}
Feb 7, 2006
Feb 7, 2006
386
if (to_desktop) {
Sep 24, 2006
Sep 24, 2006
387
ShowMenuBar ();
Feb 7, 2006
Feb 7, 2006
388
389
390
391
392
393
394
395
396
397
/* Restore original screen resolution/bpp */
CGDisplaySwitchToMode (display_id, save_mode);
CGReleaseAllDisplays ();
/*
Reset the main screen's rectangle
See comment in QZ_SetVideoFullscreen for why we do this
*/
screen_rect = NSMakeRect(0,0,device_width,device_height);
[ [ NSScreen mainScreen ] setFrame:screen_rect ];
}
Jan 22, 2002
Jan 22, 2002
399
/* Release window mode resources */
Jun 1, 2002
Jun 1, 2002
400
else {
Oct 5, 2002
Oct 5, 2002
401
Aug 21, 2001
Aug 21, 2001
402
[ qz_window close ];
Oct 13, 2005
Oct 13, 2005
403
[ qz_window release ];
Jun 1, 2002
Jun 1, 2002
404
qz_window = nil;
Oct 5, 2002
Oct 5, 2002
405
window_view = nil;
Oct 13, 2005
Oct 13, 2005
406
Jan 22, 2002
Jan 22, 2002
407
408
409
/* Release the OpenGL context */
if ( mode_flags & SDL_OPENGL )
QZ_TearDownOpenGL (this);
Jan 22, 2002
Jan 22, 2002
411
Aug 19, 2001
Aug 19, 2001
412
413
/* Signal successful teardown */
video_set = SDL_FALSE;
414
415
416
417
}
static SDL_Surface* QZ_SetVideoFullScreen (_THIS, SDL_Surface *current, int width,
int height, int bpp, Uint32 flags) {
Jan 2, 2006
Jan 2, 2006
418
boolean_t exact_match = 0;
Aug 12, 2002
Aug 12, 2002
419
NSRect screen_rect;
Feb 1, 2003
Feb 1, 2003
420
CGError error;
Jul 14, 2007
Jul 14, 2007
421
422
NSRect contentRect;
BOOL isCustom = NO;
Feb 7, 2006
Feb 7, 2006
423
424
425
426
427
428
429
CGDisplayFadeReservationToken fade_token = kCGDisplayFadeReservationInvalidToken;
/* Fade to black to hide resolution-switching flicker (and garbage
that is displayed by a destroyed OpenGL context, if applicable) */
if ( CGAcquireDisplayFadeReservation (5, &fade_token) == kCGErrorSuccess ) {
CGDisplayFade (fade_token, 0.3, kCGDisplayBlendNormal, kCGDisplayBlendSolidColor, 0.0, 0.0, 0.0, TRUE);
}
Aug 12, 2002
Aug 12, 2002
430
Oct 5, 2002
Oct 5, 2002
431
432
/* Destroy any previous mode */
if (video_set == SDL_TRUE)
Feb 7, 2006
Feb 7, 2006
433
QZ_UnsetVideoMode (this, FALSE);
Oct 5, 2002
Oct 5, 2002
434
435
/* See if requested mode exists */
Jun 1, 2002
Jun 1, 2002
436
437
438
mode = CGDisplayBestModeForParameters (display_id, bpp, width,
height, &exact_match);
439
440
/* Require an exact match to the requested mode */
if ( ! exact_match ) {
Oct 5, 2002
Oct 5, 2002
441
SDL_SetError ("Failed to find display resolution: %dx%dx%d", width, height, bpp);
442
443
goto ERR_NO_MATCH;
}
Aug 19, 2001
Aug 19, 2001
444
445
/* Put up the blanking window (a window above all other windows) */
Feb 1, 2003
Feb 1, 2003
446
447
448
449
450
451
if (getenv ("SDL_SINGLEDISPLAY"))
error = CGDisplayCapture (display_id);
else
error = CGCaptureAllDisplays ();
if ( CGDisplayNoErr != error ) {
452
453
454
SDL_SetError ("Failed capturing display");
goto ERR_NO_CAPTURE;
}
Jan 22, 2002
Jan 22, 2002
455
456
457
458
459
460
/* Do the physical switch */
if ( CGDisplayNoErr != CGDisplaySwitchToMode (display_id, mode) ) {
SDL_SetError ("Failed switching display resolution");
goto ERR_NO_SWITCH;
}
Jan 22, 2002
Jan 22, 2002
461
462
463
464
current->pixels = (Uint32*) CGDisplayBaseAddress (display_id);
current->pitch = CGDisplayBytesPerRow (display_id);
Jun 11, 2001
Jun 11, 2001
465
current->flags = 0;
466
467
current->w = width;
current->h = height;
Jun 1, 2002
Jun 1, 2002
468
current->flags |= SDL_FULLSCREEN;
469
current->flags |= SDL_HWSURFACE;
Oct 5, 2002
Oct 5, 2002
470
471
472
473
474
current->flags |= SDL_PREALLOC;
this->UpdateRects = QZ_DirectUpdate;
this->LockHWSurface = QZ_LockHWSurface;
this->UnlockHWSurface = QZ_UnlockHWSurface;
Feb 1, 2003
Feb 1, 2003
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
/* Setup double-buffer emulation */
if ( flags & SDL_DOUBLEBUF ) {
/*
Setup a software backing store for reasonable results when
double buffering is requested (since a single-buffered hardware
surface looks hideous).
The actual screen blit occurs in a separate thread to allow
other blitting while waiting on the VBL (and hence results in higher framerates).
*/
this->LockHWSurface = NULL;
this->UnlockHWSurface = NULL;
this->UpdateRects = NULL;
current->flags |= (SDL_HWSURFACE|SDL_DOUBLEBUF);
this->UpdateRects = QZ_DoubleBufferUpdate;
this->LockHWSurface = QZ_LockDoubleBuffer;
this->UnlockHWSurface = QZ_UnlockDoubleBuffer;
this->FlipHWSurface = QZ_FlipDoubleBuffer;
May 1, 2006
May 1, 2006
497
current->pixels = SDL_malloc (current->pitch * current->h * 2);
Feb 1, 2003
Feb 1, 2003
498
499
500
501
502
503
504
505
506
507
508
509
if (current->pixels == NULL) {
SDL_OutOfMemory ();
goto ERR_DOUBLEBUF;
}
sw_buffers[0] = current->pixels;
sw_buffers[1] = (Uint8*)current->pixels + current->pitch * current->h;
quit_thread = NO;
sem1 = SDL_CreateSemaphore (0);
sem2 = SDL_CreateSemaphore (1);
thread = SDL_CreateThread ((int (*)(void *))QZ_ThreadFlip, this);
Jun 1, 2002
Jun 1, 2002
511
512
513
if ( CGDisplayCanSetPalette (display_id) )
current->flags |= SDL_HWPALETTE;
Jun 1, 2002
Jun 1, 2002
514
Jul 14, 2007
Jul 14, 2007
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
/* The code below checks for any valid custom windows and views. If none are
available, then we create new ones. Window/View code was added in FULLSCREEN
so that special events like the changing of the cursor image would be handled
( only the front-most and active application can change the cursor appearance
and with no valid window/view in FULLSCREEN, SDL wouldn't update its cursor. )
*/
/* Check for user-specified window and view */
{
char *windowPtrString = getenv ("SDL_NSWindowPointer");
char *viewPtrString = getenv ("SDL_NSQuickDrawViewPointer");
contentRect = NSMakeRect (0, 0, width, height);
if (windowPtrString && viewPtrString) {
/* Release any previous window */
if ( qz_window ) {
[ qz_window release ];
qz_window = nil;
}
qz_window = (NSWindow*)atoi(windowPtrString);
window_view = (NSQuickDrawView*)atoi(viewPtrString);
isCustom = YES;
/*
Retain reference to window because we
might release it in QZ_UnsetVideoMode
*/
[ qz_window retain ];
}
}
/* Check if we should recreate the window */
if (qz_window == nil) {
/* Manually create a window, avoids having a nib file resource */
qz_window = [ [ SDL_QuartzWindow alloc ]
initWithContentRect:contentRect
styleMask:nil
backing:NSBackingStoreBuffered
defer:NO ];
if (qz_window != nil) {
[ qz_window setAcceptsMouseMovedEvents:YES ];
[ qz_window setViewsNeedDisplay:NO ];
}
}
/* We already have a window, just change its size */
else {
if (!isCustom) {
[ qz_window setContentSize:contentRect.size ];
current->flags |= (SDL_NOFRAME|SDL_RESIZABLE) & mode_flags;
[ window_view setFrameSize:contentRect.size ];
}
}
568
569
570
571
572
/* Setup OpenGL for a fullscreen context */
if (flags & SDL_OPENGL) {
CGLError err;
CGLContextObj ctx;
Jun 1, 2002
Jun 1, 2002
573
574
if ( ! QZ_SetupOpenGL (this, bpp, flags) ) {
Jan 22, 2002
Jan 22, 2002
575
goto ERR_NO_GL;
Jun 1, 2002
Jun 1, 2002
577
Jul 14, 2007
Jul 14, 2007
578
579
580
581
582
583
/* Initialize the NSView and add it to our window. The presence of a valid window and
view allow the cursor to be changed whilst in fullscreen.*/
window_view = [ [ NSView alloc ] initWithFrame:contentRect ];
[ [ qz_window contentView ] addSubview:window_view ];
[ window_view release ];
584
585
ctx = [ gl_context cglContext ];
err = CGLSetFullScreen (ctx);
Jun 1, 2002
Jun 1, 2002
586
Oct 5, 2002
Oct 5, 2002
588
SDL_SetError ("Error setting OpenGL fullscreen: %s", CGLErrorString(err));
589
590
goto ERR_NO_GL;
}
Jun 1, 2002
Jun 1, 2002
591
592
[ gl_context makeCurrentContext];
Jan 22, 2002
Jan 22, 2002
593
594
595
596
glClear (GL_COLOR_BUFFER_BIT);
[ gl_context flushBuffer ];
Jun 1, 2002
Jun 1, 2002
597
598
599
600
601
602
current->flags |= SDL_OPENGL;
}
/* If we don't hide menu bar, it will get events and interrupt the program */
HideMenuBar ();
Jan 22, 2002
Jan 22, 2002
603
Feb 7, 2006
Feb 7, 2006
604
605
606
607
608
/* Fade in again (asynchronously) */
if ( fade_token != kCGDisplayFadeReservationInvalidToken ) {
CGDisplayFade (fade_token, 0.5, kCGDisplayBlendSolidColor, kCGDisplayBlendNormal, 0.0, 0.0, 0.0, FALSE);
CGReleaseDisplayFadeReservation(fade_token);
}
Jun 1, 2002
Jun 1, 2002
609
Aug 12, 2002
Aug 12, 2002
610
/*
Oct 5, 2002
Oct 5, 2002
611
612
613
614
615
There is a bug in Cocoa where NSScreen doesn't synchronize
with CGDirectDisplay, so the main screen's frame is wrong.
As a result, coordinate translation produces incorrect results.
We can hack around this bug by setting the screen rect
ourselves. This hack should be removed if/when the bug is fixed.
Aug 12, 2002
Aug 12, 2002
616
617
618
619
*/
screen_rect = NSMakeRect(0,0,width,height);
[ [ NSScreen mainScreen ] setFrame:screen_rect ];
620
621
/* Save the flags to ensure correct tear-down */
mode_flags = current->flags;
Jun 1, 2002
Jun 1, 2002
622
Apr 13, 2006
Apr 13, 2006
623
624
/* Set app state, hide cursor if necessary, ... */
QZ_DoActivate(this);
Aug 18, 2005
Aug 18, 2005
625
626
627
return current;
Jun 1, 2002
Jun 1, 2002
628
/* Since the blanking window covers *all* windows (even force quit) correct recovery is crucial */
Feb 1, 2003
Feb 1, 2003
629
630
631
ERR_NO_GL:
ERR_DOUBLEBUF: CGDisplaySwitchToMode (display_id, save_mode);
ERR_NO_SWITCH: CGReleaseAllDisplays ();
Feb 7, 2006
Feb 7, 2006
632
633
634
635
636
637
ERR_NO_CAPTURE:
ERR_NO_MATCH: if ( fade_token != kCGDisplayFadeReservationInvalidToken ) {
CGDisplayFade (fade_token, 0.5, kCGDisplayBlendSolidColor, kCGDisplayBlendNormal, 0.0, 0.0, 0.0, FALSE);
CGReleaseDisplayFadeReservation (fade_token);
}
return NULL;
638
639
640
}
static SDL_Surface* QZ_SetVideoWindowed (_THIS, SDL_Surface *current, int width,
Nov 22, 2005
Nov 22, 2005
641
int height, int *bpp, Uint32 flags) {
Jun 11, 2001
Jun 11, 2001
642
unsigned int style;
Oct 5, 2002
Oct 5, 2002
643
NSRect contentRect;
Aug 10, 2003
Aug 10, 2003
644
BOOL isCustom = NO;
Jul 23, 2003
Jul 23, 2003
645
646
int center_window = 1;
int origin_x, origin_y;
Feb 7, 2006
Feb 7, 2006
647
CGDisplayFadeReservationToken fade_token = kCGDisplayFadeReservationInvalidToken;
Jun 1, 2002
Jun 1, 2002
648
Jun 11, 2001
Jun 11, 2001
649
650
current->flags = 0;
current->w = width;
651
current->h = height;
Oct 5, 2002
Oct 5, 2002
652
653
654
655
656
657
658
659
660
661
contentRect = NSMakeRect (0, 0, width, height);
/*
Check if we should completely destroy the previous mode
- If it is fullscreen
- If it has different noframe or resizable attribute
- If it is OpenGL (since gl attributes could be different)
- If new mode is OpenGL, but previous mode wasn't
*/
Feb 7, 2006
Feb 7, 2006
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
if (video_set == SDL_TRUE) {
if (mode_flags & SDL_FULLSCREEN) {
/* Fade to black to hide resolution-switching flicker (and garbage
that is displayed by a destroyed OpenGL context, if applicable) */
if (CGAcquireDisplayFadeReservation (5, &fade_token) == kCGErrorSuccess) {
CGDisplayFade (fade_token, 0.3, kCGDisplayBlendNormal, kCGDisplayBlendSolidColor, 0.0, 0.0, 0.0, TRUE);
}
QZ_UnsetVideoMode (this, TRUE);
}
else if ( ((mode_flags ^ flags) & (SDL_NOFRAME|SDL_RESIZABLE)) ||
(mode_flags & SDL_OPENGL) ||
(flags & SDL_OPENGL) ) {
QZ_UnsetVideoMode (this, TRUE);
}
}
Aug 10, 2003
Aug 10, 2003
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
/* Check for user-specified window and view */
{
char *windowPtrString = getenv ("SDL_NSWindowPointer");
char *viewPtrString = getenv ("SDL_NSQuickDrawViewPointer");
if (windowPtrString && viewPtrString) {
/* Release any previous window */
if ( qz_window ) {
[ qz_window release ];
qz_window = nil;
}
qz_window = (NSWindow*)atoi(windowPtrString);
window_view = (NSQuickDrawView*)atoi(viewPtrString);
isCustom = YES;
/*
Retain reference to window because we
might release it in QZ_UnsetVideoMode
*/
[ qz_window retain ];
style = [ qz_window styleMask ];
/* Check resizability */
if ( style & NSResizableWindowMask )
current->flags |= SDL_RESIZABLE;
/* Check frame */
if ( style & NSBorderlessWindowMask )
current->flags |= SDL_NOFRAME;
}
}
Oct 5, 2002
Oct 5, 2002
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
/* Check if we should recreate the window */
if (qz_window == nil) {
/* Set the window style based on input flags */
if ( flags & SDL_NOFRAME ) {
style = NSBorderlessWindowMask;
current->flags |= SDL_NOFRAME;
} else {
style = NSTitledWindowMask;
style |= (NSMiniaturizableWindowMask | NSClosableWindowMask);
if ( flags & SDL_RESIZABLE ) {
style |= NSResizableWindowMask;
current->flags |= SDL_RESIZABLE;
}
}
Jul 23, 2003
Jul 23, 2003
728
729
730
731
732
733
if ( QZ_WindowPosition(this, &origin_x, &origin_y) ) {
center_window = 0;
contentRect.origin.x = (float)origin_x;
contentRect.origin.y = (float)origin_y;
}
Oct 5, 2002
Oct 5, 2002
734
735
736
737
738
739
740
741
742
/* Manually create a window, avoids having a nib file resource */
qz_window = [ [ SDL_QuartzWindow alloc ]
initWithContentRect:contentRect
styleMask:style
backing:NSBackingStoreBuffered
defer:NO ];
if (qz_window == nil) {
SDL_SetError ("Could not create the Cocoa window");
Feb 7, 2006
Feb 7, 2006
743
744
745
746
if (fade_token != kCGDisplayFadeReservationInvalidToken) {
CGDisplayFade (fade_token, 0.5, kCGDisplayBlendSolidColor, kCGDisplayBlendNormal, 0.0, 0.0, 0.0, FALSE);
CGReleaseDisplayFadeReservation (fade_token);
}
Oct 5, 2002
Oct 5, 2002
747
748
749
return NULL;
}
Mar 9, 2006
Mar 9, 2006
750
/*[ qz_window setReleasedWhenClosed:YES ];*/
Oct 5, 2002
Oct 5, 2002
751
752
753
QZ_SetCaption(this, this->wm_title, this->wm_icon);
[ qz_window setAcceptsMouseMovedEvents:YES ];
[ qz_window setViewsNeedDisplay:NO ];
Jul 23, 2003
Jul 23, 2003
754
755
756
if ( center_window ) {
[ qz_window center ];
}
Oct 5, 2002
Oct 5, 2002
757
758
759
760
761
762
[ qz_window setDelegate:
[ [ [ SDL_QuartzWindowDelegate alloc ] init ] autorelease ] ];
}
/* We already have a window, just change its size */
else {
Aug 10, 2003
Aug 10, 2003
763
764
765
if (!isCustom) {
[ qz_window setContentSize:contentRect.size ];
current->flags |= (SDL_NOFRAME|SDL_RESIZABLE) & mode_flags;
Feb 16, 2004
Feb 16, 2004
766
[ window_view setFrameSize:contentRect.size ];
Aug 10, 2003
Aug 10, 2003
767
}
Oct 5, 2002
Oct 5, 2002
768
}
Jun 1, 2002
Jun 1, 2002
769
Oct 5, 2002
Oct 5, 2002
770
/* For OpenGL, we bind the context to a subview */
771
if ( flags & SDL_OPENGL ) {
Jun 1, 2002
Jun 1, 2002
772
Nov 22, 2005
Nov 22, 2005
773
if ( ! QZ_SetupOpenGL (this, *bpp, flags) ) {
Feb 7, 2006
Feb 7, 2006
774
775
776
777
if (fade_token != kCGDisplayFadeReservationInvalidToken) {
CGDisplayFade (fade_token, 0.5, kCGDisplayBlendSolidColor, kCGDisplayBlendNormal, 0.0, 0.0, 0.0, FALSE);
CGReleaseDisplayFadeReservation (fade_token);
}
778
779
return NULL;
}
Jun 1, 2002
Jun 1, 2002
780
Oct 5, 2002
Oct 5, 2002
781
window_view = [ [ NSView alloc ] initWithFrame:contentRect ];
Feb 16, 2004
Feb 16, 2004
782
[ window_view setAutoresizingMask: NSViewWidthSizable | NSViewHeightSizable ];
Oct 5, 2002
Oct 5, 2002
783
784
785
[ [ qz_window contentView ] addSubview:window_view ];
[ gl_context setView: window_view ];
[ window_view release ];
786
[ gl_context makeCurrentContext];
Aug 21, 2001
Aug 21, 2001
787
[ qz_window makeKeyAndOrderFront:nil ];
788
789
current->flags |= SDL_OPENGL;
}
Oct 5, 2002
Oct 5, 2002
790
/* For 2D, we set the subview to an NSQuickDrawView */
Nov 22, 2005
Nov 22, 2005
792
short qdbpp = 0;
Jun 1, 2002
Jun 1, 2002
793
Oct 5, 2002
Oct 5, 2002
794
795
796
/* Only recreate the view if it doesn't already exist */
if (window_view == nil) {
Jan 4, 2004
Jan 4, 2004
797
window_view = [ [ NSQuickDrawView alloc ] initWithFrame:contentRect ];
Feb 16, 2004
Feb 16, 2004
798
[ window_view setAutoresizingMask: NSViewWidthSizable | NSViewHeightSizable ];
Oct 5, 2002
Oct 5, 2002
799
800
801
802
803
[ [ qz_window contentView ] addSubview:window_view ];
[ window_view release ];
[ qz_window makeKeyAndOrderFront:nil ];
}
Jan 22, 2002
Jan 22, 2002
804
805
806
LockPortBits ( [ window_view qdPort ] );
current->pixels = GetPixBaseAddr ( GetPortPixMap ( [ window_view qdPort ] ) );
current->pitch = GetPixRowBytes ( GetPortPixMap ( [ window_view qdPort ] ) );
Nov 22, 2005
Nov 22, 2005
807
qdbpp = GetPixDepth ( GetPortPixMap ( [ window_view qdPort ] ) );
Sep 16, 2002
Sep 16, 2002
808
UnlockPortBits ( [ window_view qdPort ] );
Oct 5, 2002
Oct 5, 2002
809
Nov 22, 2005
Nov 22, 2005
810
811
812
/* QuickDraw may give a 16-bit shadow surface on 8-bit displays! */
*bpp = qdbpp;
813
814
current->flags |= SDL_SWSURFACE;
current->flags |= SDL_PREALLOC;
Sep 16, 2002
Sep 16, 2002
815
816
current->flags |= SDL_ASYNCBLIT;
Aug 10, 2003
Aug 10, 2003
817
818
819
820
821
822
823
824
825
826
/*
current->pixels now points to the window's pixels
We want it to point to the *view's* pixels
*/
{
int vOffset = [ qz_window frame ].size.height -
[ window_view frame ].size.height - [ window_view frame ].origin.y;
int hOffset = [ window_view frame ].origin.x;
Mar 9, 2006
Mar 9, 2006
827
current->pixels = (Uint8 *)current->pixels + (vOffset * current->pitch) + hOffset * (qdbpp/8);
Aug 10, 2003
Aug 10, 2003
828
}
Sep 16, 2002
Sep 16, 2002
829
830
831
this->UpdateRects = QZ_UpdateRects;
this->LockHWSurface = QZ_LockWindow;
this->UnlockHWSurface = QZ_UnlockWindow;
Jun 1, 2002
Jun 1, 2002
833
Jan 22, 2002
Jan 22, 2002
834
835
/* Save flags to ensure correct teardown */
mode_flags = current->flags;
Jun 1, 2002
Jun 1, 2002
836
Feb 7, 2006
Feb 7, 2006
837
838
839
840
841
842
/* Fade in again (asynchronously) if we came from a fullscreen mode and faded to black */
if (fade_token != kCGDisplayFadeReservationInvalidToken) {
CGDisplayFade (fade_token, 0.5, kCGDisplayBlendSolidColor, kCGDisplayBlendNormal, 0.0, 0.0, 0.0, FALSE);
CGReleaseDisplayFadeReservation (fade_token);
}
843
844
845
return current;
}
Jun 1, 2002
Jun 1, 2002
846
847
static SDL_Surface* QZ_SetVideoMode (_THIS, SDL_Surface *current, int width,
int height, int bpp, Uint32 flags) {
848
849
current->flags = 0;
Feb 24, 2004
Feb 24, 2004
850
current->pixels = NULL;
Jun 1, 2002
Jun 1, 2002
851
852
853
854
855
856
857
858
859
860
/* Setup full screen video */
if ( flags & SDL_FULLSCREEN ) {
current = QZ_SetVideoFullScreen (this, current, width, height, bpp, flags );
if (current == NULL)
return NULL;
}
/* Setup windowed video */
else {
/* Force bpp to the device's bpp */
Jan 22, 2002
Jan 22, 2002
861
bpp = device_bpp;
Nov 22, 2005
Nov 22, 2005
862
current = QZ_SetVideoWindowed (this, current, width, height, &bpp, flags);
863
864
865
if (current == NULL)
return NULL;
}
Jun 1, 2002
Jun 1, 2002
866
867
868
/* Setup the new pixel format */
{
Jun 1, 2002
Jun 1, 2002
869
870
871
872
873
int amask = 0,
rmask = 0,
gmask = 0,
bmask = 0;
874
875
switch (bpp) {
case 16: /* (1)-5-5-5 RGB */
Jun 1, 2002
Jun 1, 2002
876
amask = 0;
Jun 11, 2001
Jun 11, 2001
877
878
879
rmask = 0x7C00;
gmask = 0x03E0;
bmask = 0x001F;
880
881
882
883
884
break;
case 24:
SDL_SetError ("24bpp is not available");
return NULL;
case 32: /* (8)-8-8-8 ARGB */
Aug 19, 2001
Aug 19, 2001
885
amask = 0x00000000;
886
887
888
889
890
rmask = 0x00FF0000;
gmask = 0x0000FF00;
bmask = 0x000000FF;
break;
}
Jun 1, 2002
Jun 1, 2002
891
892
893
if ( ! SDL_ReallocFormat (current, bpp,
rmask, gmask, bmask, amask ) ) {
Jun 1, 2002
Jun 1, 2002
894
895
896
SDL_SetError ("Couldn't reallocate pixel format");
return NULL;
}
Jun 1, 2002
Jun 1, 2002
898
Jan 22, 2002
Jan 22, 2002
899
/* Signal successful completion (used internally) */
Aug 19, 2001
Aug 19, 2001
900
video_set = SDL_TRUE;
Jun 1, 2002
Jun 1, 2002
901
902
903
904
return current;
}
Jun 1, 2002
Jun 1, 2002
905
static int QZ_ToggleFullScreen (_THIS, int on) {
Jan 21, 2003
Jan 21, 2003
906
return 0;
Jun 1, 2002
Jun 1, 2002
909
910
static int QZ_SetColors (_THIS, int first_color, int num_colors,
SDL_Color *colors) {
911
912
913
CGTableCount index;
CGDeviceColor color;
Jun 1, 2002
Jun 1, 2002
914
915
for (index = first_color; index < first_color+num_colors; index++) {
Jun 1, 2002
Jun 1, 2002
916
917
918
919
920
/* Clamp colors between 0.0 and 1.0 */
color.red = colors->r / 255.0;
color.blue = colors->b / 255.0;
color.green = colors->g / 255.0;
Jun 1, 2002
Jun 1, 2002
921
Jun 1, 2002
Jun 1, 2002
923
924
925
CGPaletteSetColorAtIndex (palette, color, index);
}
Jun 1, 2002
Jun 1, 2002
926
927
928
if ( CGDisplayNoErr != CGDisplaySetPalette (display_id, palette) )
return 0;
Jun 1, 2002
Jun 1, 2002
929
930
931
932
return 1;
}
Feb 1, 2003
Feb 1, 2003
933
934
935
936
937
938
939
940
941
942
943
944
945
946
static int QZ_LockDoubleBuffer (_THIS, SDL_Surface *surface) {
return 1;
}
static void QZ_UnlockDoubleBuffer (_THIS, SDL_Surface *surface) {
}
/* The VBL delay is based on code by Ian R Ollmann's RezLib <iano@cco.caltech.edu> */
static AbsoluteTime QZ_SecondsToAbsolute ( double seconds ) {
union
{
Jan 4, 2004
Jan 4, 2004
947
UInt64 i;
Feb 1, 2003
Feb 1, 2003
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
Nanoseconds ns;
} temp;
temp.i = seconds * 1000000000.0;
return NanosecondsToAbsolute ( temp.ns );
}
static int QZ_ThreadFlip (_THIS) {
Uint8 *src, *dst;
int skip, len, h;
/*
Give this thread the highest scheduling priority possible,
in the hopes that it will immediately run after the VBL delay
*/
{
pthread_t current_thread;
int policy;
struct sched_param param;
current_thread = pthread_self ();
pthread_getschedparam (current_thread, &policy, &param);
policy = SCHED_RR;
param.sched_priority = sched_get_priority_max (policy);
pthread_setschedparam (current_thread, policy, &param);
}
while (1) {
SDL_SemWait (sem1);
if (quit_thread)
return 0;
Jan 2, 2006
Jan 2, 2006
983
984
985
986
987
988
/*
* We have to add SDL_VideoSurface->offset here, since we might be a
* smaller surface in the center of the framebuffer (you asked for
* a fullscreen resolution smaller than the hardware could supply
* so SDL is centering it in a bigger resolution)...
*/
Mar 9, 2006
Mar 9, 2006
989
dst = (Uint8 *)CGDisplayBaseAddress (display_id) + SDL_VideoSurface->offset;
Jan 2, 2006
Jan 2, 2006
990
src = current_buffer + SDL_VideoSurface->offset;
Feb 1, 2003
Feb 1, 2003
991
992
993
994
995
996
997
998
999
1000
len = SDL_VideoSurface->w * SDL_VideoSurface->format->BytesPerPixel;
h = SDL_VideoSurface->h;
skip = SDL_VideoSurface->pitch;
/* Wait for the VBL to occur (estimated since we don't have a hardware interrupt) */
{
/* The VBL delay is based on Ian Ollmann's RezLib <iano@cco.caltech.edu> */
double refreshRate;
double linesPerSecond;