1.8 KiB
1.8 KiB
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.)