Future Board MicroPython Programming - 01 Screen and Display

Future Board
May 05, 2022
Anny Xu

Go back to Product Documents Navigation

Go back to Future Board Documents Navigation

Import FutureBoard Library

Import the Library to make use of its functions.

from future import *

01: TFT

1. Screen Sync

screen.sync = val

Enables or disables the screen sync, 1 for enabled and 0 for disabled.

2. Screen fill

screen.fill(color)

color can be used in a few ways:

RGB, 0~255, for example (255,100,0).
Grey scale, 0~255, for example 100.
Built-in color, supported colors: RED, YELLOW, PINK, WHITE, GREEN, BLUE, PURPLE, CYAN, BLACK.

3. Draw pixel

screen.pixel(x,y,color)

(x,y) refer to the coordinates, ranges from 0~159 and 0~127 respectively.

color can be used in a few ways:

RGB, 0~255, for example (255,100,0).
Grey scale, 0~255, for example 100.
Built-in color, supported colors: RED, YELLOW, PINK, WHITE, GREEN, BLUE, PURPLE, CYAN, BLACK.

4. Draw lines

screen.line(x1,y1,x2,y2,color)

(x1,y1) and (x2, y2) are the coordinates of the line, x and y range from 0~159 and 0~127 respectively.

color can be used in a few ways:

RGB, 0~255, for example (255,100,0).
Grey scale, 0~255, for example 100.
Built-in color, supported colors: RED, YELLOW, PINK, WHITE, GREEN, BLUE, PURPLE, CYAN, BLACK.

Sample Program for 1~4: Brightness Curve

from future import *
import time
Light = [0, 0, 0]
screen.sync = 0
while 1:
light = sensor.getLight()
if len(Light) < 160:
Light.append((125 - int(light/4095*125)))
else:
Light.pop(0)
screen.fill(0)
i_end = len(Light) - 1
for i in range(i_end): # equivalent to for i in range(i_end)
screen.pixel(i, Light[i])
screen.line(i, Light[i], (i+1), Light[(i+1)])
tft.show(fb)
time.sleep_ms(1)

5. Draw Rectangles

screen.rect(x,y,w,h,color,fill)

(x,y) is the top left corner coordinates of the rectangle, x and y range from 0~159 and 0~127 respectively.

Parameters w and h are the width and height.

color can be used in a few ways:

RGB, 0~255, for example (255,100,0).
Grey scale, 0~255, for example 100.
Built-in color, supported colors: RED, YELLOW, PINK, WHITE, GREEN, BLUE, PURPLE, CYAN, BLACK.

Use fill to select whether to fill the shape with a color, 1 for true, 0 for false.

6. Draw Circles

screen.circle(x,y,r,color,fill)

(x,y) is the center coordinates of the circle, x and y range from 0~159 and 0~127 respectively.

Parameter r is the radius.

color can be used in a few ways:

RGB, 0~255, for example (255,100,0).
Grey scale, 0~255, for example 100.
Built-in color, supported colors: RED, YELLOW, PINK, WHITE, GREEN, BLUE, PURPLE, CYAN, BLACK.

Use fill to select whether to fill the shape with a color, 1 for true, 0 for false.

7. Draw Triangles

screen.triangle(x1,y1,x2,y2,x3,y3,color,fill)

(x1,y2), (x2,y2), (x3,y3) represent the coordinates of the three corners of a triangle, x and y range from 0~159 and 0~127 respectively.

color can be used in a few ways:

RGB, 0~255, for example (255,100,0).
Grey scale, 0~255, for example 100.
Built-in color, supported colors: RED, YELLOW, PINK, WHITE, GREEN, BLUE, PURPLE, CYAN, BLACK.

Use fill to select whether to fill the shape with a color, 1 for true, 0 for false.

8. Draw Polygons

screen.polygon(x,y,sides,r,th,rot,color,fill)

(x,y) is the center coordinates of the polygon, x and y range from 0~159 and 0~127 respectively.

Parameter side denotes the number of sides of the polygon, cannot be lower than 3.

Parameter is the radius of the polygon.

Parameter th is the thickness of the border.

Parameter rot is the rotation angle of the polygon.

color can be used in a few ways:

RGB, 0~255, for example (255,100,0).
Grey scale, 0~255, for example 100.
Built-in color, supported colors: RED, YELLOW, PINK, WHITE, GREEN, BLUE, PURPLE, CYAN, BLACK.

Use fill to select whether to fill the shape with a color, 1 for true, 0 for false.

Sample Program for 5~8

from future import *

screen.fill((0, 0, 0))
screen.rect(5,5,50,20,(0, 119, 255),1)
screen.circle(50,50,20,(170, 0, 0),0)
screen.triangle(10,50,60,100,10,100,(0, 170, 0),0)
screen.polygon(120,50,5,30,3,0,(255, 255, 0),1)

9. Show English Strings

screen.text(text, x=0, y=0, ext=1, color=255)

(x,y) is the top left corner coordinates of the text, x and y range from 0~159 and 0~127 respectively.

Parameter ext represents the size of the text, 1 for 8x8, 2 for 16x16 and et-cetera.

color can be used in a few ways:

RGB, 0~255, for example (255,100,0).
Grey scale, 0~255, for example 100.
Built-in color, supported colors: RED, YELLOW, PINK, WHITE, GREEN, BLUE, PURPLE, CYAN, BLACK.

10. Show Chinese Strings

screen.textCh(text, x=0, y=0, ext=1, color=255)

(x,y) is the top left corner coordinates of the text, x and y range from 0~159 and 0~127 respectively.

Parameter ext represents the size of the text, 1 for 8x8, 2 for 16x16 and et-cetera.

color can be used in a few ways:

RGB, 0~255, for example (255,100,0).
Grey scale, 0~255, for example 100.
Built-in color, supported colors: RED, YELLOW, PINK, WHITE, GREEN, BLUE, PURPLE, CYAN, BLACK.

Sample Program for 9~10

from future import *

screen.text('hello world',5,5,1,RED)
screen.textCh('你好',5,25,2,WHITE)

11. Showing Images

screen.loadBmp(path, x=0, y=0)
screen.loadPng(path, x=0, y=0)
screen.loadGif(path, x=0, y=0)

(x,y) is the top left corner coordinates of the image, x and y range from 0~159 and 0~127 respectively.

Sample Program for 11

# Showing png
from future import *
screen.loadPng('hmP.png')

# Showing gif
from future import *
while 1:
screen.loadgif('hmG.gif')

12. Screen Refresh

screen.refresh()

Sample Program for 12

# Screen flashing can be eliminated by turning off screen sync and manually refresh screen
from future import *
screen.sync = 0
x=0
while True:
screen.fill((0, 0, 0))
screen.circle(x,50,10,(0, 255, 0),1)
screen.refresh()
x += 1

If you have any question, please feel free to contact us at Discord, we will always be there to help.

KittenBot Team

Go back to Product Documents Navigation

Go back to Future Board Documents Navigation