OpenGL ES 3.0纹理渲染异常：方块显黑及ByteBuffer问题求助

一、PNG纹理变黑的核心排查点 #

既然ByteBuffer测试纹理能正常渲染，说明你的渲染管线（着色器、顶点数据、纹理采样逻辑）没问题，问题肯定出在PNG纹理的加载或绑定环节，给你列几个必查项：

• 纹理格式不匹配
  检查PNG加载后的位图格式（比如Android的Bitmap.Config.ARGB_8888），对应glTexImage2D的参数必须一致：

  • 如果是ARGB格式，要转成RGBA再传入（OpenGL默认是RGBA顺序），否则通道错乱；
  • glTexImage2D的第三个参数（内部格式）、第四个参数（格式）、第七个参数（类型）要对应，比如用GL_RGBA作为格式，类型用GL_UNSIGNED_BYTE，不能乱配。

• 纹理绑定/激活流程漏步
  绘制PNG纹理的方块前，必须：

  1. 激活纹理单元：glActiveTexture(GL_TEXTURE0)；
  2. 绑定纹理：glBindTexture(GL_TEXTURE_2D, pngTextureId)；
  3. 给着色器采样器赋值：glUniform1i(u_textureLocation, 0)；
     另外，如果你的纹理过滤模式用了mipmap（比如GL_LINEAR_MIPMAP_LINEAR），必须调用glGenerateMipmap(GL_TEXTURE_2D)，否则纹理会失效变黑。

• 像素对齐问题
  OpenGL默认的GL_UNPACK_ALIGNMENT是4，也就是每行像素数据的字节数必须是4的倍数。如果你的PNG宽度是奇数，且是RGB格式（每行字节数=3*宽度，不是4的倍数），OpenGL会读取错误的像素数据，导致纹理变黑。解决方法是在加载纹理前调用：

  glPixelStorei(GL_UNPACK_ALIGNMENT, 1);
  

  关闭对齐要求，让OpenGL严格按你传入的字节数读取。

二、ByteBuffer测试纹理的额外2字节问题 #

这完全是像素对齐导致的：
OpenGL默认要求每行像素数据是4的倍数，如果你的测试纹理宽度*单像素字节数不是4的倍数，OpenGL会自动补齐到4的倍数。比如你的测试纹理宽度是5，单像素是2字节（RGB565），每行原本是10字节，OpenGL会补到12字节，也就是额外2字节。解决方法要么手动给ByteBuffer补够对齐字节，要么像上面那样设置GL_UNPACK_ALIGNMENT为1。

三、快速调试技巧 #

1. 每步OpenGL操作后调用glGetError()，打印错误码，能快速定位格式错误、参数错误这类问题；
2. 把PNG换成纯红的测试图，排除PNG本身的透明通道或编码异常；
3. 对比ByteBuffer纹理和PNG纹理的创建代码，找出差异——比如你可能给ByteBuffer设置了对齐参数，但PNG加载时没加。

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