neoanim

A neopixel animation based on bitmaps

Animation Sheet

Creates an animation from a pre-rendered set of frames

light.animationSheet(null)

Parameters

buffer, the buffer containing the data (more below)

Animation editor

From the https://makecode.adafruit.com editor,

click on Add Package
add neoanim
go to the Lights category and click on Animation Editor

Buffer format

The bitmap format should be specified as follows. All values are little endian.

magic number 0x2e0a2188, 4 bytes
palette size, 1 byte (npalette)
reserved padding, 1 byte
palette, npalette x 24bit RGB colors
frames, nleds x number of frames. A contiguous sequence of palette color indices.

Example

Generating your own animation

The following sample generates a buffer and uses it to create the animation.

const strip = light.createStrip();
const nleds = strip.length();
const ncolors = 3;
const nframes = 10;
const sheet = pins.createBuffer(6 + ncolors * 3 + nleds * nframes);
const palette = sheet.slice(6, ncolors * 3);
const frames = sheet.slice(6 + palette.length);

// magic number
sheet.setNumber(0, NumberFormat.UInt32LE, 0x2e0a21);
// palette
sheet[4] = ncolors;
palette[0] = 0xff; // red
palette[4] = 0xff; // green
palette[8] = 0xff; // blue
// filing up colors
let k = 0;
for (let i = 0; i < nleds; ++i) {
    for (let j = 0; j < nframes; ++j) {
        frames[k++] = i + j % ncolors;
    }
}
let anim = light.animationSheet(sheet);

loops.forever(() => {
    strip.showAnimation(anim, 10000);
})

License

MIT

Supported targets

for PXT/adafruit
for PXT/codal (The metadata above is needed for package search.)

galejohn/pxt-neoanim