add support for 9.x and 10.x tilepalettemapper API.

Author: FoamyGuy

Metro/Metro_RP2350_CircuitPython_Matrix/code.py

@@ -19,7 +19,7 @@
 
 
 # use the built-in HSTX display
-request_display_config(320,240)
+request_display_config(320, 240)
 display = supervisor.runtime.display
 
 # screen size in tiles, tiles are 16x16
@@ -67,7 +67,12 @@
     shader_palette[i + 1] = COLORS[i]
 
 # mapper to change colors of tiles within the grid
-grid_color_shader = TilePaletteMapper(shader_palette, 2)
+if sys.implementation.version[0] == 9:
+    grid_color_shader = TilePaletteMapper(
+        shader_palette, 2, SCREEN_WIDTH, SCREEN_HEIGHT
+    )
+elif sys.implementation.version[0] >= 10:
+    grid_color_shader = TilePaletteMapper(shader_palette, 2)
 
 # load the spritesheet
 katakana_bmp, katakana_pixelshader = adafruit_imageload.load("matrix_characters.bmp")

Metro/Metro_RP2350_Match3/match3_game/code.py

@@ -9,6 +9,7 @@
 import atexit
 import io
 import os
+import sys
 import time
 
 import board
@@ -217,7 +218,11 @@
 
 # create tile palette mappers
 for i in range(2):
-    palette_mapper = TilePaletteMapper(remap_palette, 3)
+    if sys.implementation.version[0] == 9:
+        palette_mapper = TilePaletteMapper(remap_palette, 3, 1, 1)
+    elif sys.implementation.version[0] >= 10:
+        palette_mapper = TilePaletteMapper(remap_palette, 3)
+
     palette_mappers.append(palette_mapper)
 
     # create tilegrid for each mouse

Metro/Metro_RP2350_Match3/match3_game/match3_game_helpers.py

@@ -3,6 +3,7 @@
 # SPDX-License-Identifier: MIT
 import os
 import random
+import sys
 import time
 from io import BytesIO
 
@@ -133,7 +134,10 @@ class Match3Card(Group):
 
     def __init__(self, card_tuple, **kwargs):
         # tile palette mapper to color the card
-        self._mapper = TilePaletteMapper(kwargs["pixel_shader"], 5)
+        if sys.implementation.version[0] == 9:
+            self._mapper = TilePaletteMapper(kwargs["pixel_shader"], 5, 1, 1)
+        elif sys.implementation.version[0] >= 10:
+            self._mapper = TilePaletteMapper(kwargs["pixel_shader"], 5)
         kwargs["pixel_shader"] = self._mapper
         # tile grid to for the visible sprite
         self._tilegrid = TileGrid(**kwargs)
@@ -580,9 +584,11 @@ def handle_left_click(self, player_index, coords):
                         # if 3 cards have been clicked
                         if len(self.clicked_cards) == 3:
                             # check if the 3 cards make a valid set
-                            valid_set = validate_set(self.clicked_cards[0],
-                                                     self.clicked_cards[1],
-                                                     self.clicked_cards[2])
+                            valid_set = validate_set(
+                                self.clicked_cards[0],
+                                self.clicked_cards[1],
+                                self.clicked_cards[2],
+                            )
 
                             # if they are a valid set
                             if valid_set:
@@ -660,7 +666,9 @@ def handle_left_click(self, player_index, coords):
                 # load the game from the given game state
                 self.load_from_game_state(self.game_state)
                 # hide the title screen
-                self.title_screen.hidden = True  # pylint: disable=attribute-defined-outside-init
+                self.title_screen.hidden = (
+                    True  # pylint: disable=attribute-defined-outside-init
+                )
                 # set the current state to open play
                 self.cur_state = STATE_PLAYING_OPEN
 
@@ -676,7 +684,9 @@ def handle_left_click(self, player_index, coords):
                 # initialize a new game
                 self.init_new_game()
                 # hide the title screen
-                self.title_screen.hidden = True  # pylint: disable=attribute-defined-outside-init
+                self.title_screen.hidden = (
+                    True  # pylint: disable=attribute-defined-outside-init
+                )
                 # set the current state to open play
                 self.cur_state = STATE_PLAYING_OPEN
 

Metro/Metro_RP2350_Match3/tilepalettemapper_demo/code.py

@@ -1,6 +1,7 @@
 # SPDX-FileCopyrightText: Copyright (c) 2025 Tim Cocks for Adafruit Industries
 #
 # SPDX-License-Identifier: MIT
+import sys
 
 import supervisor
 from displayio import Group, OnDiskBitmap, TileGrid
@@ -20,14 +21,28 @@
 spritesheet_bmp = OnDiskBitmap("match3_cards_spritesheet.bmp")
 
 # create a TilePaletteMapper
-tile_palette_mapper = TilePaletteMapper(
-    spritesheet_bmp.pixel_shader,  # input pixel_shader
-    5,  # input color count
-)
+if sys.implementation.version[0] == 9:
+    tile_palette_mapper = TilePaletteMapper(
+        spritesheet_bmp.pixel_shader,  # input pixel_shader
+        5,  # input color count
+        3,  # grid width
+        1,  # grid height
+    )
+elif sys.implementation.version[0] >= 10:
+    tile_palette_mapper = TilePaletteMapper(
+        spritesheet_bmp.pixel_shader,  # input pixel_shader
+        5,  # input color count
+    )
 
 # create a TileGrid to show some cards
-cards_tilegrid = TileGrid(spritesheet_bmp, pixel_shader=tile_palette_mapper,
-                          width=3, height=1, tile_width=24, tile_height=32)
+cards_tilegrid = TileGrid(
+    spritesheet_bmp,
+    pixel_shader=tile_palette_mapper,
+    width=3,
+    height=1,
+    tile_width=24,
+    tile_height=32,
+)
 
 # set each tile in the grid to a different sprite index
 cards_tilegrid[0, 0] = 10