Contents:
+Contents:
- st7789py Driver
- st7789py Reference @@ -101,10 +104,10 @@
- Fonts
ttgo_lines.py¶
-1 - 2 - 3 - 4 - 5 - 6 - 7 - 8 - 9 -10 -11 -12 -13 -14 -15 -16 -17 -18 -19 -20 -21 -22 -23 -24 -25 -26 -27 -28 -29 -30 -31 -32 -33 -34 -35 -36 -37 -38 -39 -40 -41 -42 -43 -44 -45 -46 -47 -48 -49 -50 -51 -52 -53 -54 -55 -56 -57 -58 -59 -60 -61 -62 -63 -64 | """
-lines.py
-
- Draws lines and rectangles in random colors at random locations on the
- display.
-
-"""
-import random
-from machine import Pin, SoftSPI
-import st7789py as st7789
-
-
-def main():
- spi = SoftSPI(
- baudrate=20000000,
- polarity=1,
- phase=0,
- sck=Pin(18),
- mosi=Pin(19),
- miso=Pin(13))
-
- tft = st7789.ST7789(
- spi,
- 135,
- 240,
- reset=Pin(23, Pin.OUT),
- cs=Pin(5, Pin.OUT),
- dc=Pin(16, Pin.OUT),
- backlight=Pin(4, Pin.OUT),
- rotation=0)
-
- tft.fill(st7789.BLACK)
-
- while True:
- tft.line(
- random.randint(0, tft.width),
- random.randint(0, tft.height),
- random.randint(0, tft.width),
- random.randint(0, tft.height),
- st7789.color565(
- random.getrandbits(8),
- random.getrandbits(8),
- random.getrandbits(8)
- )
- )
-
- width = random.randint(0, tft.width // 2)
- height = random.randint(0, tft.height // 2)
- col = random.randint(0, tft.width - width)
- row = random.randint(0, tft.height - height)
- tft.fill_rect(
- col,
- row,
- width,
- height,
- st7789.color565(
- random.getrandbits(8),
- random.getrandbits(8),
- random.getrandbits(8)
- )
- )
-
-
-main()
+ |
ttgo_hello.py¶
-1 - 2 - 3 - 4 - 5 - 6 - 7 - 8 - 9 -10 -11 -12 -13 -14 -15 -16 -17 -18 -19 -20 -21 -22 -23 -24 -25 -26 -27 -28 -29 -30 -31 -32 -33 -34 -35 -36 -37 -38 -39 -40 -41 -42 -43 -44 -45 -46 -47 -48 -49 -50 -51 -52 -53 -54 -55 -56 -57 -58 -59 -60 -61 -62 -63 -64 -65 -66 -67 -68 -69 -70 -71 -72 -73 | """
-ttgo_hello.py
-
- Writes "Hello!" in random colors at random locations on a
- LILYGO® TTGO T-Display.
-
- https://www.youtube.com/watch?v=atBa0BYPAAc
-
-"""
-import random
-from machine import Pin, SoftSPI
-import st7789py as st7789
-
-# Choose a font
-
-# from romfonts import vga1_8x8 as font
-# from romfonts import vga2_8x8 as font
-# from romfonts import vga1_8x16 as font
-# from romfonts import vga2_8x16 as font
-# from romfonts import vga1_16x16 as font
-# from romfonts import vga1_bold_16x16 as font
-# from romfonts import vga2_16x16 as font
-# from romfonts import vga2_bold_16x16 as font
-# from romfonts import vga1_16x32 as font
-# from romfonts import vga1_bold_16x32 as font
-# from romfonts import vga2_16x32 as font
-from romfonts import vga2_bold_16x32 as font
-
-
-def main():
- spi = SoftSPI(
- baudrate=20000000,
- polarity=1,
- phase=0,
- sck=Pin(18),
- mosi=Pin(19),
- miso=Pin(13))
-
- tft = st7789.ST7789(
- spi,
- 135,
- 240,
- reset=Pin(23, Pin.OUT),
- cs=Pin(5, Pin.OUT),
- dc=Pin(16, Pin.OUT),
- backlight=Pin(4, Pin.OUT),
- rotation=0)
-
- while True:
- for rotation in range(4):
- tft.rotation(rotation)
- tft.fill(0)
- col_max = tft.width - font.WIDTH*6
- row_max = tft.height - font.HEIGHT
-
- for _ in range(100):
- tft.text(
- font,
- "Hello!",
- random.randint(0, col_max),
- random.randint(0, row_max),
- st7789.color565(
- random.getrandbits(8),
- random.getrandbits(8),
- random.getrandbits(8)),
- st7789.color565(
- random.getrandbits(8),
- random.getrandbits(8),
- random.getrandbits(8))
- )
-
-
-main()
+ |
ttgo_fonts.py¶
-1 - 2 - 3 - 4 - 5 - 6 - 7 - 8 - 9 -10 -11 -12 -13 -14 -15 -16 -17 -18 -19 -20 -21 -22 -23 -24 -25 -26 -27 -28 -29 -30 -31 -32 -33 -34 -35 -36 -37 -38 -39 -40 -41 -42 -43 -44 -45 -46 -47 -48 -49 -50 -51 -52 -53 -54 -55 -56 -57 -58 -59 -60 -61 -62 -63 -64 -65 -66 -67 -68 -69 -70 -71 -72 | """
-ttgo_fonts.py
-
- Pages through all characters of four fonts on the LILYGO® TTGO T-Display.
-
- https://www.youtube.com/watch?v=2cnAhEucPD4
-
-"""
-import utime
-from machine import Pin, SoftSPI
-import st7789py as st7789
-
-# Choose fonts
-
-# from romfonts import vga1_8x8 as font
-from romfonts import vga2_8x8 as font1
-# from romfonts import vga1_8x16 as font
-from romfonts import vga2_8x16 as font2
-# from romfonts import vga1_16x16 as font
-# from romfonts import vga1_bold_16x16 as font
-# from romfonts import vga2_16x16 as font
-from romfonts import vga2_bold_16x16 as font3
-# from romfonts import vga1_16x32 as font
-# from romfonts import vga1_bold_16x32 as font
-# from romfonts import vga2_16x32 as font
-from romfonts import vga2_bold_16x32 as font4
-
-
-def main():
- spi = SoftSPI(
- baudrate=20000000,
- polarity=1,
- phase=0,
- sck=Pin(18),
- mosi=Pin(19),
- miso=Pin(13))
-
- tft = st7789.ST7789(
- spi,
- 135,
- 240,
- reset=Pin(23, Pin.OUT),
- cs=Pin(5, Pin.OUT),
- dc=Pin(16, Pin.OUT),
- backlight=Pin(4, Pin.OUT),
- rotation=0)
-
- tft.vscrdef(40, 240, 40)
-
- while True:
- for font in (font1, font2, font3, font4):
- tft.fill(st7789.BLUE)
- line = 0
- col = 0
-
- for char in range(font.FIRST, font.LAST):
- tft.text(font, chr(char), col, line, st7789.WHITE, st7789.BLUE)
- col += font.WIDTH
- if col > tft.width - font.WIDTH:
- col = 0
- line += font.HEIGHT
-
- if line > tft.height-font.HEIGHT:
- utime.sleep(3)
- tft.fill(st7789.BLUE)
- line = 0
- col = 0
-
- utime.sleep(3)
-
-
-main()
+ |
ttgo_scroll.py¶
-1 - 2 - 3 - 4 - 5 - 6 - 7 - 8 - 9 -10 -11 -12 -13 -14 -15 -16 -17 -18 -19 -20 -21 -22 -23 -24 -25 -26 -27 -28 -29 -30 -31 -32 -33 -34 -35 -36 -37 -38 -39 -40 -41 -42 -43 -44 -45 -46 -47 -48 -49 -50 -51 -52 -53 -54 -55 -56 -57 -58 -59 -60 -61 -62 -63 -64 -65 -66 -67 -68 -69 -70 -71 -72 -73 -74 -75 -76 | """
-ttgo_fonts.py
-
- Smoothly scrolls all font characters up the screen on the LILYGO® TTGO
- T-Display. Only works with fonts with heights that are even multiples of
- the screen height, (i.e. 8 or 16 pixels high)
-
-"""
-import utime
-import random
-from machine import Pin, SoftSPI
-import st7789py as st7789
-
-# choose a font
-
-# from romfonts import vga1_8x8 as font
-# from romfonts import vga2_8x8 as font
-# from romfonts import vga1_8x16 as font
-# from romfonts import vga2_8x16 as font
-# from romfonts import vga1_16x16 as font
-# from romfonts import vga1_bold_16x16 as font
-# from romfonts import vga2_16x16 as font
-from romfonts import vga2_bold_16x16 as font
-
-
-def main():
- spi = SoftSPI(
- baudrate=20000000,
- polarity=1,
- phase=0,
- sck=Pin(18),
- mosi=Pin(19),
- miso=Pin(13))
-
- tft = st7789.ST7789(
- spi,
- 135,
- 240,
- reset=Pin(23, Pin.OUT),
- cs=Pin(5, Pin.OUT),
- dc=Pin(16, Pin.OUT),
- backlight=Pin(4, Pin.OUT),
- rotation=0)
-
- last_line = tft.height - font.HEIGHT
- tfa = 40
- tfb = 40
- tft.vscrdef(tfa, 240, tfb)
-
- tft.fill(st7789.BLUE)
- scroll = 0
- character = 0
- while True:
- tft.fill_rect(0, scroll, tft.width, 1, st7789.BLUE)
-
- if scroll % font.HEIGHT == 0:
- tft.text(
- font,
- '\\x{:02x}= {:s} '.format(character, chr(character)),
- 0,
- (scroll + last_line) % tft.height,
- st7789.WHITE,
- st7789.BLUE)
-
- character = character + 1 if character < 256 else 0
-
- tft.vscsad(scroll + tfa)
- scroll += 1
-
- if scroll == tft.height:
- scroll = 0
-
- utime.sleep(0.01)
-
-
-main()
+ |
toasters.py¶
Flying toasters sprite demo using bitmaps created from spritesheet using ImageMagick’s convert and imgtobitmap.py utility. See the maketoast script in the utils directory for details.
-1 - 2 - 3 - 4 - 5 - 6 - 7 - 8 - 9 -10 -11 -12 -13 -14 -15 -16 -17 -18 -19 -20 -21 -22 -23 -24 -25 -26 -27 -28 -29 -30 -31 -32 -33 -34 -35 -36 -37 -38 -39 -40 -41 -42 -43 -44 -45 -46 -47 -48 -49 -50 -51 -52 -53 -54 -55 -56 -57 -58 -59 -60 -61 -62 -63 -64 -65 -66 -67 -68 -69 -70 -71 -72 -73 -74 -75 -76 -77 -78 -79 -80 -81 -82 -83 -84 -85 -86 -87 -88 -89 -90 -91 -92 -93 -94 -95 -96 | """
-toasters.py
-
- An example using bitmap to draw sprites on the display.
-
- Spritesheet from CircuitPython_Flying_Toasters
- https://learn.adafruit.com/circuitpython-sprite-animation-pendant-mario-clouds-flying-toasters
-
-"""
-
-import random
-from machine import Pin, SoftSPI
-import st7789py as st7789
-import t1, t2, t3, t4, t5
-
-TOASTERS = [t1, t2, t3, t4]
-TOAST = [t5]
-
-
-class toast():
- '''
- toast class to keep track of a sprites locaton and step
- '''
- def __init__(self, sprites, x, y):
- self.sprites = sprites
- self.steps = len(sprites)
- self.x = x
- self.y = y
- self.step = random.randint(0, self.steps-1)
- self.speed = random.randint(2, 5)
-
- def move(self):
- if self.x <= 0:
- self.speed = random.randint(2, 5)
- self.x = 135 - 64
-
- self.step += 1
- self.step %= self.steps
- self.x -= self.speed
-
-
-def main():
- """
- Initialize the display and draw flying toasters and toast
- """
- spi = SoftSPI(
- baudrate=20000000,
- polarity=1,
- phase=0,
- sck=Pin(18),
- mosi=Pin(19),
- miso=Pin(13))
-
- tft = st7789.ST7789(
- spi,
- 135,
- 240,
- reset=Pin(23, Pin.OUT),
- cs=Pin(5, Pin.OUT),
- dc=Pin(16, Pin.OUT),
- backlight=Pin(4, Pin.OUT),
- rotation=0)
-
- tft.fill(st7789.BLACK)
- # create toast spites in random positions
- sprites = [
- toast(TOASTERS, 135-64, 0),
- toast(TOAST, 135-64*2, 80),
- toast(TOASTERS, 135-64*4, 160)
- ]
-
- # move and draw sprites
- while True:
- for man in sprites:
- bitmap = man.sprites[man.step]
- tft.fill_rect(
- man.x+bitmap.WIDTH-man.speed,
- man.y,
- man.speed,
- bitmap.HEIGHT,
- st7789.BLACK)
-
- man.move()
-
- if man.x > 0:
- tft.bitmap(bitmap, man.x, man.y)
- else:
- tft.fill_rect(
- 0,
- man.y,
- bitmap.WIDTH,
- bitmap.HEIGHT,
- st7789.BLACK)
-
-
-main()
+ |
chango.py¶
Test for font2bitmap converter for the driver. See the font2bitmap program in the utils directory.
-1 - 2 - 3 - 4 - 5 - 6 - 7 - 8 - 9 -10 -11 -12 -13 -14 -15 -16 -17 -18 -19 -20 -21 -22 -23 -24 -25 -26 -27 -28 -29 -30 -31 -32 -33 -34 -35 -36 -37 -38 -39 -40 -41 -42 -43 -44 -45 -46 -47 -48 -49 -50 -51 | """
-chango.py
-
- Test for font2bitmap converter for the driver.
- See the font2bitmap program in the utils directory.
-"""
-
-from machine import Pin, SoftSPI
-import st7789py as st7789
-import gc
-from truetype import chango_16 as font_16
-from truetype import chango_32 as font_32
-from truetype import chango_64 as font_64
-
-gc.collect()
-
-
-def main():
- # enable display and clear screen
- spi = SoftSPI(
- baudrate=20000000,
- polarity=1,
- phase=0,
- sck=Pin(18),
- mosi=Pin(19),
- miso=Pin(13))
-
- tft = st7789.ST7789(
- spi,
- 135,
- 240,
- reset=Pin(23, Pin.OUT),
- cs=Pin(5, Pin.OUT),
- dc=Pin(16, Pin.OUT),
- backlight=Pin(4, Pin.OUT),
- rotation=1)
-
- tft.fill(st7789.BLACK)
-
- row = 0
- tft.write(font_16, "abcdefghijklmnopqrst", 0, row, st7789.RED)
- row += font_16.HEIGHT
-
- tft.write(font_32, "abcdefghij", 0, row, st7789.GREEN)
- row += font_32.HEIGHT
-
- tft.write(font_64, "abcd", 0, row, st7789.BLUE)
- row += font_64.HEIGHT
-
-
-main()
+ |
noto_fonts.py¶
Test for font2bitmap converter for the driver. See the font2bitmap program in the utils directory.
-1 - 2 - 3 - 4 - 5 - 6 - 7 - 8 - 9 -10 -11 -12 -13 -14 -15 -16 -17 -18 -19 -20 -21 -22 -23 -24 -25 -26 -27 -28 -29 -30 -31 -32 -33 -34 -35 -36 -37 -38 -39 -40 -41 -42 -43 -44 -45 -46 -47 -48 -49 -50 -51 -52 -53 -54 -55 -56 -57 -58 -59 -60 -61 -62 -63 -64 -65 -66 -67 -68 -69 | """
-noto_fonts Writes the names of three Noto fonts centered on the display
- using the font. The fonts were converted from True Type fonts using
- the font2bitmap utility.
-"""
-
-from machine import SoftSPI, Pin
-import st7789py as st7789
-
-from truetype import NotoSans_32 as noto_sans
-from truetype import NotoSerif_32 as noto_serif
-from truetype import NotoSansMono_32 as noto_mono
-
-
-def main():
-
- def center(font, string, row, color=st7789.WHITE):
- screen = tft.width # get screen width
- width = tft.write_width(font, string) # get the width of the string
- if width and width < screen: # if the string < display
- col = tft.width // 2 - width // 2 # find the column to center
- else: # otherwise
- col = 0 # left justify
-
- tft.write(font, string, col, row, color) # and write the string
-
- try:
- spi = SoftSPI(
- baudrate=20000000,
- polarity=1,
- phase=0,
- sck=Pin(18),
- mosi=Pin(19),
- miso=Pin(13))
-
- tft = st7789.ST7789(
- spi,
- 135,
- 240,
- reset=Pin(23, Pin.OUT),
- cs=Pin(5, Pin.OUT),
- dc=Pin(16, Pin.OUT),
- backlight=Pin(4, Pin.OUT),
- rotation=1)
-
- # enable display and clear screen
- tft.fill(st7789.BLACK)
-
- row = 16
-
- # center the name of the first font, using the font
- center(noto_sans, "NotoSans", row, st7789.RED)
- row += noto_sans.HEIGHT
-
- # center the name of the second font, using the font
- center(noto_serif, "NotoSerif", row, st7789.GREEN)
- row += noto_serif.HEIGHT
-
- # center the name of the third font, using the font
- center(noto_mono, "NotoSansMono", row, st7789.BLUE)
- row += noto_mono.HEIGHT
-
- finally:
- # shutdown spi
- if 'spi' in locals():
- spi.deinit()
-
-
-main()
+ |
Contents:
+Contents:
- st7789py Driver
- st7789py Reference @@ -100,10 +103,10 @@
- Fonts
Sample converted romfont font module.¶
-1 - 2 - 3 - 4 - 5 - 6 - 7 - 8 - 9 -10 -11 -12 -13 -14 -15 -16 -17 -18 -19 -20 -21 -22 -23 -24 -25 -26 -27 | """converted from vga_8x8.bin """
-
-# font width
-WIDTH = 8
-
-# font height
-HEIGHT = 8
-
-# first character in front
-FIRST = 0x20
-
-# last character in font
-LAST = 0x7f
-
-# bitmap of each character from FIRST to LAST
-_FONT =\
-b'\x00\x00\x00\x00\x00\x00\x00\x00'\
-b'\x18\x3c\x3c\x18\x18\x00\x18\x00'\
-b'\x66\x66\x24\x00\x00\x00\x00\x00'\
-
-... many more lines of data...
-
-b'\x70\x18\x18\x0e\x18\x18\x70\x00'\
-b'\x76\xdc\x00\x00\x00\x00\x00\x00'\
-b'\x00\x10\x38\x6c\xc6\xc6\xfe\x00'\
-
-FONT = memoryview(_FONT)
+ |
@@ -264,105 +241,59 @@ the negative glyph.left fix from peterhinch’s font conversion program
-Sample converted TrueType font module.¶
-1 - 2 - 3 - 4 - 5 - 6 - 7 - 8 - 9 -10 -11 -12 -13 -14 -15 -16 -17 -18 -19 -20 -21 -22 -23 -24 -25 -26 -27 -28 -29 -30 -31 -32 -33 -34 -35 -36 -37 -38 -39 -40 -41 -42 -43 -44 -45 -46 -47 | # -*- coding: utf-8 -*-
-# Converted from Chango-Regular.ttf using:
-# ./font2bitmap.py Chango-Regular.ttf 16 -c 0x20-0x7f
-
-# Maps the order of the character data
-MAP = " !\"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\\]^_`abcdefghijklmnopqrstuvwxyz{|}~"
-
-# Number of color bits per pixel, currently only 1 is used but could be
-# increased to support antialiased or smoothed fonts in the future.
-BPP = 1
-
-# Font height
-HEIGHT = 17
-
-# Font max width
-MAX_WIDTH = 24
-
-# one byte per character table of widths in the same order as the MAP string
-_WIDTHS = \
- b'\x06\x08\x0a\x0e\x0d\x18\x10\x06\x08\x08\x0a\x0d\x06\x08\x06\x0b'\
-
- ... more lines of data...
-
- b'\x0d\x0d\x0b\x0a\x0b\x0e\x0c\x12\x0d\x0c\x0b\x09\x06\x09\x0e\x0b'
-
-# OFFSET_WIDTH bytes per character in the same order as the MAP string
-# to the start of each character in bits.
-OFFSET_WIDTH = 2
-_OFFSETS = \
- b'\x00\x00\x00\x66\x00\xee\x01\x98\x02\x86\x03\x63\x04\xfb\x06\x0b'\
-
- ... more lines of data...
-
- b'\x49\x94\x4a\x71\x4b\x3d\x4b\xf8\x4c\x91\x4c\xf7\x4d\x90\x4e\x7e'
-
-# character bitmaps per character in the same order as the MAP string.
-# Note: character data may not start on byte boundaries
-_BITMAPS =\
- b'\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x61'\
-
- ... many more lines of data...
-
- b'\x3d\xe3\xfc\x00\x00\x00\x00\x00'
-
-WIDTHS = memoryview(_WIDTHS)
-OFFSETS = memoryview(_OFFSETS)
-BITMAPS = memoryview(_BITMAPS)
+ |
-
+8x8 Fonts¶
+
+
-8x8 Rom Fonts¶
vga1_8x8.py: 128 Character 8x8 Font¶
@@ -378,8 +309,8 @@ the negative glyph.left fix from peterhinch’s font conversion program
-
8x16 Fonts¶
+
+
8x16 Rom Fonts¶
vga1_8x16.py: 128 Character 8x16 Font¶
@@ -396,7 +327,7 @@ the negative glyph.left fix from peterhinch’s font conversion program
-
-16x16 Fonts¶
+16x16 Rom Fonts¶
vga1_16x16.py: 128 Character 16x16 Thin Font¶
@@ -426,8 +357,8 @@ the negative glyph.left fix from peterhinch’s font conversion program
-
16x32 Fonts¶
+
+
16x32 Rom Fonts¶
vga1_16x32.py: 128 Character 16x32 Thin Font¶
diff --git a/docs/genindex.html b/docs/genindex.html index c736913..868647b 100644 --- a/docs/genindex.html +++ b/docs/genindex.html @@ -13,6 +13,8 @@ + + @@ -29,6 +31,7 @@ + @@ -82,7 +85,7 @@ -Contents:
+Contents:
- st7789py Driver
- st7789py Reference @@ -99,10 +102,10 @@
- Fonts
Contents:
+Contents:
- st7789py Driver
- st7789py Reference @@ -100,10 +103,10 @@
- Fonts
-
Contents:
+Contents:
- st7789py Driver
- st7789py Reference @@ -198,10 +201,10 @@ bitmap fonts derived from classic pc text mode fonts.
- Fonts
Contents:
+Contents:
- st7789py Driver
- st7789py Reference @@ -106,10 +109,10 @@
- Fonts
Contents:
+Contents:
- st7789py Driver
- st7789py Reference @@ -102,10 +105,10 @@
- Fonts
Contents:
+Contents:
- st7789py Driver
- st7789py Reference @@ -101,10 +104,10 @@
- Fonts
Drawing converted bitmaps
-
-
-
-
st7789py.color565(red, green=0, blue=0)[source]¶
+ - +st7789py.color565(red, green=0, blue=0)[source]¶
Convert red, green and blue values (0-255) into a 16-bit 565 encoding.
-
-
-
-class
st7789py.ST7789(spi, width, height, reset, dc, cs=None, backlight=None, rotation=0)[source]¶
+ - +class st7789py.ST7789(spi, width, height, reset=None, dc=None, cs=None, backlight=None, rotation=0)[source]¶
ST7789 driver class
- Parameters
-
-
spi (spi) – spi object
-width (int) – display width
-height (int) – display height
+spi (spi) – spi object Required
+width (int) – display width Required
+height (int) – display height Required
reset (pin) – reset pin
-dc (pin) – dc pin
+dc (pin) – dc pin Required
cs (pin) – cs pin
backlight (pin) – backlight pin
rotation (int) – display rotation @@ -238,20 +241,20 @@ BIOS text mode fonts.
-
-
-
-
sleep_mode(value)[source]¶
+ - +sleep_mode(value)[source]¶
Enable or disable display sleep mode.
- Parameters @@ -264,8 +267,8 @@ BIOS text mode fonts.
-
-
-
-
inversion_mode(value)[source]¶
+ - +inversion_mode(value)[source]¶
Enable or disable display inversion mode.
- Parameters @@ -278,8 +281,8 @@ BIOS text mode fonts.
-
-
-
-
rotation(rotation)[source]¶
+ - +rotation(rotation)[source]¶
Set display rotation.
- Parameters @@ -295,8 +298,8 @@ BIOS text mode fonts.
-
-
-
-
vline(x, y, length, color)[source]¶
+ - +vline(x, y, length, color)[source]¶
Draw vertical line at the given location and color.
- Parameters @@ -311,8 +314,8 @@ BIOS text mode fonts.
-
-
-
-
hline(x, y, length, color)[source]¶
+ - +hline(x, y, length, color)[source]¶
Draw horizontal line at the given location and color.
- Parameters @@ -327,8 +330,8 @@ BIOS text mode fonts.
-
-
-
-
pixel(x, y, color)[source]¶
+ - +pixel(x, y, color)[source]¶
Draw a pixel at the given location and color.
- Parameters @@ -342,8 +345,8 @@ BIOS text mode fonts.
-
-
-
-
blit_buffer(buffer, x, y, width, height)[source]¶
+ - +blit_buffer(buffer, x, y, width, height)[source]¶
Copy buffer to display at the given location.
- Parameters @@ -359,8 +362,8 @@ BIOS text mode fonts.
-
-
-
-
rect(x, y, w, h, color)[source]¶
+ - +rect(x, y, w, h, color)[source]¶
Draw a rectangle at the given location, size and color.
- Parameters @@ -376,8 +379,8 @@ BIOS text mode fonts.
-
-
-
-
fill_rect(x, y, width, height, color)[source]¶
+ - +fill_rect(x, y, width, height, color)[source]¶
Draw a rectangle at the given location, size and filled with color.
- Parameters @@ -393,8 +396,8 @@ BIOS text mode fonts.
-
-
-
-
fill(color)[source]¶
+ - +fill(color)[source]¶
Fill the entire FrameBuffer with the specified color.
- Parameters @@ -404,8 +407,8 @@ BIOS text mode fonts.
-
-
-
-
line(x0, y0, x1, y1, color)[source]¶
+ - +line(x0, y0, x1, y1, color)[source]¶
Draw a single pixel wide line starting at x0, y0 and ending at x1, y1.
- Parameters @@ -421,8 +424,8 @@ BIOS text mode fonts.
-
-
-
-
vscrdef(tfa, vsa, bfa)[source]¶
+ - +vscrdef(tfa, vsa, bfa)[source]¶
Set Vertical Scrolling Definition.
To scroll a 135x240 display these values should be 40, 240, 40. There are 40 lines above the display that are not shown followed by @@ -441,8 +444,8 @@ changing the TFA, VSA and BFA values.
-
-
-
-
vscsad(vssa)[source]¶
+ - +vscsad(vssa)[source]¶
Set Vertical Scroll Start Address of RAM.
Defines which line in the Frame Memory will be written as the first line after the last line of the Top Fixed Area on the display
@@ -460,8 +463,8 @@ utime.sleep(0.01)
-
-
-
-
text(font, text, x0, y0, color=micropython.const, background=micropython.const)[source]¶
+ - +text(font, text, x0, y0, color=micropython.const, background=micropython.const)[source]¶
Draw text on display in specified font and colors. 8 and 16 bit wide fonts are supported.
-
@@ -479,8 +482,8 @@ fonts are supported.
-
-
-
-
bitmap(bitmap, x, y, index=0)[source]¶
+ - +bitmap(bitmap, x, y, index=0)[source]¶
Draw a bitmap on display at the specified column and row
- Parameters @@ -496,8 +499,8 @@ module
-
-
-
-
write(font, string, x, y, fg=micropython.const, bg=micropython.const)[source]¶
+ - +write(font, string, x, y, fg=micropython.const, bg=micropython.const)[source]¶
Write a string using a converted true-type font on the display starting at the specified column and row
-
@@ -515,8 +518,8 @@ at the specified column and row
-
-
-
-
write_width(font, string)[source]¶
+ - +write_width(font, string)[source]¶
Returns the width in pixels of the string if it was written with the specified font
-
diff --git a/lib/st7789py.py b/lib/st7789py.py
index 23c9f9e..072836f 100644
--- a/lib/st7789py.py
+++ b/lib/st7789py.py
@@ -164,11 +164,11 @@ class ST7789():
ST7789 driver class
Args:
- spi (spi): spi object
- width (int): display width
- height (int): display height
+ spi (spi): spi object **Required**
+ width (int): display width **Required**
+ height (int): display height **Required**
reset (pin): reset pin
- dc (pin): dc pin
+ dc (pin): dc pin **Required**
cs (pin): cs pin
backlight(pin): backlight pin
rotation (int): display rotation
@@ -177,7 +177,7 @@ class ST7789():
- 2-Inverted Portrait
- 3-Inverted Landscape
"""
- def __init__(self, spi, width, height, reset, dc,
+ def __init__(self, spi, width, height, reset=None, dc=None,
cs=None, backlight=None, rotation=0):
"""
Initialize display.
@@ -187,6 +187,9 @@ class ST7789():
"Unsupported display. 320x240, 240x240 and 135x240 are supported."
)
+ if dc is None:
+ raise ValueError("dc pin is required.")
+
self._display_width = self.width = width
self._display_height = self.height = height
self.xstart = 0
diff --git a/sphinx/Makefile b/sphinx/Makefile
new file mode 100644
index 0000000..85b43a1
--- /dev/null
+++ b/sphinx/Makefile
@@ -0,0 +1,26 @@
+# Minimal makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line.
+SPHINXOPTS =
+SPHINXBUILD = sphinx-build
+SOURCEDIR = source
+BUILDDIR = build
+
+# Put it first so that "make" without argument is like "make help".
+help:
+ @$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: help Makefile
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+ @$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+update:
+ # Update documentation on my webserver using rsync over ssh
+ # /usr/bin/rsync --progress --delete -e 'ssh -i ~/.ssh/id_rsa' -avz build/html/ penfold.owt.com:/htdocs/st7789py/
+ # update docs directory of this repo using rsync
+ /usr/bin/rsync --progress --delete -avz build/html/ ../docs/
+
\ No newline at end of file
diff --git a/sphinx/requires.txt b/sphinx/requires.txt
new file mode 100644
index 0000000..d5b9a8e
--- /dev/null
+++ b/sphinx/requires.txt
@@ -0,0 +1,6 @@
+# additional sphinx plug-ins, install using pip3
+sphinx-prompt
+sphinxcontrib.napoleon
+sphinxcontrib.napoleon
+sphinxcontrib.globalsubs
+sphinx_rtd_theme
diff --git a/sphinx/source/_static/vga1_16x16.png b/sphinx/source/_static/vga1_16x16.png
new file mode 100644
index 0000000..053c26e
Binary files /dev/null and b/sphinx/source/_static/vga1_16x16.png differ
diff --git a/sphinx/source/_static/vga1_16x32.png b/sphinx/source/_static/vga1_16x32.png
new file mode 100644
index 0000000..a1e5076
Binary files /dev/null and b/sphinx/source/_static/vga1_16x32.png differ
diff --git a/sphinx/source/_static/vga1_8x16.png b/sphinx/source/_static/vga1_8x16.png
new file mode 100644
index 0000000..1da28b3
Binary files /dev/null and b/sphinx/source/_static/vga1_8x16.png differ
diff --git a/sphinx/source/_static/vga1_8x8.png b/sphinx/source/_static/vga1_8x8.png
new file mode 100644
index 0000000..8af6ec7
Binary files /dev/null and b/sphinx/source/_static/vga1_8x8.png differ
diff --git a/sphinx/source/_static/vga1_bold_16x16.png b/sphinx/source/_static/vga1_bold_16x16.png
new file mode 100644
index 0000000..1df216b
Binary files /dev/null and b/sphinx/source/_static/vga1_bold_16x16.png differ
diff --git a/sphinx/source/_static/vga1_bold_16x32.png b/sphinx/source/_static/vga1_bold_16x32.png
new file mode 100644
index 0000000..5a6de89
Binary files /dev/null and b/sphinx/source/_static/vga1_bold_16x32.png differ
diff --git a/sphinx/source/_static/vga2_16x16.png b/sphinx/source/_static/vga2_16x16.png
new file mode 100644
index 0000000..8d3947e
Binary files /dev/null and b/sphinx/source/_static/vga2_16x16.png differ
diff --git a/sphinx/source/_static/vga2_16x32.png b/sphinx/source/_static/vga2_16x32.png
new file mode 100644
index 0000000..1f0f5bb
Binary files /dev/null and b/sphinx/source/_static/vga2_16x32.png differ
diff --git a/sphinx/source/_static/vga2_8x16.png b/sphinx/source/_static/vga2_8x16.png
new file mode 100644
index 0000000..c76c26b
Binary files /dev/null and b/sphinx/source/_static/vga2_8x16.png differ
diff --git a/sphinx/source/_static/vga2_8x8.png b/sphinx/source/_static/vga2_8x8.png
new file mode 100644
index 0000000..c06e565
Binary files /dev/null and b/sphinx/source/_static/vga2_8x8.png differ
diff --git a/sphinx/source/_static/vga2_bold_16x16.png b/sphinx/source/_static/vga2_bold_16x16.png
new file mode 100644
index 0000000..3fc37b0
Binary files /dev/null and b/sphinx/source/_static/vga2_bold_16x16.png differ
diff --git a/sphinx/source/_static/vga2_bold_16x32.png b/sphinx/source/_static/vga2_bold_16x32.png
new file mode 100644
index 0000000..e527303
Binary files /dev/null and b/sphinx/source/_static/vga2_bold_16x32.png differ
diff --git a/sphinx/source/conf.py b/sphinx/source/conf.py
new file mode 100644
index 0000000..ceec124
--- /dev/null
+++ b/sphinx/source/conf.py
@@ -0,0 +1,219 @@
+# -*- coding: utf-8 -*-
+#
+# Configuration file for the Sphinx documentation builder.
+#
+# This file does only contain a selection of the most common options. For a
+# full list see the documentation:
+# http://www.sphinx-doc.org/en/master/config
+
+# -- Path setup --------------------------------------------------------------
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+#
+import os
+import sys
+sys.path.insert(0, os.path.abspath('../../examples'))
+sys.path.insert(0, os.path.abspath('../../lib'))
+
+autodoc_mock_imports = [
+ 'micropython',
+ 'ustruct',
+ 'machine',
+ 'board',
+ 'network',
+ 'esp',
+ 'uos',
+ 'btree',
+]
+autodoc_member_order = 'bysource'
+# -- Project information -----------------------------------------------------
+
+project = u'st7789py'
+copyright = u'2020, Russ Hughes'
+author = u'Russ Hughes'
+
+# The short X.Y version
+version = u''
+# The full version, including alpha/beta/rc tags
+release = u'0.1.0'
+
+
+# -- General configuration ---------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+#
+# needs_sphinx = '1.0'
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+ 'sphinx.ext.autodoc',
+ 'sphinx.ext.doctest',
+ 'sphinxcontrib.napoleon',
+ 'sphinxcontrib.globalsubs',
+ 'sphinx.ext.autosummary',
+ 'sphinx.ext.autosectionlabel',
+ 'sphinx-prompt',
+ 'sphinx_rtd_theme',
+ 'sphinx.ext.todo',
+ 'sphinx.ext.coverage',
+ 'sphinx.ext.viewcode',
+ 'sphinx.ext.githubpages',
+]
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ['_templates']
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+#
+# source_suffix = ['.rst', '.md']
+source_suffix = '.rst'
+
+# The master toctree document.
+master_doc = 'index'
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+# This pattern also affects html_static_path and html_extra_path.
+exclude_patterns = []
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = None
+
+
+# -- Options for HTML output -------------------------------------------------
+
+# The theme to use for HTML and HTML Help pages. See the documentation for
+# a list of builtin themes.
+#
+#html_theme = 'alabaster']
+html_show_copyright = False
+html_theme = 'sphinx_rtd_theme'
+html_theme_options = {
+ 'canonical_url': '',
+ 'logo_only': False,
+ 'display_version': True,
+ 'prev_next_buttons_location': 'bottom',
+ 'style_external_links': True,
+ 'style_nav_header_background': '#2980B9',
+ # Toc options
+ 'collapse_navigation': False,
+ 'sticky_navigation': True,
+ 'navigation_depth': 4,
+ 'includehidden': True,
+ 'titles_only': False
+}
+# Theme options are theme-specific and customize the look and feel of a theme
+# further. For a list of options available for each theme, see the
+# documentation.
+#
+# html_theme_options = {}
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+html_static_path = ['_static']
+
+# Custom sidebar templates, must be a dictionary that maps document names
+# to template names.
+#
+# The default sidebars (for documents that don't match any pattern) are
+# defined by theme itself. Builtin themes are using these templates by
+# default: ``['localtoc.html', 'relations.html', 'sourcelink.html',
+# 'searchbox.html']``.
+#
+# html_sidebars = {}
+
+
+# -- Options for HTMLHelp output ---------------------------------------------
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = 'st7789pydoc'
+
+
+# -- Options for LaTeX output ------------------------------------------------
+
+latex_elements = {
+ # The paper size ('letterpaper' or 'a4paper').
+ #
+ # 'papersize': 'letterpaper',
+
+ # The font size ('10pt', '11pt' or '12pt').
+ #
+ # 'pointsize': '10pt',
+
+ # Additional stuff for the LaTeX preamble.
+ #
+ # 'preamble': '',
+
+ # Latex figure (float) alignment
+ #
+ # 'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+# author, documentclass [howto, manual, or own class]).
+latex_documents = [
+ (master_doc, 'st7789py.tex', u'st7789py Documentation',
+ u'Russ Hughes', 'manual'),
+]
+
+
+# -- Options for manual page output ------------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+ (master_doc, 'st7789py', u'st7789py Documentation',
+ [author], 1)
+]
+
+
+# -- Options for Texinfo output ----------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+# dir menu entry, description, category)
+texinfo_documents = [
+ (master_doc, 'st7789py', u'st7789py Documentation',
+ author, 'st7789py', 'One line description of project.',
+ 'Miscellaneous'),
+]
+
+
+# -- Options for Epub output -------------------------------------------------
+
+# Bibliographic Dublin Core info.
+epub_title = project
+
+# The unique identifier of the text. This can be a ISBN number
+# or the project homepage.
+#
+# epub_identifier = ''
+
+# A unique identification for the text.
+#
+# epub_uid = ''
+
+# A list of files that should not be packed into the epub file.
+epub_exclude_files = ['search.html']
+
+
+# -- Extension configuration -------------------------------------------------
+
+# -- Options for todo extension ----------------------------------------------
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
diff --git a/sphinx/source/examples.rst b/sphinx/source/examples.rst
new file mode 100644
index 0000000..49461bf
--- /dev/null
+++ b/sphinx/source/examples.rst
@@ -0,0 +1,72 @@
+Example Programs
+================
+
+These examples run on the LilyGo TTGO-T-Display available from the usual
+locations. See https://github.com/Xinyuan-LilyGO/TTGO-T-Display for more
+information.
+
+
+ttgo_lines.py
+-------------
+
+.. literalinclude:: ../../examples/ttgo_lines.py
+ :linenos:
+ :language: python
+
+
+ttgo_hello.py
+-------------
+
+.. literalinclude:: ../../examples/ttgo_hello.py
+ :linenos:
+ :language: python
+
+
+ttgo_fonts.py
+-------------
+
+.. literalinclude:: ../../examples/ttgo_fonts.py
+ :linenos:
+ :language: python
+
+
+ttgo_scroll.py
+--------------
+
+.. literalinclude:: ../../examples/ttgo_scroll.py
+ :linenos:
+ :language: python
+
+
+toasters.py
+-----------
+
+Flying toasters sprite demo using bitmaps created from spritesheet using
+ImageMagick's convert and imgtobitmap.py utility. See the maketoast script in the utils directory for details.
+
+.. literalinclude:: ../../examples/toasters/toasters.py
+ :linenos:
+ :language: python
+
+
+chango.py
+---------
+
+Test for font2bitmap converter for the driver.
+See the font2bitmap program in the utils directory.
+
+.. literalinclude:: ../../examples/truetype/chango.py
+ :linenos:
+ :language: python
+
+
+noto_fonts.py
+-------------
+
+Test for font2bitmap converter for the driver.
+See the font2bitmap program in the utils directory.
+
+.. literalinclude:: ../../examples/truetype/noto_fonts.py
+ :linenos:
+ :language: python
+
diff --git a/sphinx/source/fonts.rst b/sphinx/source/fonts.rst
new file mode 100644
index 0000000..c334f96
--- /dev/null
+++ b/sphinx/source/fonts.rst
@@ -0,0 +1,152 @@
+Fonts
+=====
+
+Two type of fonts are supported by this driver fixed size bitmap fonts
+converted from PC Bios images using the font_from_romfont utility and fixed or proportional fonts converted from True-Type fonts using the font2bitmap utility.
+
+The rom fonts are available in 128 and 256 PC character sets in 8x8, 8x16, 16x6 and 16x32 pixel sizes. They written using the text method.
+
+The True-Type fonts can be converted to any size as long as the widest
+character is 256 pixels or less. They are written using the write method.
+
+Pre-compiling the font files to .mpy files will significantly reduce the memory required for the fonts.
+
+Rom Font Conversion
+-------------------
+
+The `utils` directory contains the font_from_romfont.py program used to convert PC BIOS bitmap fonts from the font-bin directory of spacerace's
+https://github.com/spacerace/romfont repo.
+
+The utility converts all romfont bin files in the specified -input-directory (-i) and writes python font files to the specified -output-directory (-o).
+
+Characters included can be limited by using the -first-char (-f) and -last-char (-l) options.
+
+Example:
+
+ font_from_romfont -i font-bin -o fonts -f 32 -l 127
+
+
+.. literalinclude:: romfont.py
+ :linenos:
+ :language: python
+ :caption: Sample converted romfont font module.
+
+
+True-Type Font Conversion
+-------------------------
+
+The `utils` directory contains the `font2bitmap.py` program used to convert True-Type font into bitmap font modules. Use the -h option to see details of the available options. The `font2bitmap.py` program uses font handling classes from Dan Bader blog post on using freetype
+http://dbader.org/blog/monochrome-font-rendering-with-freetype-and-python and
+the negative glyph.left fix from peterhinch's font conversion program
+https://github.com/peterhinch/micropython-font-to-py.
+
+The utility requires the python freetype module.
+
+Example use:
+
+- ./font2bitmap NotoSans-Regular.ttf 32 -s "0123456789ABCEDF"
+- ./font2bitmap.py Chango-Regular.ttf 16 -c 0x20-0x7f
+
+
+.. literalinclude:: truetype.py
+ :linenos:
+ :language: python
+ :caption: Sample converted TrueType font module.
+
+
+
+8x8 Rom Fonts
+-------------
+
+.. figure:: _static/vga1_8x8.png
+ :align: center
+
+ vga1_8x8.py: 128 Character 8x8 Font
+
+|
+
+.. figure:: _static/vga2_8x8.png
+ :align: center
+
+ vga2_8x8.py: 256 Character 8x8 Font
+
+|
+
+8x16 Rom Fonts
+--------------
+
+.. figure:: _static/vga1_8x16.png
+ :align: center
+
+ vga1_8x16.py: 128 Character 8x16 Font
+
+|
+
+.. figure:: _static/vga2_8x16.png
+ :align: center
+
+ vga2_8x16.py: 256 Character 8x16 Font
+
+|
+
+16x16 Rom Fonts
+---------------
+
+.. figure:: _static/vga1_16x16.png
+ :align: center
+
+ vga1_16x16.py: 128 Character 16x16 Thin Font
+
+|
+
+.. figure:: _static/vga1_bold_16x16.png
+ :align: center
+
+ vga1_bold_16x16.py: 128 Character 16x16 Bold Font
+
+|
+
+.. figure:: _static/vga2_16x16.png
+ :align: center
+
+ vga2_16x16.py: 256 Character 16x16 Thin Font
+
+|
+
+.. figure:: _static/vga2_bold_16x16.png
+ :align: center
+
+ vga2_bold_16x16.py: 256 Character 16x16 Bold Font
+
+|
+
+16x32 Rom Fonts
+---------------
+
+.. figure:: _static/vga1_16x32.png
+ :align: center
+
+ vga1_16x32.py: 128 Character 16x32 Thin Font
+
+|
+
+.. figure:: _static/vga1_bold_16x32.png
+ :align: center
+
+ vga1_bold_16x32.py: 128 Character 16x32 Bold Font
+
+|
+
+.. figure:: _static/vga2_16x32.png
+ :align: center
+
+ vga2_16x32.py: 256 Character 16x32 Thin Font
+
+|
+
+.. figure:: _static/vga2_bold_16x32.png
+ :align: center
+
+ vga2_bold_16x32.py: 256 Character 16x32 Bold Font
+
+|
diff --git a/sphinx/source/index.rst b/sphinx/source/index.rst
new file mode 100644
index 0000000..b1f6d73
--- /dev/null
+++ b/sphinx/source/index.rst
@@ -0,0 +1,24 @@
+st7789py Driver
+===============
+
+st7789 tft driver in MicroPython based on devbis' st7789py_mpy module from
+https://github.com/devbis/st7789py_mpy.
+
+I added support for display rotation, scrolling and drawing text using 8 and 16
+bit wide bitmap fonts with heights that are multiples of 8. Included are 12
+bitmap fonts derived from classic pc text mode fonts.
+
+
+.. toctree::
+ :maxdepth: 2
+ :caption: Contents:
+
+ self
+ st7789py
+ examples
+ fonts
+
+Index
+=====
+
+* :ref:`genindex`
diff --git a/sphinx/source/romfont.py b/sphinx/source/romfont.py
new file mode 100644
index 0000000..d52825c
--- /dev/null
+++ b/sphinx/source/romfont.py
@@ -0,0 +1,27 @@
+"""converted from vga_8x8.bin """
+
+# font width
+WIDTH = 8
+
+# font height
+HEIGHT = 8
+
+# first character in front
+FIRST = 0x20
+
+# last character in font
+LAST = 0x7f
+
+# bitmap of each character from FIRST to LAST
+_FONT =\
+b'\x00\x00\x00\x00\x00\x00\x00\x00'\
+b'\x18\x3c\x3c\x18\x18\x00\x18\x00'\
+b'\x66\x66\x24\x00\x00\x00\x00\x00'\
+
+... many more lines of data...
+
+b'\x70\x18\x18\x0e\x18\x18\x70\x00'\
+b'\x76\xdc\x00\x00\x00\x00\x00\x00'\
+b'\x00\x10\x38\x6c\xc6\xc6\xfe\x00'\
+
+FONT = memoryview(_FONT)
diff --git a/sphinx/source/st7789py.rst b/sphinx/source/st7789py.rst
new file mode 100644
index 0000000..9f4b014
--- /dev/null
+++ b/sphinx/source/st7789py.rst
@@ -0,0 +1,5 @@
+st7789py Reference
+==================
+
+.. automodule:: st7789py
+ :members:
diff --git a/sphinx/source/truetype.py b/sphinx/source/truetype.py
new file mode 100644
index 0000000..38e53d5
--- /dev/null
+++ b/sphinx/source/truetype.py
@@ -0,0 +1,47 @@
+# -*- coding: utf-8 -*-
+# Converted from Chango-Regular.ttf using:
+# ./font2bitmap.py Chango-Regular.ttf 16 -c 0x20-0x7f
+
+# Maps the order of the character data
+MAP = " !\"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\\]^_`abcdefghijklmnopqrstuvwxyz{|}~"
+
+# Number of color bits per pixel, currently only 1 is used but could be
+# increased to support antialiased or smoothed fonts in the future.
+BPP = 1
+
+# Font height
+HEIGHT = 17
+
+# Font max width
+MAX_WIDTH = 24
+
+# one byte per character table of widths in the same order as the MAP string
+_WIDTHS = \
+ b'\x06\x08\x0a\x0e\x0d\x18\x10\x06\x08\x08\x0a\x0d\x06\x08\x06\x0b'\
+
+ ... more lines of data...
+
+ b'\x0d\x0d\x0b\x0a\x0b\x0e\x0c\x12\x0d\x0c\x0b\x09\x06\x09\x0e\x0b'
+
+# OFFSET_WIDTH bytes per character in the same order as the MAP string
+# to the start of each character in bits.
+OFFSET_WIDTH = 2
+_OFFSETS = \
+ b'\x00\x00\x00\x66\x00\xee\x01\x98\x02\x86\x03\x63\x04\xfb\x06\x0b'\
+
+ ... more lines of data...
+
+ b'\x49\x94\x4a\x71\x4b\x3d\x4b\xf8\x4c\x91\x4c\xf7\x4d\x90\x4e\x7e'
+
+# character bitmaps per character in the same order as the MAP string.
+# Note: character data may not start on byte boundaries
+_BITMAPS =\
+ b'\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x61'\
+
+ ... many more lines of data...
+
+ b'\x3d\xe3\xfc\x00\x00\x00\x00\x00'
+
+WIDTHS = memoryview(_WIDTHS)
+OFFSETS = memoryview(_OFFSETS)
+BITMAPS = memoryview(_BITMAPS)