Skip to main content

ILampArray::SetColor

将 ILampArray 上的每个 Lamp 设置为所需颜色。

语法

参数

desiredColor 类型:LampArrayColor 要设置的目标颜色。

返回值

类型:void

备注

黑色(一个填充为零的 LampArrayColor)等同于 Lamp 处于“关闭”状态。 alpha 值 (LampArrayColor::a) 表示颜色的相对透明度,其中零表示完全透明,0xFF 表示完全不透明。如果使用的 alpha 值不是 0xFF,颜色将会与黑色进行额外的混合步骤。为了避免这一混合步骤,设置颜色时请勿传入除 0xFF 以外的 alpha 值。 如果 ILampArray 在当前进程中被禁用,Lamp 状态不会刷新到设备(请参阅 ILampArray::SetIsEnabled)。

要求

头文件: LampArray.h 库: xgameplatform.lib 支持的平台: XBOX One 系列主机和 XBOX Series 主机

另请参阅

光照 API 概览
在 LampArray 上设置颜色
LampArrayColor
ILampArray::SetColorsForIndices
ILampArray::SetColorsForScanCodes
ILampArray
最后修改于 2026年8月24日