Skip to content

Creating New Animations

Nicolás de Ory edited this page Apr 5, 2020 · 6 revisions

You can create LED animations via the visual editor. You can find usage instructions there.

Animation Modes

There are multiple animation modes, each designed to run in a specific medium. Keyboard mode animations run best on a keyboard (but do work on a LED Strip), and Line mode animations run well everywhere

Line Mode

To make a Line Mode animation, set the number of LEDs to 170. Why 170? Let's keep it uniform for now, so all animations are adjusted for the same LED strip size.

Keyboard Mode

If you're making an animation especially designed for a keyboard, set the number of LEDs to -1.

Which mode do I use?

If your animation looks good in a single row of LEDs, please use Line Mode. It will look way better on LED strips, mice, and other hardware that isn't a keyboard. If your animation takes advantage of the keyboard layout, then go ahead and use Keyboard Mode.

Exporting

When you are ready to export your animation, copy the animation text and paste it in a .txt file. Save the animation to Animations/CHAMPION_NAME/your_animation.txt. Give it a descriptive name, such as q_cast.txt. You can see animation examples in the Animations folder

Animation Format

If you wish to make your own animation designer or wish to change a file manually, it's useful to know the custom format.

The format is similar to a DMX color array. The first line indicates the following information:

  • LED count
  • Frame count

The following data is a byte array containing FRAME_COUNT * NUM_LEDS * 3 color channel bytes (RGB order, starting by LED 0). A two-frame animation for a 5 LED strip will look like this:

5,2
0,0,0,59,255,62,255,51,210,0,0,0,0,0,0,0,0,0,0,0,0,59,255,62,255,51,210,0,0,0

The above animation will look like this

Clone this wiki locally