jonathanpotts / spectral

Add RGB LED illumination to your games and applications made with Unity, Unreal Engine, C++, and .NET. Spectral adds RGB LED illumination on devices on all supported brands (e.g. Logitech, Corsair) instead of only the devices of a specific brand.

Spectral

NOTE: This library is no longer maintained; however, it may still function and it could be a good starting point to build a newer library from.

Unified RGB LED Illumination

Spectral provides unified RGB LED illumination for your games and applications made with Unity, Unreal Engine, .NET, and C++. By implementing the Spectral library, your games and applications can control the RGB LED illumination on devices on all supported brands (e.g. Logitech, Corsair) instead of only the devices of a specific brand. Due to limitations of the devices, Spectral only works for games and applications on the Windows desktop platform. Spectral will fail gracefully for unsupported platforms.

Unity Support

The Spectral plugin for Unity allows you to program RGB LED illumination effects to use with your games and applications. The plugin source code is documented with IntelliSense support and an example implementation has been provided.

Unreal Engine Support

The Spectral plugin for Unreal Engine has support for both Blueprints visual scripting and C++ programming. Using Blueprints, you can easily add support for RGB LED illumination to your games and applications or you can use the power of C++ to implement more advanced effects. All Blueprint nodes and C++ methods are documented with Blueprint node tooltips and C++ IntelliSense support to easily understand how it works.

C++ Support

A C++ wrapper for Spectral is available. It can be used to implement RGB LED Illumination support in your C++ games and applications as well as in other game engines that can be extended with C++. The source code is documented and has IntelliSense support.

.NET Support

A .NET wrapper for Spectral has been written in C# using .NET Standard 2.0. It can be used to implement RGB LED Illumination support in your .NET Framework, .NET Core, and MonoGame games and applications. The source code is documented and has IntelliSense support.

Important

Logitech Gaming Software must be running with the "Allow games to control illumination" setting enabled for Logitech devices to be controlled. Corsair Utility Engine (CUE) must be running for Corsair devices to be controlled.

spectral's Issues

Initialization Fails on C# with exception: BadImageFormatException

Whenever I try to Initialize with the following, simple code, the init just throws a BadImageFormatException.
Using .NET Framework 4.6.1, Console Application

using System;
using Spectral;

namespace ConsoleApp1
{
    class Program
    {
        static void Main(string[] args)
        {
            Led.Initialize();
            if (Led.LogitechIsEnabled())
            {
                Led.SetColorForLed(LedName.B, 20, 20, 100);
            }
            Console.ReadKey(true);
        }
    }
}

How could I help with Razer support

Hi, I noticed that Razer support was removed in this commit 1789993.

What were your considerations for a reimplementation and how may I help with getting support back in?

Need someone to take over maintenance of UE4 plugin

I am looking for a volunteer to take over maintenance of the UE4 plugin (mainly updating it to work with new engine versions). Thanks.

[Feature] Get Color by key

Hello,

Devices:

• Logitech G910 (Keyboard)
• Logitech G502 Hero (mouse)
• Logitech G633 (headset)

I'm currently working on a small software which will make a certain key on my keyboard blink when I receive a notification.

But now it would be great if I can get the currently displayed color with Spectral to use it when flashing.

Example:
I have the color blue on the ESC key
An important message comes in
My software starts flashing my ESC
Red -> White -> Red -> White -> Red -> White etc.

But it would be nicer if I could save the previous color (blue in this case), then it would look like this:
Red -> Blue -> Red -> Blue -> Red -> Blue

Besides: Only when the software is finished, I will give you previous color.

It would be really great if there was any possibility :)

Logitech - Ability to Save the color back to the device

I am looking to write a Windows Service to periodically pull the Windows 10 title bar color from the registry, then send that color to any LED peripherals I have. The idea is that as a random color is chosen when the background changes, that color gets reflected in the keyboard and/or mouse. Because why not, right?

Spectral appears to set the color perfectly when I run it as a basic one-and-done script, but as soon as I call Led.Shutdown, it reverts to the previous color (In fact, it wasn't until I put a Thread.Sleep into my code, that I realized it was doing anything at all).

I suppose I could just have Spectral running as a part of the service, but I would love to have the ability to call LogiLedSaveCurrentLighting from within Spectral to make the color permanent, so to speak (especially since once you click into the G Pro gaming software and pick the mouse menu, it reverts the color anyway).

I guess I could wrap the SDK directly, but your library is so...convenient. :-D

Initialization fails - Corsair K70 RGB Rapidfire - Unreal Engine

When I initialize, the result bool outputs as FALSE. Trying to set rgb colors, nothing happens.

Support for Saitek (Logitech) Products?

Hi @ll,

just tested everything with my Logitech mouse & keyboard, works fine.
I was wondering if you could add support for the saitek products (brand of logitech) like the HOTAS series (x52 & x56), I provide you with the SDK files (C++) for controlling the LEDs.

Would be very nice to finally have a .NET wrapper for it.

DirectOutput.zip