HitLib is a VEX V5 LED animation library for PROS. It drives WS2812B-compatible LED strips connected to ADI ports, including strips on ADI expanders, with a fully thread-safe, task-driven animation engine.

Getting Started

New to HitLib? Start here:

Installation - wire up your strip and install the template
Groups - understand strands and groups before writing code
Animation Reference - every animation with examples
Profiles & Modes - event-driven animation for competition

What is HitLib?

HitLib gives you a two-layer animation engine on top of the PROS LED API. Every strip has a base layer and an overlay layer. Animations run continuously in a background task, you just call a method and it plays.

LedGroup
 └─ LedStrand
      ├─ Base layer      ← flow / rainbow / pulse / bitscroll / twinkle, or a
      │                    level meter driven by hand, by a value, or by a song
      ├─ Overlay layer   ← second independent animation
      ├─ Spread mask     ← wipes overlay over base from center outward
      ├─ Splice mask     ← alternating sections, or arbitrary custom regions
      └─ Profile         ← priority-based mode stack for match events

Feature Overview

Feature	Description
Animations	Static, flow gradient, rainbow, pulse, flash, twinkle, bitscroll
Bounce variants	Pulse bounce, bitscroll bounce
Overlay system	A second animation layer, shown in a splice mask's masked bins
Splice mask	Alternating sections or custom regions, solid color or overlay
Level meter	Fill the strip in proportion to a value - by hand, or tracking a motor, sensor or the battery on its own
Music sync	Fill in time with a song - MP3/FLAC/WAV or MIDI, analysed by Pattern Studio
Profiles	Priority mode stack, activateMode / activateModeTimed
Sequencer	Multi-phase timed driver for endgame sequences
Groups	One call fans out to every strand in the group
Brightness	0–100% applied non-destructively at flush time

Minimal Example

#include "hitlib/hitapi.hpp"
 
hitlib::LedStrand strand(6, 63);
hitlib::LedGroup  group;
 
void initialize() {
    group.add(&strand);
    group.init();
    group.start();
}
 
void opcontrol() {
    group.rainbow(1);
}