147 lines
3.7 KiB
C++
147 lines
3.7 KiB
C++
#include "ksbit.h"
|
|
|
|
/**
|
|
* Creation, manipulation and display of LED images.
|
|
*/
|
|
//% color=45 weight=31
|
|
namespace images {
|
|
/**
|
|
* Creates an image that fits on the LED screen.
|
|
*/
|
|
//% weight=75 help=images/create-image
|
|
//% blockId=device_build_image block="create image"
|
|
Image createImage(ImageLiteral leds) {
|
|
return MicroBitImage(imageBytes(leds)).clone().leakData();
|
|
}
|
|
|
|
/**
|
|
* Creates an image with 2 frames.
|
|
*/
|
|
//% weight=74 help=images/create-big-image
|
|
//% blockId=device_build_big_image block="create big image" imageLiteral=2
|
|
Image createBigImage(ImageLiteral leds) {
|
|
return createImage(leds);
|
|
}
|
|
}
|
|
|
|
namespace ImageMethods {
|
|
/**
|
|
* Plots the image at a given column to the screen
|
|
*/
|
|
//% help=images/plot-image
|
|
void plotImage(Image i, int xOffset = 0) {
|
|
uBit.display.print(MicroBitImage(i), -xOffset, 0, 0, 0);
|
|
}
|
|
|
|
/**
|
|
* Shows an frame from the image at offset ``x offset``.
|
|
* @param xOffset TODO
|
|
*/
|
|
//% help=images/show-image weight=80 async
|
|
//% BUGblockId=device_show_image_offset block="show image %sprite|at offset %offset" blockGap=8
|
|
void showImage(Image i, int xOffset = 0) {
|
|
uBit.display.print(MicroBitImage(i), -xOffset, 0, 0);
|
|
}
|
|
|
|
/**
|
|
* Draws the ``index``-th frame of the image on the screen.
|
|
* @param xOffset TODO
|
|
*/
|
|
//% help=images/plot-frame weight=80
|
|
void plotFrame(Image i, int xOffset) {
|
|
// TODO showImage() used in original implementation
|
|
plotImage(i, xOffset * 5);
|
|
}
|
|
|
|
/**
|
|
* Scrolls an image .
|
|
* @param frameOffset x offset moved on each animation step, eg: 5, 1, -1
|
|
* @param interval time between each animation step in milli seconds, eg: 200
|
|
*/
|
|
//% help=images/show-image weight=79 async
|
|
//% BUGblockId=device_scroll_image block="scroll image %sprite|with offset %frameoffset|and interval (ms) %delay" blockGap=8
|
|
void scrollImage(Image id, int frameOffset = 0, int interval = 200) {
|
|
MicroBitImage i(id);
|
|
if (i.getWidth() <= 5)
|
|
showImage(id, 0);
|
|
else
|
|
uBit.display.animate(i, interval, frameOffset, 0);
|
|
}
|
|
|
|
|
|
/**
|
|
* Sets all pixels off.
|
|
*/
|
|
//% help=images/clear
|
|
void clear(Image i) {
|
|
MicroBitImage(i).clear();
|
|
}
|
|
|
|
/**
|
|
* Sets a specific pixel brightness at a given position
|
|
*/
|
|
//% help=
|
|
void setPixelBrightness(Image i, int x, int y, int value) {
|
|
MicroBitImage(i).setPixelValue(x, y, value);
|
|
}
|
|
|
|
|
|
/**
|
|
* Gets the pixel brightness ([0..255]) at a given position
|
|
*/
|
|
//% help=
|
|
int pixelBrightness(Image i, int x, int y) {
|
|
int pix = MicroBitImage(i).getPixelValue(x, y);
|
|
if (pix < 0) return 0;
|
|
return pix;
|
|
}
|
|
|
|
|
|
/**
|
|
* Gets the width in columns
|
|
*/
|
|
//% help=functions/width
|
|
int width(Image i) {
|
|
return i->width;
|
|
}
|
|
|
|
/**
|
|
* Gets the height in rows (always 5)
|
|
*/
|
|
//% shim=
|
|
int height(Image i) {
|
|
return i->height;
|
|
}
|
|
|
|
/**
|
|
* Set a pixel state at position ``(x,y)``
|
|
* @param x TODO
|
|
* @param y TODO
|
|
* @param value TODO
|
|
*/
|
|
//% help=functions/set-pixel
|
|
void setPixel(Image i, int x, int y, bool value) {
|
|
setPixelBrightness(i, x, y, value ? 255 : 0);
|
|
}
|
|
|
|
/**
|
|
* Get the pixel state at position ``(x,y)``
|
|
* @param x TODO
|
|
* @param y TODO
|
|
*/
|
|
//% help=functions/pixel
|
|
bool pixel(Image i, int x, int y) {
|
|
return pixelBrightness(i, x, y) > 0;
|
|
}
|
|
|
|
|
|
/**
|
|
* Shows a particular frame of the image strip.
|
|
* @param frame TODO
|
|
*/
|
|
//% weight=70 help=functions/show-frame
|
|
void showFrame(Image i, int frame) {
|
|
showImage(i, frame * 5);
|
|
}
|
|
}
|