`rgbLED5x5` ── RGB 5x5点阵显示¶

掌控实验箱上的rgb灯除了可使用 neopixel 库驱动，现在 rgbLED5x5 模块中 display 对象和 Image 类，用于显示图片和文字。模块移植于 microbit 相应库，保持跟 microbit 库兼容，同时新增色彩控制相关特性。

display¶

该模块控制掌控板实验箱上的的5×5 LED点阵。它可用于显示图像，及文本。

rgbLED5x5.display.get_pixel(x, y)¶

获取LED点阵 x 列 y 行像素点颜色值

rgbLED5x5.display.set_pixel(x, y, value)¶

设置LED点阵 x 列 y 行像素点。当 value 为整形时,为1表示点亮,0则熄灭。当为元组类型时,格式(r,g,b)将以指定颜色点亮。

rgbLED5x5.display.clear()¶

关闭所有LED点阵的像素点。

rgbLED5x5.display.show(image)¶

显示 image 图像。可用于显示内置图像或自定义图像。

rgbLED5x5.display.show(value, delay=400, *, wait=True, loop=False, clear=False)

如果value为字符串，浮点数或整数，则按顺序显示字母/数字。否则，如果value是可重复的图像序列，请依次显示这些图像。每个字母，数字或图像delay之间以毫秒为单位显示。可指定亮度和颜色，默认颜色红色。

value - 整形、字符串、image 图像

wait - 为True，则此功能将阻塞直到滚动结束，否则将后台一直滚动。

loop - 为True，则滚动将永远重复。

clear - 为True，则在完成后将清除显示

请注意wait，loop和clear参数必须使用其关键字指定

rgbLED5x5.display.scroll(value, delay=150, *, wait=True, loop=False, monospace=False)¶

在显示屏上水平滚动。如果value为整数或浮点数，则首先使用将其转换为字符串str()。该delay参数控制文本滚动的速度。

value - 整形、字符串、image 图像

wait - 为True，则此功能将阻塞直到滚动结束，否则将后台一直滚动。

loop - 为True，则滚动将永远重复。

clear - 为True，则在完成后将清除显示

monospace - 为True，则字符将全部占用5个像素列的宽度，否则在滚动时每个字符之间将恰好有1个空白像素列。

Image¶

class rgbLED5x5.Image(string)¶

class rgbLED5x5.Image(width=None, height=None, buffer=None, value=None, color=(255, 0, 0))

如果 string 使用，则它必须由排列成行的数字0,1组成，以描述图像，例如:

image = rgbLED5x5.Image("10001:"
                        "01010:"
                        "00100:"
                        "01010:"
                        "10001")

将创建X的5×5图像。行的结尾用冒号表示。也可以使用换行符（n）指示行的结束，如下所示:

image = rgbLED5x5.Image("10001\n"
                        "01010\n"
                        "00100\n"
                        "01010\n"
                        "10001")

另一种形式创建指定宽高的空图像。（可选）buffer为整数数组以初始化图像:

rgbLED5x5.Image(2, 2, b'\x01\x01\x01\x01')

指定颜色,以初始化图像:

rgbLED5x5.Image("01010:01010:01010:11111:01110",(0,50,0))

width()¶

返回图像的宽度

height()¶

返回图像的高度

set_pixel(x, y, value, color)¶

设置 x 列 y 行像素点。当 value 为1表示点亮, 0则熄灭。color 参数可设置指定颜色。

get_pixel(x, y)¶

返回设置 x 列 y 行像素点颜色。返回为RGB颜色元组。

shift_left(n)¶

返回通过将图片向左移动 n 列创建的新图像。

shift_right(n)¶

与相同 image.shift_left(-n).

shift_up(n)¶

返回通过将图片向上移动 n 行创建的新图像。

shift_down(n)¶

与相同 image.shift_up(-n).

crop(x, y, w, h)¶

通过将图片裁剪为宽度w和高度为来返回新图像h，从列x和行的像素开始y。

copy()¶

返回图像的副本

fill(color)¶

所有像素点填充指定颜色。

属性¶

Image 类内置以下多种图像,与microbit一样。

Image.HEART

Image.HEART_SMALL

Image.HAPPY

Image.SMILE

Image.SAD

Image.CONFUSED

Image.ANGRY

Image.ASLEEP

Image.SURPRISED

Image.SILLY

Image.FABULOUS

Image.MEH

Image.YES

Image.NO

Image.CLOCK12, Image.CLOCK11, Image.CLOCK10, Image.CLOCK9, Image.CLOCK8, Image.CLOCK7, Image.CLOCK6, Image.CLOCK5, Image.CLOCK4, Image.CLOCK3, Image.CLOCK2, Image.CLOCK1

Image.ARROW_N, Image.ARROW_NE, Image.ARROW_E, Image.ARROW_SE, Image.ARROW_S, Image.ARROW_SW, Image.ARROW_W, Image.ARROW_NW

Image.TRIANGLE

Image.TRIANGLE_LEFT

Image.CHESSBOARD

Image.DIAMOND

Image.DIAMOND_SMALL

Image.SQUARE

Image.SQUARE_SMALL

Image.RABBIT

Image.COW

Image.MUSIC_CROTCHET

Image.MUSIC_QUAVER

Image.MUSIC_QUAVERS

Image.PITCHFORK

Image.XMAS

Image.PACMAN

Image.TARGET

Image.TSHIRT

Image.ROLLERSKATE

Image.DUCK

Image.HOUSE

Image.TORTOISE

Image.BUTTERFLY

Image.STICKFIGURE

Image.GHOST

Image.SWORD

Image.GIRAFFE

Image.SKULL

Image.UMBRELLA

Image.SNAKE

Image.ALL_CLOCKS

Image.ALL_ARROWS

rgbLED5x5 ── RGB 5x5点阵显示¶

display¶

Image¶

属性¶

`rgbLED5x5` ── RGB 5x5点阵显示¶