microsoft/pxt-neoanim

A neopixel animation based on bitmaps - Beta

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

pxt-neoanim's Issues

This repo is missing important files

There are important files that Microsoft projects should all have that are not present in this repository. A pull request has been opened to add the missing file(s). When the pr is merged this issue will be closed automatically.

Microsoft teams can learn more about this effort and share feedback within the open source guidance available internally.

Merge this pull request

Instructions are outdated

To get at the animation editor, I needed to go to "Advanced" -> "Extension", then search for "neoanim" and install the extension found. The rest of the instructions (Light -> Animation editor) are still correct.

Another issue, is that in the presented animation editor, I was invited to drag and drop an existing image. Since I had none at hand, I clicked the link "Paint your own animation" (or something similar), but that presented me with a mostly empty screen. Clicking back returns to the code editor, clicking lights -> animation editor again directs me at the empty screen again.