Class Display

ev3dev2.display.Display

A convenience wrapper for the FbMem class. Provides drawing functions from the python imaging library (PIL).

Declaration

class Display(FbMem)

source link

Documentation

Methods

▶ def __init__(self, desc='Display') override
inherited doc Create the FbMem framebuffer memory object.
source link
This method overrides ev3dev2.display.FbMem.__init__.
▷ def __str__(self)
source link
▶ def circle(self, clear_screen=True, x=50, y=50, radius=40, fill_color='black', ...)
Draw a circle of 'radius' centered at (x, y)
def circle(
self,
clear_screen=True,
x=50,
y=50,
radius=40,
fill_color='black',
outline_color='black',
)
source link
▷ def clear(self)
Clears the screen
source link
▶ def draw(self) @property
Returns a handle to PIL.ImageDraw.Draw class associated with the screen.
@property
def draw(self)
source link
Example:
screen.draw.rectangle((10,10,60,20), fill='black')
▶ def image(self) @property
Returns a handle to PIL.Image class that is backing the screen. This can be accessed for blitting images to the screen.
@property
def image(self)
source link
Example:
screen.image.paste(picture, (0, 0))
▷ def image_filename(self, filename, clear_screen=True, x1=0, y1=0, x2=None, y2=None)
source link
▷ def line(self, clear_screen=True, x1=10, y1=10, x2=50, y2=50, line_color='black', width=1)
Draw a line from (x1, y1) to (x2, y2)
source link
▷ def point(self, clear_screen=True, x=10, y=10, point_color='black')
Draw a single pixel at (x, y)
source link
▶ def rectangle(self, clear_screen=True, x1=10, y1=10, x2=80, y2=40, fill_color='black', ...)
Draw a rectangle where the top left corner is at (x1, y1) and the bottom right corner is at (x2, y2)
def rectangle(
self,
clear_screen=True,
x1=10,
y1=10,
x2=80,
y2=40,
fill_color='black',
outline_color='black',
)
source link
▷ def reset_screen(self)
source link
▷ def shape(self) @property
Dimensions of the screen.
@property
def shape(self)
source link
▶ def text_grid(self, text, clear_screen=True, x=0, y=0, text_color='black', font=None)
Display ``text`` starting at grid (x, y)
source link
The EV3 display can be broken down in a grid that is 22 columns wide and 12 rows tall. Each column is 8 pixels wide and each row is 10 pixels tall.
text_color : PIL says it supports "common HTML color names". There are 140 HTML color names listed here that are supported by all modern browsers. This is probably a good list to start with. https://www.w3schools.com/colors/colors_names.asp
fontcan be any font displayed here
http://ev3dev-lang.readthedocs.io/projects/python-ev3dev/en/ev3dev-stretch/display.html#bitmap-fonts
If font is a string, it is the name of a font to be loaded.
If font is a Font object, returned from :meth:`ev3dev2.fonts.load`, then it is used directly. This is desirable for faster display times.
System Message: ERROR/3 (<string>, line 14); backlink
Unknown interpreted text role "meth".
▶ def text_pixels(self, text, clear_screen=True, x=0, y=0, text_color='black', font=None)
Display ``text`` starting at pixel (x, y).
source link
The EV3 display is 178x128 pixels
(0, 0) would be the top left corner of the display
(89, 64) would be right in the middle of the display
text_color : PIL says it supports "common HTML color names". There are 140 HTML color names listed here that are supported by all modern browsers. This is probably a good list to start with. https://www.w3schools.com/colors/colors_names.asp
fontcan be any font displayed here
http://ev3dev-lang.readthedocs.io/projects/python-ev3dev/en/ev3dev-stretch/display.html#bitmap-fonts
If font is a string, it is the name of a font to be loaded.
If font is a Font object, returned from :meth:`ev3dev2.fonts.load`, then it is used directly. This is desirable for faster display times.
System Message: ERROR/3 (<string>, line 15); backlink
Unknown interpreted text role "meth".
▷ def update(self)
Applies pending changes to the screen. Nothing will be drawn on the screen until this function is called.
source link
▷ def xres(self) @property
Horizontal screen resolution
@property
def xres(self)
source link
▷ def yres(self) @property
Vertical screen resolution
@property
def yres(self)
source link