为什么PySide6中QAbstractLight的setIntensity、setColor方法不再生效？

问题原因 #

该问题由Qt 6.x版本中Qt3D框架的渲染管线重构导致，核心变更如下：

• PySide2对应的Qt 5.x版本中，QAbstractLight的intensity、color属性默认直接与标准材质的着色器参数绑定，调用setIntensity()、setColor()方法会自动触发着色器 uniforms 更新，修改会直接反应到渲染结果。
• PySide6对应的Qt 6.x版本中，Qt3D调整了光照参数的传递逻辑，默认不再自动同步QAbstractLight的属性到着色器，因此调用对应的set方法只会修改对象本身的属性值，不会传递给渲染管线的着色器，也就不会影响最终渲染结果，且不会抛出错误提示。

修复方法 #

有两种常用的修复方案：

方案1：手动绑定属性到材质 #

创建光照对象和材质对象后，显式绑定属性变化到材质的着色器参数：

from PySide6.Qt3DCore import QParameter

# 示例为点光源和Phong材质
point_light = QPointLight()
phong_material = QPhongMaterial()

# 初始化参数
phong_material.addParameter(QParameter("pointLight.color", point_light.color()))
phong_material.addParameter(QParameter("pointLight.intensity", point_light.intensity()))

# 绑定属性变化信号，后续修改属性时自动更新
point_light.colorChanged.connect(lambda new_color: phong_material.parameter("pointLight.color").setValue(new_color))
point_light.intensityChanged.connect(lambda new_intensity: phong_material.parameter("pointLight.intensity").setValue(new_intensity))

方案2：启用QLightSettings全局光照配置 #

Qt 6的Qt3D新增了QLightSettings作为全局光照配置入口，只需将其添加到FrameGraph节点中，原有setIntensity()、setColor()方法即可恢复正常逻辑：

from PySide6.Qt3DRender import QLightSettings

# 在你的FrameGraph配置中添加如下代码
light_settings = QLightSettings()
light_settings.setActiveCamera(your_scene_camera)
# 将光照设置添加到渲染过滤器的子节点中
your_render_pass_filter.addChild(light_settings)

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