Android Studio中OpenGL ES无法渲染STL二进制3D模型排查

以下是导致3D模型无法显示的核心原因及修复方案：

1. 缺少坐标变换，顶点超出可视范围 #

你的顶点着色器直接将原始顶点坐标赋值给gl_Position，但STL模型的顶点通常是实际物理尺寸（如厘米、米级），而OpenGL的标准化设备坐标（NDC）范围是[-1, 1]，超出这个范围的顶点会被视口完全裁剪，导致屏幕无内容显示。

修复：添加MVP变换矩阵 #

• 给MeshRenderer添加矩阵相关成员变量：

  private float[] modelMatrix = new float[16];
  private float[] viewMatrix = new float[16];
  private float[] projectionMatrix = new float[16];
  private float[] mvpMatrix = new float[16];
  private int mvpMatrixHandle;
  

• 修改顶点着色器，加入矩阵变换逻辑：

  attribute vec4 vPosition;
  uniform mat4 uMvpMatrix;
  void main() {
    gl_Position = uMvpMatrix * vPosition;
  }
  

• 在onSurfaceCreated中初始化视图与模型矩阵：

  // 模型矩阵初始化为单位矩阵
  android.opengl.Matrix.setIdentityM(modelMatrix, 0);
  // 视图矩阵：将相机向后移动5个单位，让模型进入视野
  android.opengl.Matrix.setLookAtM(viewMatrix, 0, 0, 0, 5, 0, 0, 0, 0, 1, 0);
  

• 在onSurfaceChanged中计算适配屏幕的投影矩阵：

  float aspectRatio = (float) width / height;
  // 透视投影：视角45度，近裁剪面0.1，远裁剪面100
  android.opengl.Matrix.frustumM(projectionMatrix, 0, -aspectRatio, aspectRatio, -1, 1, 0.1f, 100f);
  

• 在onDrawFrame中合并MVP矩阵并传递给着色器：

  // 合并视图与模型矩阵
  android.opengl.Matrix.multiplyMM(mvpMatrix, 0, viewMatrix, 0, modelMatrix, 0);
  // 合并投影矩阵
  android.opengl.Matrix.multiplyMM(mvpMatrix, 0, projectionMatrix, 0, mvpMatrix, 0);
  
  mvpMatrixHandle = GLES20.glGetUniformLocation(program, "uMvpMatrix");
  GLES20.glUniformMatrix4fv(mvpMatrixHandle, 1, false, mvpMatrix, 0);
  

2. 顶点缓冲区被垃圾回收，绘制时无有效数据 #

你在queueEvent的Runnable中创建的FloatBuffer是局部变量，Runnable执行完毕后，缓冲区会失去引用并被GC回收，后续onDrawFrame调用glDrawArrays时，OpenGL无法读取到有效顶点数据。

修复：将顶点缓冲区设为Renderer成员变量 #

• 在MeshRenderer类中添加成员变量：

  private FloatBuffer vertexBuffer;
  

• 修改queueEvent中的缓冲区创建逻辑，将局部变量改为成员变量赋值：

  vertexBuffer = ByteBuffer.allocateDirect(vertices.size() * 4)
          .order(ByteOrder.nativeOrder())
          .asFloatBuffer();
  for (float vertex : vertices) {
      vertexBuffer.put(vertex);
  }
  vertexBuffer.position(0);
  

• 在onDrawFrame中重新绑定顶点缓冲区（避免上下文状态丢失）：

  if (vertexBuffer != null) {
      int positionHandle = GLES20.glGetAttribLocation(program, "vPosition");
      GLES20.glEnableVertexAttribArray(positionHandle);
      GLES20.glVertexAttribPointer(positionHandle, 3, GLES20.GL_FLOAT, false, 0, vertexBuffer);
  }
  

3. OpenGL状态未持续保持 #

queueEvent中设置的顶点属性、uniform等状态，可能在surface重新创建（如屏幕旋转）后丢失，导致后续绘制失效。

修复：关键状态在绘制时重新设置 #

将glEnableVertexAttribArray、glVertexAttribPointer、glUniform4fv这些状态设置代码，从queueEvent移到onDrawFrame中，确保每次绘制都正确绑定数据与状态。

额外验证建议 #

• 先手动定义一组NDC范围内的顶点（如三角形），测试着色器与绘制流程是否正常，再替换为STL模型数据。
• 检查STL模型的顶点坐标范围，如果模型过大/过小，可通过缩放模型矩阵调整：

  android.opengl.Matrix.scaleM(modelMatrix, 0, 0.1f, 0.1f, 0.1f);
  

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