LibGDX运行时Shader参数化问题：设置Uniform后精灵绘制未生效

在LibGDX游戏开发中，希望通过Uniform参数控制SpriteBatch中的精灵是否渲染为灰度，避免频繁切换Shader（已知切换开销较高）。

• 切换Shader的代码可正常工作：

private fun updateShaderFromSpriteComponent(component: SpriteComponent) {
    if (component.shouldRenderGrayscale) {
        LOG.info { "Rendering grayscale" }
        batch.shader = shaderProgram
    } else {
        batch.shader = null
    }
}

• 但通过设置Uniform参数的代码无法生效（调试显示代码已执行，但所有精灵仍为全彩色）：

private fun updateShaderFromSpriteComponent(component: SpriteComponent) {
    if (component.shouldRenderGrayscale) {
        LOG.info { "Rendering grayscale" }
        batch.shader?.setUniformi("u_isGrayscale", 1)
    } else {
        batch.shader?.setUniformi("u_isGrayscale", 0)
    }
}

尝试过在设置Uniform前后调用shaderProgram.bind()，但仍无效果，同时想了解如何实现更复杂的动态效果（如根据浮点值控制纹理淡入）。

1. 核心问题：确保Shader始终处于激活状态 #

你当前的Uniform设置代码无效的根本原因是：当不需要灰度时，你没有绑定目标Shader（甚至将batch.shader设为null），导致batch.shader?.setUniformi()实际上是对null调用，Uniform根本没被设置到正确的Shader中。

参数化Shader的核心逻辑是始终使用同一个Shader，通过Uniform值控制渲染效果，而不是切换Shader到默认（null）。修改代码如下：

// 初始化阶段就把Shader绑定到SpriteBatch，后续不再切换
batch.shader = shaderProgram

private fun updateShaderFromSpriteComponent(component: SpriteComponent) {
    // 直接对已绑定的Shader设置Uniform，无需判断null
    val isGrayscale = if (component.shouldRenderGrayscale) 1 else 0
    shaderProgram.setUniformi("u_isGrayscale", isGrayscale)
}

2. 检查Shader代码是否正确使用Uniform #

确保你的片段着色器中正确读取了u_isGrayscale并应用灰度计算，示例片段着色器代码：

#ifdef GL_ES
precision mediump float;
#endif

uniform sampler2D u_texture;
uniform int u_isGrayscale;

varying vec4 v_color;
varying vec2 v_texCoord;

void main() {
    vec4 originalColor = v_color * texture2D(u_texture, v_texCoord);
    
    if (u_isGrayscale == 1) {
        // 采用ITU-R BT.601标准权重计算灰度，避免颜色偏差
        float gray = dot(originalColor.rgb, vec3(0.299, 0.587, 0.114));
        gl_FragColor = vec4(gray, gray, gray, originalColor.a);
    } else {
        gl_FragColor = originalColor;
    }
}

注意：

• 必须在Shader中显式声明uniform int u_isGrayscale;，否则Uniform无法被识别
• 灰度计算要使用标准权重，避免出现偏色问题

3. 确保Uniform设置时机正确 #

Uniform必须在SpriteBatch.begin()之后，draw()之前设置，且每次绘制不同状态的精灵前都要更新：

batch.begin()
for (entity in entities) {
    val spriteComponent = entity.getComponent(SpriteComponent::class.java)
    // 先设置当前精灵对应的Uniform值
    updateShaderFromSpriteComponent(spriteComponent)
    // 再绘制精灵
    batch.draw(spriteComponent.sprite, ...)
}
batch.end()

如果遇到同一批绘制的精灵Uniform不生效的情况，可能是SpriteBatch的批处理缓存导致的，此时可以在设置Uniform前调用batch.flush()，强制提交之前的缓存，再应用新的Uniform：

private fun updateShaderFromSpriteComponent(component: SpriteComponent) {
    batch.flush() // 提交之前的绘制缓存，确保新Uniform立即生效
    val isGrayscale = if (component.shouldRenderGrayscale) 1 else 0
    shaderProgram.setUniformi("u_isGrayscale", isGrayscale)
}

4. 实现复杂动态效果（如纹理淡入） #

对于动态浮点值控制的效果（比如根据fadeProgress（0~1）控制纹理从透明淡入到全色），只需要将Uniform类型改为浮点型，在Shader中做混合计算：

步骤1：修改Shader，添加浮点Uniform #

uniform float u_fadeProgress; // 0=完全透明，1=完全显示

void main() {
    vec4 originalColor = v_color * texture2D(u_texture, v_texCoord);
    // 控制透明度淡入
    gl_FragColor = vec4(originalColor.rgb, originalColor.a * u_fadeProgress);
    
    // 如果需要颜色渐变（比如从灰色到彩色），可使用mix函数
    // float gray = dot(originalColor.rgb, vec3(0.299, 0.587, 0.114));
    // vec4 grayColor = vec4(gray, gray, gray, originalColor.a);
    // gl_FragColor = mix(grayColor, originalColor, u_fadeProgress);
}

步骤2：设置浮点Uniform #

// 在绘制前设置动态浮点值
shaderProgram.setUniformf("u_fadeProgress", entity.fadeProgress)

同样要确保Shader始终绑定，且设置时机在draw之前。

内容的提问来源于stack exchange，提问作者Marc Philippe Beaujean