OpenGL 3.3索引精灵仅显示调色板首色，求问题排查

以下是针对精灵仅使用调色板第一个颜色问题的核心排查点和解决方法：

1. 修正像素索引纹理的格式配置 #

• 索引纹理必须使用整数格式创建，避免浮点归一化导致索引值丢失：

  // 创建8位无符号整数索引纹理
  glTexImage2D(GL_TEXTURE_2D, 0, GL_R8UI, width, height, 0, GL_RED_INTEGER, GL_UNSIGNED_BYTE, pixelIndexData);
  

• 片段着色器中必须用usampler2D类型采样索引纹理，而非普通sampler2D：

  uniform usampler2D spriteIndexTex;
  

2. 确保索引到调色板的采样逻辑正确 #

• 在片段着色器中，正确提取索引值并转换为调色板纹理的UV坐标：

  uniform sampler2D paletteTex;
  uniform int paletteSize; // 调色板颜色总数
  
  void main() {
      // 获取原始像素索引（无符号整数）
      uint colorIndex = texture(spriteIndexTex, vTexCoord).r;
      // 将索引转换为0-1范围的UV值（适配1D调色板纹理）
      float paletteUV = float(colorIndex) / float(paletteSize);
      // 采样调色板得到最终颜色
      gl_FragColor = texture(paletteTex, vec2(paletteUV, 0.0));
  }
  

• 若使用2D调色板纹理，需根据调色板的行列数计算正确的UV坐标，确保索引映射到对应颜色位置。

3. 校验纹理绑定与uniform赋值的匹配性 #

• 纹理单元激活与uniform赋值必须一一对应：

  // 绑定索引纹理到纹理单元0
  glActiveTexture(GL_TEXTURE0);
  glBindTexture(GL_TEXTURE_2D, spriteIndexTexID);
  glUniform1i(glGetUniformLocation(shaderProgram, "spriteIndexTex"), 0);
  
  // 绑定调色板纹理到纹理单元1
  glActiveTexture(GL_TEXTURE1);
  glBindTexture(GL_TEXTURE_1D, paletteTexID);
  glUniform1i(glGetUniformLocation(shaderProgram, "paletteTex"), 1);
  

• 确认着色器中uniform变量名称与glGetUniformLocation传入的名称完全一致，避免拼写错误。

4. 设置正确的纹理过滤模式 #

• 索引纹理必须使用GL_NEAREST过滤，防止索引值被插值导致非整数索引：

  glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_NEAREST);
  glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_NEAREST);
  

5. 检查调色板纹理的加载格式 #

• 调色板纹理需使用标准颜色格式创建，确保颜色数据正确加载：

  // 加载RGBA格式的调色板数据
  glTexImage1D(GL_TEXTURE_1D, 0, GL_RGBA8, paletteSize, 0, GL_RGBA, GL_UNSIGNED_BYTE, paletteColorData);
  

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