显示

此模式控制着开发板正面5×5的LED显示屏,它可以用来显示图片、动画甚至是文本。

_images/scroll-hello.gif

函数

microbit.display.get_pixel(x, y)

将第 x 列和第 y 行的LED亮度以0(关)和9(亮)之间的整数返回。

microbit.display.set_pixel(x, y, value)

将第 x 列和第 y 行的LED亮度设置为 value,该值必须是介于0和9之间的整数。

microbit.display.clear()

将所有的LED亮度设置为0(关闭)。

microbit.display.show(image)

显示 image

microbit.display.show(iterable, delay=400, *, wait=True, loop=False, clear=False)

按顺序显示来自 iterable 的图像或字母,并在它们之间设置一定量的毫秒数 delay (延迟)。

如果 waitTrue,此函数将进入阻塞状态,直到动画完成,否则动画将在后台进行。

如果 loopTrue,动画将永久重复。

如果 clearTrue,则在迭代(iterable)完成后,显示将被清除。

请注意必须使用相应关键字指定 wait, loopclear 的参数。

注解

若使用生成器作为 iterable,那么请注意不要在生成器中分配任何内存,这是因为在中断中分配内容是不被允许的,这将会导致 MemoryError

microbit.display.scroll(string, delay=150, *, wait=True, loop=False, monospace=False)

除了 string 水平滚动外,与 show 类似。 delay 参数决定文本滚动的速度。

如果 waitTrue,此函数将进入阻塞状态,直到动画完成,否则动画将在后台进行。

如果 loopTrue,动画将永久重复。

如果 monospaceTrue,那么字符将全部占用5个像素列的宽度,否则每个字符在滚动时都会有1个空白像素列。

请注意必须使用相应关键字指定 wait, loopmonospace 的参数。

microbit.display.on()

调用on()以开启显示。

microbit.display.off()

调用off()以关闭显示(从而允许您将与显示相关的GPIO引脚重新用于其他目的)。

microbit.display.is_on()

若显示处于开启状态,则返回 True,否则返回 False

示例

要不断在显示屏上滚动字符串,并在后台执行该操作,您可以使用:

import microbit

microbit.display.scroll('Hello!', wait=False, loop=True)