6. LED dot-matrix screen

Picoe:ed contains a 17x7 LED dot matrix screen.

6.1. Attributes

display

The instance of class Display represents the LED dot screen on board Pico:ed.

6.2. Classes

class Display

It is to represent a dot matrix screen driven by IS31FL3731 which is used internally in Pico:ed to generate display instances.

**clear()**

Clear the screen

**pixel(self, x, y, color=None, blink=None, frame=None)**

Set x, y pixel blink or brightness

  • **x - **horizontal pixel position
  • **y - **vertical pixel position
  • **color - **pixel brightness (0~255)
  • **blink - **Set to “True”, then blink the pixel
  • **frame - **sets the number of frames of the pixel
**scroll(value, brightness=30)**

Scroll to show strings or numbers

  • **value - **the string or number to display
  • **brghtness - ** brightness of the display (0~255), default value 30

class Image

It is to describe a frame of dot matrix images, and contains a series of built-in images.

  • **value - **Image text description, it uses 0 to 9 to specify the brightness of the LED at the corresponding position. The format is as follows:

‘12345678908765432:’

    '12345678908765432:'
    '12345678908765432:'
    '12345678908765432:'
    '12345678908765432:'
    '12345678908765432:'
    '12345678908765432:'

The list of built-in images is as follows:

  • NO
  • SQUARE
  • RECTANGLE
  • RHOMBUS
  • TARGET
  • CHESSBOARD
  • HAPPY
  • SAD
  • YES
  • HEART
  • TRIANGLE
  • CHAGRIN
  • SMILING_FACE
  • CRY
  • DOWNCAST
  • LOOK_RIGHT
  • LOOK_LEFT
  • TONGUE
  • PEEK_RIGHT
  • PEEK_LEFT
  • TEAR_EYES
  • PROUD
  • SNEER_LEFT
  • SNEER_RIGHT
  • SUPERCILIOUS_LOOK
  • EXCITED

6.3. Example

  1. Display strings and numbers
import time
from picoed import display

# Display statically of 3 letters
display.scroll("ABC")
time.sleep(1)

# Scroll to display the numbers
display.scroll(1234567890)

# Scroll to display the strings
display.scroll("Hello, world!")
  1. Display boxes
from picoed import display

# Draw a box on the screen
# Firstly, draw the top and bottom edges
for x in range(display.width):
    display.pixel(x, 0, 50)
    display.pixel(x, display.height - 1, 50)
# Now draw the left and right edges
for y in range(display.height):
    display.pixel(0, y, 50)
    display.pixel(display.width - 1, y, 50)
  1. Display the built-in image
from picoed import display, Image

display.show(Image.HAPPY)
  1. Display self-defined images
from picoed import display, Image

while True:
    display.show(Image(
        '12345678987654321:'
        '12345678987654321:'
        '12345678987654321:'
        '12345678987654321:'
        '12345678987654321:'
        '12345678987654321:'
        '12345678987654321:'
    ))
    display.show(Image(
        '87654321112345678:'
        '87654321112345678:'
        '87654321112345678:'
        '87654321112345678:'
        '87654321112345678:'
        '87654321112345678:'
        '87654321112345678:'
    ))