移植桌面OpenGL至iOS OpenGL ES 1.1遇白/黑屏问题求助

嘿Frank，我帮你梳理下iOS上OpenGL ES 1.1移植后出现白/黑屏的常见排查点，毕竟桌面OpenGL和ES的差异不止GLUT那点，很多细节容易踩坑：

这部分是iOS渲染的基础，出问题直接导致全屏幕无正确输出：

• CAEAGLLayer配置不能马虎：iOS用CAEAGLLayer作为渲染载体，要确保设置opaque = YES（如果不需要透明的话），并且drawableProperties要指定正确的颜色格式，比如：

  layer.drawableProperties = @{
      kEAGLDrawablePropertyRetainedBacking: @NO,
      kEAGLDrawablePropertyColorFormat: kEAGLColorFormatRGBA8
  };
  

  颜色格式选不对，渲染的像素数据和屏幕不匹配，大概率会黑屏或白屏。
• 帧缓冲完整性必须校验：初始化帧缓冲后，一定要调用glCheckFramebufferStatusOES(GL_FRAMEBUFFER_OES)，确认返回值是GL_FRAMEBUFFER_COMPLETE_OES。如果不是，说明渲染缓冲没正确附加到帧缓冲上，根本没法往里面画东西。另外每次绘制前要确保glBindFramebufferOES和glBindRenderbufferOES都正确执行了。

桌面OpenGL的默认状态和ES 1.1不一样，别想当然沿用旧习惯：

• 顶点数组状态必须手动开启：ES 1.1中使用glDrawArrays前，必须调用glEnableClientState(GL_VERTEX_ARRAY)，桌面OpenGL可能默认开启，但ES默认是关闭的！忘了这一步，顶点数据根本不会被传递到渲染管线，自然什么都画不出来。
• 清除操作不能少：绘制前一定要执行glClear(GL_COLOR_BUFFER_BIT)（如果用到深度缓冲还要加GL_DEPTH_BUFFER_BIT），并且glClearColor要设成你预期的背景色。要是没做清除，屏幕可能残留之前的垃圾数据，或者显示初始的空白状态。
• 矩阵设置要规范：调用glOrthof前，必须先切换到投影矩阵模式：

  glMatrixMode(GL_PROJECTION);
  glLoadIdentity();
  glOrthof(left, right, bottom, top, near, far);
  

  如果矩阵模式错了，或者没加载单位矩阵，你的绘制内容可能被投影到视口外面，看起来就是全空白。

确保glViewport(0, 0, layerWidth, layerHeight)的参数和CAEAGLLayer的实际尺寸一致。要是视口设小了、位置错了，或者尺寸为0，绘制的内容就会出现在屏幕可视区域外，自然看不到任何东西。

绘制完成后，必须调用[_context presentRenderbuffer:GL_RENDERBUFFER_OES]，把后台渲染缓冲的内容交换到屏幕上。要是忘了这一步，你其实已经在后台画了内容，但屏幕显示的还是初始的白/黑屏。

最后给个排查小技巧：先写个极简测试——初始化后设置glClearColor(1.0, 0.0, 0.0, 1.0)，执行glClear(GL_COLOR_BUFFER_BIT)，然后调用缓冲交换。如果屏幕变红，说明渲染上下文和帧缓冲是正常的，问题出在你的绘制逻辑；如果还是不变，那肯定是初始化环节有问题。

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