adding font with license file

LICENSES/OFL-1.1.txt

@@ -0,0 +1,109 @@
+    Copyright (c) 2016-2020, Tyler Finck <hi@tylerfinck.com>
+
+    Copyright (c) 2014, Micah Rich <micah@micahrich.com>,
+    with Reserved Font Name: "League Spartan".
+
+    This Font Software is licensed under the SIL Open Font License, Version 1.1.
+    This license is copied below, and is also available with a FAQ at:
+    http://scripts.sil.org/OFL
+
+    Version 1.1 - 26 February 2007
+
+----
+
+SIL Open Font License
+=====================
+
+
+Preamble
+--------
+
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+Definitions
+-----------
+
+`"Font Software"` refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+`"Reserved Font Name"` refers to any names specified as such after the
+copyright statement(s).
+
+`"Original Version"` refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+`"Modified Version"` refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+`"Author"` refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+Permission & Conditions
+-----------------------
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1. Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2. Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3. No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4. The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5. The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+Termination
+-----------
+
+This license becomes null and void if any of the above conditions are
+not met.
+
+Disclaimer
+----------
+
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

examples/display_text_background_color_padding.py

@@ -5,58 +5,70 @@
 import board
 import displayio
 
-
-# from adafruit_st7789 import ST7789
-from adafruit_ili9341 import ILI9341
 from adafruit_bitmap_font import bitmap_font
 from adafruit_display_text import label
 
-#  Setup the SPI display
-
-print("Starting the display...")  # goes to serial only
-displayio.release_displays()
-
-
-spi = board.SPI()
-tft_cs = board.D9  # arbitrary, pin not used
-tft_dc = board.D10
-tft_backlight = board.D12
-tft_reset = board.D11
 
-while not spi.try_lock():
-    spi.configure(baudrate=32000000)
-spi.unlock()
-
-display_bus = displayio.FourWire(
-    spi,
-    command=tft_dc,
-    chip_select=tft_cs,
-    reset=tft_reset,
-    baudrate=32000000,
-    polarity=1,
-    phase=1,
-)
+#  Setup the SPI display
+if "DISPLAY" in dir(board):
+    # use built in display (PyPortal, PyGamer, PyBadge, CLUE, etc.)
+    # see guide for setting up external displays (TFT / OLED breakouts, RGB matrices, etc.)
+    # https://learn.adafruit.com/circuitpython-display-support-using-displayio/display-and-display-bus
+    display = board.DISPLAY
+
+else:
+    print("Starting external display")  # goes to serial only
+    # Setup the LCD display with driver
+    # You may need to change this to match the display driver for the chipset
+    # used on your display
+    from adafruit_ili9341 import ILI9341
+
+    # from adafruit_st7789 import ST7789
+
+    displayio.release_displays()
+
+    # setup the SPI bus
+    spi = board.SPI()
+    tft_cs = board.D9  # arbitrary, pin not used
+    tft_dc = board.D10
+    tft_backlight = board.D12
+    tft_reset = board.D11
+
+    while not spi.try_lock():
+        spi.configure(baudrate=32000000)
+    spi.unlock()
+
+    display_bus = displayio.FourWire(
+        spi,
+        command=tft_dc,
+        chip_select=tft_cs,
+        reset=tft_reset,
+        baudrate=32000000,
+        polarity=1,
+        phase=1,
+    )
 
-print("spi.frequency: {}".format(spi.frequency))
+    # Number of pixels in the display
+    DISPLAY_WIDTH = 320
+    DISPLAY_HEIGHT = 240
 
-DISPLAY_WIDTH = 320
-DISPLAY_HEIGHT = 240
+    # display = ST7789(display_bus, width=240, height=240, rotation=0, rowstart=80, colstart=0)
 
-# display = ST7789(display_bus, width=240, height=240, rotation=0, rowstart=80, colstart=0)
-display = ILI9341(
-    display_bus,
-    width=DISPLAY_WIDTH,
-    height=DISPLAY_HEIGHT,
-    rotation=180,
-    auto_refresh=True,
-)
+    # create the display
+    display = ILI9341(
+        display_bus,
+        width=DISPLAY_WIDTH,
+        height=DISPLAY_HEIGHT,
+        rotation=180,  # The rotation can be adjusted to match your configuration.
+        auto_refresh=True,
+        native_frames_per_second=90,
+    )
 
 display.show(None)
 
 # font=terminalio.FONT # this is the Builtin fixed dimension font
 
-font = bitmap_font.load_font("fonts/Helvetica-Bold-16.bdf")
-
+font = bitmap_font.load_font("fonts/LeagueSpartan-Bold-16.bdf")
 
 text = []
 text.append("none")  # no ascenders or descenders

examples/display_text_label_vs_bitmap_label_comparison.py

@@ -29,14 +29,20 @@
     fontList = []
 
     # Load some proportional fonts
-    fontFile = "fonts/Helvetica-Bold-16.bdf"
+    fontFile = "fonts/LeagueSpartan-Bold-16.bdf"
     fontToUse = bitmap_font.load_font(fontFile)
 
 # Set scaling factor for display text
 my_scale = 1
 
 #  Setup the SPI display
-if "DISPLAY" not in dir(board):
+if "DISPLAY" in dir(board):
+    # use built in display (PyPortal, PyGamer, PyBadge, CLUE, etc.)
+    # see guide for setting up external displays (TFT / OLED breakouts, RGB matrices, etc.)
+    # https://learn.adafruit.com/circuitpython-display-support-using-displayio/display-and-display-bus
+    display = board.DISPLAY
+
+else:
     # Setup the LCD display with driver
     # You may need to change this to match the display driver for the chipset
     # used on your display
@@ -81,13 +87,9 @@
 
     # reset the display to show nothing.
     display.show(None)
-else:
-    # built-in display
-    display = board.DISPLAY
 
 print("Display is started")
 
-
 preload_glyphs = (
     True  # set this to True if you want to preload the font glyphs into memory
 )