ディスプレイ¶

このモジュールは、ボードの前面にある 5×5 LED ディスプレイを制御します。イメージ、アニメーション、テキストの表示に利用できます。

関数¶

microbit.display.get_pixel(x, y)¶: x 列 y 行の LEDの明るさを返します。返り値は 0 (オフ)から 9 (明るい)までの整数値です。

microbit.display.set_pixel(x, y, value)¶: x 列 y 行の LEDの明るさを設定します。 value にはv 0 (オフ)から 9 (明るい)までの整数値を指定します。

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

iterable からイメージや文字を順番に delay 間隔で表示します。

wait が True である場合、アニメーションが終了するまで関数がブロックし、 False の場合にはバックグラウンドで実行されます。

loop が True である場合、アニメーションが永遠に繰り返します。

clear が True である場合、表示が終了後にディスプレィをクリアします。

wait, loop, clear 引数は、キーワードを用いて指定する必要があることに注意してください。

注釈

iterable でジェネレータを使う場合、ジェネレータでメモリをアロケートしないよう注意してください。割り込みでメモリをアロケートすると MemoryError が起きます。

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

show と同様ですが、 string を水平方向にスクロールします。delay パラメータはテキストのスクロール速度を制御します。

wait が True である場合、アニメーションが終了するまで関数がブロックし、 False の場合にはバックグラウンドで実行されます。

loop が True である場合、アニメーションが永遠に繰り返します。

monospace が True である場合、文字は 5 ピクセル幅になります。False の場合はスクロールでの文字間が 1 ピクセルのブランクになります。

wait, loop, monospace 引数は、キーワードを用いて指定する必要があることに注意してください。

microbit.display.off()¶: ディスプレイを無効にするのは off() を使います(ディスプレイに関連づけられた GPIO 端子を他の目的に再利用できるようにします)。

ディスプレイに文字列を連続してスクロール表示することをバックグラウンドで実行します。

import microbit

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