11. 3.3 显示屏相关API#


11.1. API#

  • 在之前 2.4 什么是API 小节中介绍过什么是API,MicroPython编程离不开API支持,下边就是5X5点阵显示屏可能涉及和使用到的API详细说明。

***注意:***某些方法的参数可以缺省表示。

API 描述
display.show(iterable, delay=400, wait=True, loop=False, clear=False) 显示iterable中的每个图像或字母,每个显示之间延迟400msdelay,阻塞等待wait,不循环loop,不清屏clear
display.show(image, delay=0, wait=True, loop=False, clear=False) 显示一个内置图像image,每个显示之间延迟0msdelay,阻塞等待wait,不循环loop,不清屏clear
display.scroll(string, delay=400) 在显示屏上滚动一个字符串string,延时400msdelay
display.get_pixel(x, y) 获取(x,y)位置的亮度,亮度范围为0(关闭)到9(最亮)。
display.set_pixel(x, y, val) 设置(x,y)位置的亮度为val(介于0 [关闭]和9[最亮]之间)。
display.clear() 清空屏幕。

11.2. microbit内置图像#

  • MicroPython中内置了很多有趣的图片,以点阵的方式显示。

  • 内置的所有图形如下图所示,其英文名为图像描述。

Image.HEART 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.HEART_SMALL Image.HAPPY Image.SMILE Image.SAD
Image.YES Image.NO