MacOS 10.13.4下OpenGL游戏全屏转窗口模式渲染异常求助

这个问题我维护老OpenGL Mac项目时碰到过类似的，结合你描述的现象——切回窗口后焦点在窗口上时画面全白、失焦就恢复正常，再加上旧系统旧项目都没这问题，大概率是MacOS 10.13之后的OpenGL上下文管理或视图层级机制变化导致的兼容性问题，给你几个具体的排查和修复方向：

1. 强制重置OpenGL上下文与帧缓冲状态 #

从全屏切回窗口时，MacOS可能会悄悄修改OpenGL上下文的帧缓冲绑定状态，旧代码没处理这种场景就会导致渲染异常。

• 给窗口注册windowDidExitFullScreen通知，在切回窗口后强制重置帧缓冲和视口：

  - (void)setupWindowNotifications {
      [[NSNotificationCenter defaultCenter] addObserver:self
                                               selector:@selector(windowDidExitFullScreen:)
                                                   name:NSWindowDidExitFullScreenNotification
                                                 object:self.window];
  }
  
  - (void)windowDidExitFullScreen:(NSNotification *)notification {
      // 绑定默认帧缓冲
      glBindFramebuffer(GL_FRAMEBUFFER, 0);
      // 重置视口到当前窗口大小
      NSRect viewFrame = self.openGLView.bounds;
      glViewport(0, 0, viewFrame.size.width, viewFrame.size.height);
      // 强制触发一次渲染
      [self triggerRender];
  }
  

• 同时检查你的NSOpenGLPixelFormat设置，10.13对像素格式的兼容性要求更严，确保包含必要属性：

  NSOpenGLPixelFormatAttribute pixelAttrs[] = {
      NSOpenGLPFAAccelerated,
      NSOpenGLPFADoubleBuffer,
      NSOpenGLPFAColorSize, 32,
      NSOpenGLPFAAlphaSize, 8,
      NSOpenGLPFADepthSize, 24,
      0
  };
  

2. 解决NSView重绘机制冲突 #

MacOS全屏切换会触发视图重绘，如果你的OpenGL渲染循环和系统默认的drawRect:方法冲突，就可能导致获焦时窗口被空白填充。

• 禁用OpenGL视图的默认重绘机制，初始化时添加：

  [self.openGLView setWantsLayer:NO];
  [self.openGLView setNeedsDisplay:NO];
  

• 完全依赖自己的渲染循环，不要让系统的drawRect:干扰OpenGL渲染。

3. 处理焦点变化时的上下文激活状态 #

MacOS在窗口获焦/失焦时会自动激活/暂停OpenGL上下文，但旧代码可能没处理这种状态切换，导致获焦时上下文未正确激活。

• 重写OpenGL视图的viewDidBecomeFirstResponder和viewDidResignFirstResponder方法：

  - (void)viewDidBecomeFirstResponder {
      [super viewDidBecomeFirstResponder];
      // 强制激活当前上下文
      [self.openGLContext makeCurrentContext];
      // 重置渲染状态，避免残留的错误状态
      glClearColor(0.0f, 0.0f, 0.0f, 1.0f);
      glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT);
      [self.openGLContext flushBuffer];
  }
  
  - (void)viewDidResignFirstResponder {
      [super viewDidResignFirstResponder];
      // 这里可以根据需求选择是否清除上下文，一般保持激活也没问题
      // [self.openGLContext clearCurrentContext];
  }
  

4. 修复视图层级错乱问题 #

10.13的全屏切换机制和旧版本不同，可能导致OpenGL视图被其他视图遮挡，或者frame不匹配。

• 在切回窗口后，确保OpenGL视图是最顶层子视图：

  - (void)windowDidExitFullScreen:(NSNotification *)notification {
      [self.window.contentView addSubview:self.openGLView positioned:NSWindowAbove relativeTo:nil];
      // 同步视图frame和窗口大小
      self.openGLView.frame = self.window.contentView.bounds;
  }
  

另外提一句，苹果从10.13开始逐步弱化OpenGL的支持，引入了不少上下文管理的变化，这就是旧代码在新系统出问题的核心原因。如果上面的方案都没解决，可以试试调用[self.openGLContext update]强制更新上下文状态。

内容的提问来源于stack exchange，提问作者deko