full example

full script to use the epd display and its touch screen (2in13). everytime we touch the screen, it draw a point.

from PIL import Image, ImageDraw


from waveshare_touch_epaper.epaper_display import EPD2in13, EpaperException
from waveshare_touch_epaper.touch_screen import GT1151, TouchEpaperException


def touch_and_display_loop():
    try:
        width = EPD2in13.WIDTH
        height = EPD2in13.HEIGHT
        img = Image.new('1', (width, height), 255)
        draw = ImageDraw.Draw(img)
        draw.text((width/2, height/2), 'touch me!')
        with GT1151() as gt, EPD2in13() as epd:
            epd.display(img)
            while True:
                try:
                    x, y, s = gt.input(timeout=30)
                except TouchEpaperException:
                    print('no touch detected during timeout, exit')
                    break
                else:
                    length = s ** 0.5
                    dx = length / 2
                    draw.rectangle((x - dx, y - dx, x + dx, y + dx), fill=0)
                    try:
                        epd.display(img, full_refresh=False)
                    except EpaperException:
                        epd.display(img)
    except KeyboardInterrupt:
        print('goodbye')

import classes

you can either import directly the classes in the epaper_display and touch_screen module:

from waveshare_touch_epaper.epaper_display import EPD2in13, EpaperException
from waveshare_touch_epaper.touch_screen import GT1151, TouchEpaperException


epd = EPD2in13()

or you can use the following dictionary to get all the available classes:

from waveshare_touch_epaper import touch_screen_models, epaper_models


print(epaper_models.keys())
epd = epaper_models['EPD2in13']

epd.start()
# display some stuff..
epd.stop()
gt.open()
# read input of touch screen
gt.close()

with EPD2in13() as epd:
    pass
    # display some stuff
with GT1151() as gt:
    pass
    # read some input

display images

with the epaper display class you can access the dimensions, and display some images:

from PIL import Image


width = epd.WIDTH
height = epd.HEIGHT
img = Image.new('1', (width, height), 255)
epd.display(img)

by default this will make a full refresh. you can also use a partial refresh:

epd.display(img, full_refresh=False)

however, after a certain number of consecutive partial display, it will raise an error so that you can only do a full refresh. Do handle this case without counting the number of partial refresh you can use a try/except:

try:
    epd.display(img, full_refresh=False)
except EpaperException:
    epd.display(img)

and it is possible to clear the image:

epd.clear()  # all the sreen becomes white
epd.clear(0)  # all the screen becomes black

touch screen input read

one can read the input of the touch screen:

x, y, s = gt.input()  # x, y coordinates, s size of touch

the method will block until a touch is detected (and only if it is different from the previous coordinates). you can add a timeout, so that it will raise a TouchEpaperException if no touch is detected during this time:

x, y, s = gt.input(timeout=30)  # raise exception if no touch after 30s

touch screen can be set in sleep mode to reduce consumption. It will be set back in normal mode automaticely when we ask for input:

gt.sleep()

one can also switch to gesture mode and wait for specific gesture (slide_left, slide_right, etc…)

gt.wait_for_gesture(gesture='left_slide')

The method will block until such gesture is detected. possible gesture are (right_slide, left_slide, slide_up, slide_down, double_click,)

mock mode

there a mock classes:

epd = epaper_models['EPD2in13Mock']
gt = epaper_models['GT1151Mock']

there is no need of the waveshare device nor any gpio or i2c port (so an desktop computer). The display uses the show method of PIL and the input comes from the keyboard.