Merge pull request #2471 from adafruit/TheKitty-patch-5

Add additional files for Learn Guide

Author: TheKitty

CircuitPython_gifio/Feather/code-multi-feather-direct.py

@@ -0,0 +1,69 @@
+# SPDX-FileCopyrightText: 2023 Anne Barela for Adafruit Industries
+#
+# SPDX-License-Identifier: MIT
+#
+# Play Multiple GIF files on a n ESP32-S2 Feather TFT
+# Requires CircuitPython 8.1.0-beta.1 or later
+# Updated 4/4/2023
+
+import time
+import gc
+import os
+import struct
+import board
+import gifio
+import digitalio
+
+# Get a dictionary of GIF filenames at the passed base directory
+def get_files(base):
+    allfiles = os.listdir(base)
+    file_names = []
+    for _, filetext in enumerate(allfiles):
+        if not filetext.startswith("."):
+            if filetext not in ('boot_out.txt', 'System Volume Information'):
+                if filetext.endswith(".gif"):
+                    file_names.append(filetext)
+    return file_names
+
+# Set BOOT button on ESP32-S2 Feather TFT to advance to next GIF
+button = digitalio.DigitalInOut(board.BUTTON)
+button.switch_to_input(pull=digitalio.Pull.UP)
+
+display = board.DISPLAY
+
+# Take over display to drive directly
+display.auto_refresh = False
+display_bus = display.bus
+
+files = get_files("/")
+for i in range(len(files)):
+
+    odg = gifio.OnDiskGif(files[i])
+    # Skip PyPortal GIFs if put on ESP32-S2 Feather TFT
+    if odg.width != board.DISPLAY.width:
+        print("File "+files[i]+" not right width, skipping\n")
+        continue
+
+    start = time.monotonic()
+    next_delay = odg.next_frame()  # Load the first frame
+    end = time.monotonic()
+    call_delay = end - start
+
+    # Display GIF file frames until screen touched (for PyPortal)
+    while True:
+        sleeptime = max(0, next_delay - call_delay)
+        time.sleep(sleeptime)
+        # If the BOOT button is pressed, advance to next GIF file
+        if button.value is False:
+            print("Button Press, Advance\n")
+            break
+        next_delay = odg.next_frame()
+        display_bus.send(42, struct.pack(">hh", 0, odg.bitmap.width - 1))
+        display_bus.send(43, struct.pack(">hh", 0, odg.bitmap.height - 1))
+        display_bus.send(44, odg.bitmap)
+    # End while
+    # Clean up memory
+    odg.deinit()
+    odg = None
+    gc.collect()
+# End for

CircuitPython_gifio/Feather/code-single-displayio-feather.py

@@ -0,0 +1,56 @@
+# SPDX-FileCopyrightText: 2023 Anne Barela for Adafruit Industries
+#
+# SPDX-License-Identifier: MIT
+#
+# Play a single animated GIF file (display_bus "fast" method)
+#
+# Documentation:
+#   https://docs.circuitpython.org/en/latest/shared-bindings/gifio/
+# Updated 4/5/2023
+
+import time
+import gc
+import board
+import gifio
+import digitalio
+import displayio
+
+display = board.DISPLAY
+splash = displayio.Group()
+display.root_group = splash
+
+# Set BOOT button on ESP32-S2 Feather TFT to stop GIF
+button = digitalio.DigitalInOut(board.BUTTON)
+button.switch_to_input(pull=digitalio.Pull.UP)
+
+# Open GIF file sample.gif
+odg = gifio.OnDiskGif('/sample.gif')
+
+start = time.monotonic()
+next_delay = odg.next_frame()  # Load the first frame
+end = time.monotonic()
+overhead = end - start
+
+face = displayio.TileGrid(
+    odg.bitmap,
+    pixel_shader=displayio.ColorConverter(
+        input_colorspace=displayio.Colorspace.RGB565_SWAPPED
+    ),
+)
+splash.append(face)
+board.DISPLAY.refresh()
+
+# Display repeatedly & directly.
+while True:
+    # Sleep for the frame delay specified by the GIF,
+    # minus the overhead measured to advance between frames.
+    time.sleep(max(0, next_delay - overhead))
+    # If the BOOT button is pressed, stop the GIF
+    if button.value is False:
+        print("Button Press, Stop\n")
+        break
+    next_delay = odg.next_frame()
+# End While - cleanup memory
+odg.deinit()
+odg = None
+gc.collect()

CircuitPython_gifio/Feather/sample-invaders-small.gif

@@ -0,0 +1,70 @@
+# SPDX-FileCopyrightText: 2023 Anne Barela for Adafruit Industries
+#
+# SPDX-License-Identifier: MIT
+#
+# Play Multiple GIF files on a PyPortal
+# Requires CircuitPython 8.1.0-beta.1 or later
+# Updated 4/4/2023
+
+import time
+import gc
+import os
+import struct
+import board
+import gifio
+import adafruit_touchscreen
+
+# Get a dictionary of GIF filenames at the passed base directory
+def get_files(base):
+    allfiles = os.listdir(base)
+    file_names = []
+    for _, filetext in enumerate(allfiles):
+        if not filetext.startswith("."):
+            if filetext not in ('boot_out.txt', 'System Volume Information'):
+                if filetext.endswith(".gif"):
+                    file_names.append(filetext)
+    return file_names
+
+display = board.DISPLAY
+
+# Take over display to drive directly
+display.auto_refresh = False
+display_bus = display.bus
+
+# Pyportal has a touchscreen, a touch advances to next GIF file
+WIDTH = board.DISPLAY.width
+HEIGHT = board.DISPLAY.height
+ts = adafruit_touchscreen.Touchscreen(board.TOUCH_XL, board.TOUCH_XR,
+                                      board.TOUCH_YD, board.TOUCH_YU,
+                                      calibration=((5200, 59000), (5800, 57000)),
+                                      size=(WIDTH, HEIGHT))
+files = get_files("/")
+for i in range(len(files)):
+
+    odg = gifio.OnDiskGif(files[i])
+    # Skip Feather GIFs if put on PyPortal
+    if odg.width != WIDTH:
+        print("File "+files[i]+" not right width, skipping\n")
+        continue
+
+    start = time.monotonic()
+    next_delay = odg.next_frame()  # Load the first frame
+    end = time.monotonic()
+    call_delay = end - start
+
+    # Display GIF file frames until screen touched (for PyPortal)
+    while True:
+        sleeptime = max(0, next_delay - call_delay)
+        time.sleep(sleeptime)
+        if ts.touch_point is not None:
+            break
+        next_delay = odg.next_frame()
+        display_bus.send(42, struct.pack(">hh", 0, odg.bitmap.width - 1))
+        display_bus.send(43, struct.pack(">hh", 0, odg.bitmap.height - 1))
+        display_bus.send(44, odg.bitmap)
+    # End while
+    # Clean up memory
+    odg.deinit()
+    odg = None
+    gc.collect()
+# End for

CircuitPython_gifio/Feather/sample-parrot-small.gif

@@ -0,0 +1,55 @@
+# SPDX-FileCopyrightText: 2023 Anne Barela for Adafruit Industries
+#
+# SPDX-License-Identifier: MIT
+#
+# gifio demo for the Adafruit PyPortal - single file
+#
+# Documentation:
+#   https://docs.circuitpython.org/en/latest/shared-bindings/gifio/
+# Updated 4/5/2023
+#
+import time
+import gc
+import board
+import gifio
+import displayio
+import adafruit_touchscreen
+
+display = board.DISPLAY
+splash = displayio.Group()
+display.root_group = splash
+
+# Pyportal has a touchscreen, a touch stops the display
+WIDTH = board.DISPLAY.width
+HEIGHT = board.DISPLAY.height
+ts = adafruit_touchscreen.Touchscreen(board.TOUCH_XL, board.TOUCH_XR,
+                                      board.TOUCH_YD, board.TOUCH_YU,
+                                      calibration=((5200, 59000), (5800, 57000)),
+                                      size=(WIDTH, HEIGHT))
+
+odg = gifio.OnDiskGif('/sample.gif')
+
+start = time.monotonic()
+next_delay = odg.next_frame()  # Load the first frame
+end = time.monotonic()
+call_delay = end - start
+
+# Depending on your display the next line may need Colorspace.RGB565
+#   instead of Colorspace.RGB565_SWAPPED
+face = displayio.TileGrid(odg.bitmap,
+                          pixel_shader=displayio.ColorConverter
+                          (input_colorspace=displayio.Colorspace.RGB565_SWAPPED))
+splash.append(face)
+board.DISPLAY.refresh()
+
+# Play the GIF file until screen is touched
+while True:
+    time.sleep(max(0, next_delay - call_delay))
+    next_delay = odg.next_frame()
+    if ts.touch_point is not None:
+        break
+# End while
+# Clean up memory
+odg.deinit()
+odg = None
+gc.collect()

CircuitPython_gifio/PyPortal/code-multi-pyportal-direct.py

@@ -2,8 +2,8 @@
 ## Playing Animated GIF Files in CircuitPython
 
 Two sample boards: Adafruit PyPortal and ESP32-S2 Feather TFT
-Two Speeds: Using displayio and using direct display writes
-Two Examples: Display a single GIF and display multiple GIFs
+
+Display a single GIF and display multiple GIFs
 
 Anne Barela for Adafruit Industries