1 /* xscreensaver, Copyright (c) 2006-2013 Jamie Zawinski <jwz@jwz.org>
3 * Permission to use, copy, modify, distribute, and sell this software and its
4 * documentation for any purpose is hereby granted without fee, provided that
5 * the above copyright notice appear in all copies and that both that
6 * copyright notice and this permission notice appear in supporting
7 * documentation. No representations are made about the suitability of this
8 * software for any purpose. It is provided "as is" without express or
12 /* This is a subclass of Apple's ScreenSaverView that knows how to run
13 xscreensaver programs without X11 via the dark magic of the "jwxyz"
14 library. In xscreensaver terminology, this is the replacement for
15 the "screenhack.c" module.
18 #import "XScreenSaverGLView.h"
19 #import "XScreenSaverConfigSheet.h"
20 #import "screenhackI.h"
21 #import "xlockmoreI.h"
26 # import <OpenGL/OpenGL.h>
29 /* used by the OpenGL screen savers
31 extern GLXContext *init_GL (ModeInfo *);
32 extern void glXSwapBuffers (Display *, Window);
33 extern void glXMakeCurrent (Display *, Window, GLXContext);
34 extern void clear_gl_error (void);
35 extern void check_gl_error (const char *type);
38 @implementation XScreenSaverGLView
42 [super stopAnimation];
44 // Without this, the GL frame stays on screen when switching tabs
45 // in System Preferences.
48 [NSOpenGLContext clearCurrentContext];
49 # endif // !USE_IPHONE
51 clear_gl_error(); // This hack is defunct, don't let this linger.
55 // #### maybe this could/should just be on 'lockFocus' instead?
56 - (void) prepareContext
60 [EAGLContext setCurrentContext:ogl_ctx];
62 [ogl_ctx makeCurrentContext];
63 // check_gl_error ("makeCurrentContext");
70 - (void) resizeContext
74 [ogl_ctx setView:self];
75 # endif // !USE_IPHONE
79 - (NSOpenGLContext *) oglContext
86 /* With GL programs, drawing at full resolution isn't a problem.
88 - (CGFloat) hackedContentScaleFactor
90 return [self contentScaleFactor];
95 - (void) setOglContext: (NSOpenGLContext *) ctx
100 [EAGLContext setCurrentContext: ogl_ctx];
102 double s = [self hackedContentScaleFactor];
103 int w = s * [self bounds].size.width;
104 int h = s * [self bounds].size.height;
106 if (gl_framebuffer) glDeleteFramebuffersOES (1, &gl_framebuffer);
107 if (gl_renderbuffer) glDeleteRenderbuffersOES (1, &gl_renderbuffer);
108 if (gl_depthbuffer) glDeleteRenderbuffersOES (1, &gl_depthbuffer);
110 glGenFramebuffersOES (1, &gl_framebuffer);
111 glBindFramebufferOES (GL_FRAMEBUFFER_OES, gl_framebuffer);
113 glGenRenderbuffersOES (1, &gl_renderbuffer);
114 glBindRenderbufferOES (GL_RENDERBUFFER_OES, gl_renderbuffer);
117 // glRenderbufferStorageOES (GL_RENDERBUFFER_OES, GL_RGBA8_OES, w, h);
118 [ogl_ctx renderbufferStorage:GL_RENDERBUFFER_OES
119 fromDrawable:(CAEAGLLayer*)self.layer];
121 glFramebufferRenderbufferOES (GL_FRAMEBUFFER_OES, GL_COLOR_ATTACHMENT0_OES,
122 GL_RENDERBUFFER_OES, gl_renderbuffer);
124 glGenRenderbuffersOES (1, &gl_depthbuffer);
125 // renderbufferStorage: must be called before this.
126 glBindRenderbufferOES (GL_RENDERBUFFER_OES, gl_depthbuffer);
127 glRenderbufferStorageOES (GL_RENDERBUFFER_OES, GL_DEPTH_COMPONENT16_OES,
129 glFramebufferRenderbufferOES (GL_FRAMEBUFFER_OES, GL_DEPTH_ATTACHMENT_OES,
130 GL_RENDERBUFFER_OES, gl_depthbuffer);
132 int err = glCheckFramebufferStatusOES (GL_FRAMEBUFFER_OES);
134 case GL_FRAMEBUFFER_COMPLETE_OES:
136 case GL_FRAMEBUFFER_INCOMPLETE_ATTACHMENT_OES:
137 NSAssert (0, @"framebuffer incomplete attachment");
139 case GL_FRAMEBUFFER_INCOMPLETE_MISSING_ATTACHMENT_OES:
140 NSAssert (0, @"framebuffer incomplete missing attachment");
142 case GL_FRAMEBUFFER_INCOMPLETE_DIMENSIONS_OES:
143 NSAssert (0, @"framebuffer incomplete dimensions");
145 case GL_FRAMEBUFFER_INCOMPLETE_FORMATS_OES:
146 NSAssert (0, @"framebuffer incomplete formats");
148 case GL_FRAMEBUFFER_UNSUPPORTED_OES:
149 NSAssert (0, @"framebuffer unsupported");
152 case GL_FRAMEBUFFER_UNDEFINED:
153 NSAssert (0, @"framebuffer undefined");
155 case GL_FRAMEBUFFER_INCOMPLETE_DRAW_BUFFER:
156 NSAssert (0, @"framebuffer incomplete draw buffer");
158 case GL_FRAMEBUFFER_INCOMPLETE_READ_BUFFER:
159 NSAssert (0, @"framebuffer incomplete read buffer");
161 case GL_FRAMEBUFFER_INCOMPLETE_MULTISAMPLE:
162 NSAssert (0, @"framebuffer incomplete multisample");
164 case GL_FRAMEBUFFER_INCOMPLETE_LAYER_TARGETS:
165 NSAssert (0, @"framebuffer incomplete layer targets");
169 NSAssert (0, @"framebuffer incomplete, unknown error 0x%04X", err);
173 check_gl_error ("setOglContext");
175 # endif // USE_IPHONE
177 [self resizeContext];
183 return [CAEAGLLayer class];
188 glBindRenderbufferOES (GL_RENDERBUFFER_OES, gl_renderbuffer);
189 [ogl_ctx presentRenderbuffer:GL_RENDERBUFFER_OES];
194 #ifdef USE_BACKBUFFER
201 - (void)drawRect:(NSRect)rect
206 - (void) animateOneFrame
209 UIGraphicsPushContext (backbuffer);
215 UIGraphicsPopContext();
220 /* The backbuffer isn't actually used for GL programs, but it needs to
221 be there for X11 calls to not error out. However, nothing done with
222 X11 calls will ever show up! It all gets written into the backbuffer
223 and discarded. That's ok, though, because mostly it's just calls to
224 XClearWindow and housekeeping stuff like that. So we make a tiny one.
226 - (void) createBackbuffer
228 // Don't resize the X11 window to match rotation.
229 // Rotation and scaling are handled in GL.
232 double s = [self hackedContentScaleFactor];
236 // Store a realistic size in backbuffer_size, though the buffer is minimal.
237 NSRect f = [self bounds];
238 backbuffer_size.width = (int) (s * f.size.width);
239 backbuffer_size.height = (int) (s * f.size.height);
242 CGColorSpaceRef cs = CGColorSpaceCreateDeviceRGB();
245 backbuffer = CGBitmapContextCreate (NULL, w, h,
247 kCGImageAlphaPremultipliedLast);
248 CGColorSpaceRelease (cs);
251 # endif // USE_BACKBUFFER
265 /* Utility functions...
269 // redefine NSAssert, etc. here since they don't work when not inside
276 jwxyz_abort ("%s", [(S) cStringUsingEncoding:NSUTF8StringEncoding])
277 #define NSAssert(CC,S) do { if (!(CC)) { NSASS((S)); }} while(0)
278 #define NSAssert1(CC,S,A) do { if (!(CC)) { \
279 NSASS(([NSString stringWithFormat: S, A])); }} while(0)
280 #define NSAssert2(CC,S,A,B) do { if (!(CC)) { \
281 NSASS(([NSString stringWithFormat: S, A, B])); }} while(0)
284 /* Called by OpenGL savers using the XLockmore API.
287 init_GL (ModeInfo *mi)
289 Window win = mi->window;
290 XScreenSaverGLView *view = (XScreenSaverGLView *) jwxyz_window_view (win);
291 NSAssert1 ([view isKindOfClass:[XScreenSaverGLView class]],
292 @"wrong view class: %@", view);
293 NSOpenGLContext *ctx = [view oglContext];
299 NSOpenGLPixelFormatAttribute attrs[40];
301 attrs[i++] = NSOpenGLPFAColorSize; attrs[i++] = 24;
302 attrs[i++] = NSOpenGLPFAAlphaSize; attrs[i++] = 8;
303 attrs[i++] = NSOpenGLPFADepthSize; attrs[i++] = 16;
305 if (get_boolean_resource (mi->dpy, "doubleBuffer", "DoubleBuffer"))
306 attrs[i++] = NSOpenGLPFADoubleBuffer;
308 Bool ms_p = get_boolean_resource (mi->dpy, "multiSample", "MultiSample");
310 /* Sometimes, turning on multisampling kills performance. At one point,
311 I thought the answer was, "only run multisampling on one screen, and
312 leave it turned off on other screens". That's what this code does,
313 but it turns out, that solution is insufficient. I can't really tell
314 what causes poor performance with multisampling, but it's not
315 predictable. Without changing the code, some times a given saver will
316 perform fine with multisampling on, and other times it will perform
317 very badly. Without multisampling, they always perform fine.
319 // if (ms_p && [[view window] screen] != [[NSScreen screens] objectAtIndex:0])
323 attrs[i++] = NSOpenGLPFASampleBuffers; attrs[i++] = 1;
324 attrs[i++] = NSOpenGLPFASamples; attrs[i++] = 6;
325 // Don't really understand what this means:
326 // attrs[i++] = NSOpenGLPFANoRecovery;
331 NSOpenGLPixelFormat *pixfmt =
332 [[NSOpenGLPixelFormat alloc] initWithAttributes:attrs];
334 if (ms_p && !pixfmt) { // Retry without multisampling.
337 pixfmt = [[NSOpenGLPixelFormat alloc] initWithAttributes:attrs];
340 NSAssert (pixfmt, @"unable to create NSOpenGLPixelFormat");
342 // #### Analyze says: "Potential leak of an object stored into pixfmt"
343 ctx = [[NSOpenGLContext alloc]
344 initWithFormat:pixfmt
346 // [pixfmt release]; // #### ???
349 // Sync refreshes to the vertical blanking interval
351 [ctx setValues:&r forParameter:NSOpenGLCPSwapInterval];
352 // check_gl_error ("NSOpenGLCPSwapInterval"); // SEGV sometimes. Too early?
354 // #### Analyze says: "Potential leak of an object stored into "ctx"
355 // But makeCurrentContext retains it (right?)
357 [ctx makeCurrentContext];
358 check_gl_error ("makeCurrentContext");
360 [view setOglContext:ctx];
362 // Clear frame buffer ASAP, else there are bits left over from other apps.
363 glClearColor (0, 0, 0, 1);
364 glClear (GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT);
366 // glXSwapBuffers (mi->dpy, mi->window);
369 // Enable multi-threading, if possible. This runs most OpenGL commands
370 // and GPU management on a second CPU.
372 # ifndef kCGLCEMPEngine
373 # define kCGLCEMPEngine 313 // Added in MacOS 10.4.8 + XCode 2.4.
375 CGLContextObj cctx = CGLGetCurrentContext();
376 CGLError err = CGLEnable (cctx, kCGLCEMPEngine);
377 if (err != kCGLNoError) {
378 NSLog (@"enabling multi-threaded OpenGL failed: %d", err);
382 check_gl_error ("init_GL");
386 EAGLContext *ogl_ctx = ctx;
390 get_boolean_resource (mi->dpy, "doubleBuffer", "DoubleBuffer");
392 /* There seems to be no way to actually turn off double-buffering in
393 EAGLContext (e.g., no way to draw to the front buffer directly)
394 but if we turn on "retained backing" for non-buffering apps like
395 "pipes", at least the back buffer isn't auto-cleared on them.
397 CAEAGLLayer *eagl_layer = (CAEAGLLayer *) view.layer;
398 eagl_layer.opaque = TRUE;
399 eagl_layer.drawableProperties =
400 [NSDictionary dictionaryWithObjectsAndKeys:
401 kEAGLColorFormatRGBA8, kEAGLDrawablePropertyColorFormat,
402 [NSNumber numberWithBool:!dbuf_p], kEAGLDrawablePropertyRetainedBacking,
405 // Without this, the GL frame buffer is half the screen resolution!
406 eagl_layer.contentsScale = [UIScreen mainScreen].scale;
408 ogl_ctx = [[EAGLContext alloc] initWithAPI:kEAGLRenderingAPIOpenGLES1];
413 [view setOglContext:ogl_ctx];
414 // #### Analyze says "Potential leak of an object stored into ogl_ctx"
416 check_gl_error ("OES_init");
418 # endif // USE_IPHONE
420 // Caller expects a pointer to an opaque struct... which it dereferences.
421 // Don't ask me, it's historical...
422 static int blort = -1;
423 return (void *) &blort;
427 /* Copy the back buffer to the front buffer.
430 glXSwapBuffers (Display *dpy, Window window)
432 XScreenSaverGLView *view = (XScreenSaverGLView *) jwxyz_window_view (window);
433 NSAssert1 ([view isKindOfClass:[XScreenSaverGLView class]],
434 @"wrong view class: %@", view);
436 NSOpenGLContext *ctx = [view oglContext];
437 if (ctx) [ctx flushBuffer]; // despite name, this actually swaps
438 #else /* USE_IPHONE */
440 #endif /* USE_IPHONE */
443 /* Does nothing - prepareContext already did the work.
446 glXMakeCurrent (Display *dpy, Window window, GLXContext context)
451 /* clear away any lingering error codes */
453 clear_gl_error (void)
455 while (glGetError() != GL_NO_ERROR)
460 /* report a GL error. */
462 check_gl_error (const char *type)
467 switch ((i = glGetError())) {
468 case GL_NO_ERROR: return;
469 case GL_INVALID_ENUM: e = "invalid enum"; break;
470 case GL_INVALID_VALUE: e = "invalid value"; break;
471 case GL_INVALID_OPERATION: e = "invalid operation"; break;
472 case GL_STACK_OVERFLOW: e = "stack overflow"; break;
473 case GL_STACK_UNDERFLOW: e = "stack underflow"; break;
474 case GL_OUT_OF_MEMORY: e = "out of memory"; break;
475 #ifdef GL_TABLE_TOO_LARGE_EXT
476 case GL_TABLE_TOO_LARGE_EXT: e = "table too large"; break;
478 #ifdef GL_TEXTURE_TOO_LARGE_EXT
479 case GL_TEXTURE_TOO_LARGE_EXT: e = "texture too large"; break;
482 e = buf; sprintf (buf, "unknown GL error %d", (int) i); break;
484 NSAssert2 (0, @"%s GL error: %s", type, e);