Skip to main content
ILampArray 上的所有色彩更新函式都使用 LampArrayColor 結構來表示 RGBA 色彩值。 Alpha 值 (LampArrayColor::a) 代表色彩的相對透明度,其中零為完全透明,0xFF 為完全不透明。如果使用 0xFF 以外的 Alpha 值,色彩會額外經過一個與黑色混合的步驟。若要避免此混合步驟,設定色彩時請勿傳遞 0xFF 以外的 Alpha 值。 ILampArray SetColor API 的設計是從單一執行緒呼叫,以獲得最佳效能及 Lamp 狀態一致性。

更新所有 Lamp

ILampArray::SetColor 方法會將裝置上的所有 Lamp 變更為所需的色彩。 下列範例會註冊 LampArray 回呼,並設定每個已連接裝置的色彩。

以個別 Lamp 或 Lamp 群組為目標

ILampArray::SetColorsForIndices 用來更新 LampArray 的一或多個 Lamp。傳入此 API 的 Lamp 索引可以是任何順序。 下列範例說明如何在 LampArray 的所有 Lamp 上設定交替的色彩。
下列範例示範如何更新 LampArray 上個別 Lamp 或 Lamp 群組的色彩。

使用鍵盤掃描碼以 Lamp 為目標

ILampArray::SetColorsForScanCodes 提供簡單的方式,來設定 LampArray 鍵盤上特定按鍵的 Lamp 色彩。例如,這在教學課程情境中協助教導使用者要按哪些按鍵,或在鍵盤上顯示遊戲狀態相關資訊時很有用。 下列範例說明如何變更 LampArray 鍵盤上 WASD 鍵的 Lamp 色彩:

另請參閱

照明 API 概觀 ILampArray 參考 LampArrayColor ILampArray::SetColor ILampArray::SetColorsForIndices ILampArray::SetColorsForScanCodes
Last modified on October 6, 2026