RGBMatrixEmulator 0.17.0__tar.gz → 0.18.0__tar.gz

rgbmatrixemulator-0.17.0/README.md → rgbmatrixemulator-0.18.0/PKG-INFO

@@ -1,3 +1,32 @@
+Metadata-Version: 2.4
+Name: RGBMatrixEmulator
+Version: 0.18.0
+Summary: A PC emulator for Raspberry Pi LED matrices driven by rpi-rgb-led-matrix
+Project-URL: Homepage, https://github.com/ty-porter/RGBMatrixEmulator
+Author-email: Tyler Porter <tyler.b.porter@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: LED,LED matrix,RPI,matrix,raspberry,raspberry pi
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Other Audience
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Other/Nonlisted Topic
+Requires-Python: >=3.10
+Requires-Dist: bdfparser<=2.2.0
+Requires-Dist: numpy>=1.2.0
+Requires-Dist: pillow>=10.0.1
+Requires-Dist: tornado>=6.5.5
+Provides-Extra: pygame
+Requires-Dist: pygame<3,>=2.0.1; extra == 'pygame'
+Provides-Extra: sixel
+Requires-Dist: libsixel-python>=0.5.0; extra == 'sixel'
+Description-Content-Type: text/markdown
+
 # `RGBMatrixEmulator`
 
 [![pypi Badge](https://img.shields.io/pypi/v/RGBMatrixEmulator)](https://pypi.org/project/RGBMatrixEmulator/)
@@ -34,17 +63,15 @@ The following adapters are supported but not installed by default.
 
 * `sixel`
 * `pygame`
-* `pi5` (experimental)
 
 You can install optional adapters via `pip`:
 
 ```sh
 pip install RGBMatrixEmulator[sixel]
 pip install RGBMatrixEmulator[pygame]
-pip install RGBMatrixEmulator[pi5]
 
 # All optional adapters at once
-pip install RGBMatrixEmulator[sixel,pygame,pi5]
+pip install RGBMatrixEmulator[sixel,pygame]
 ```
 
 ## Usage
@@ -152,16 +179,6 @@ The config file enables configurations to be customized on a per-script basis. Y
     "image_format": "JPEG",
     "open_immediately": false
   },
-  "pi5": {
-    "_comment": "For use with the pi5 adapter only.",
-    "pinout": "AdafruitMatrixBonnet",
-    "n_addr_lines": 4,
-    "rotation": "Normal",
-    "n_planes": 10,
-    "n_temporal_planes": 4,
-    "n_lanes": 1,
-    "led_rgb_sequence": "RGB"
-  },
   "log_level": "info"
 }
 ```
@@ -206,18 +223,6 @@ Certain adapters may specify additional configurations. These specialized config
 | browser.image_format     | String  | Image format to use for rendering. Options are "JPEG" or "PNG".
 | browser.open_immediately | Bool    | Open a new browser window immediately on startup (similar to other adapters).
 
-##### `pi5` Options
-
-| Key | Type | Description |
-| --- | ---- | ----------- |
-| pi5.pinout            | String  | The hardware pinout definition. Matches attributes in `piomatter.Pinout` (e.g., "Active3", "AdafruitMatrixHat", "AdafruitMatrixBonnet").
-| pi5.n_addr_lines      | Integer | Number of address lines for the display. Typically `4` for 32-pixel height panels, or `5` for 64-pixel height panels.
-| pi5.led_rgb_sequence  | String  | Color sequence of the LEDs (e.g., "RGB", "BGR", "RBG").
-| pi5.rotation          | String  | Display rotation. Matches attributes in `piomatter.Orientation` (e.g., "Normal", "R180", "CW", "CCW"). Does not work with "Active3" pinouts.
-| pi5.n_lanes           | Integer | Number of parallel matrix chains (lanes). Only works with Active3 boards. Must be 2 or more.
-| pi5.n_planes          | Integer | Colour Bit depth/number of planes. Maximum of 10, minimum of 1.
-| pi5.n_temporal_planes | Integer | Number of temporal planes for dithering/brightness control. Possible values are 0, 2 or 4 and can't be greater than the value of n_planes.
-
 ### Display Adapters
 
 By default, `RGBMatrixEmulator` uses `browser` as its display adapter for maximum compatibility with different operating systems as well as thread-safety. However, you can also use other display adapters as well if the default adapter does not suit your needs.
@@ -230,7 +235,6 @@ Currently supported display adapters are:
 * `tkinter`
 * `turtle`
 * `sixel`
-* `pi5` (experimental)
 * `raw`
 
 You can swap display adapters by changing the `display_adapter` value to one of the above in `emulator_config.json`.
@@ -241,15 +245,6 @@ You can swap display adapters by changing the `display_adapter` value to one of
 
 Please see the [README for the `browser` display adapter](RGBMatrixEmulator/adapters/browser_adapter/README.md) for further information regarding its configuration and usage.
 
-### Raspberry Pi 5 Adapter
-
-> [!WARNING]
-> This adapter is deprecated. It will be removed no later than July 1, 2026. Please use native `rpi-rgb-led-matrix` Raspberry Pi 5 support.
-
-RGBME can be used to "bridge" scripts written for `rpi-rgb-led-matrix` to Raspberry Pi model 5 through [Adafruit Blinka](https://github.com/adafruit/Adafruit_Blinka) and the [Adafruit-Blinka-Raspberry-Pi5-Piomatter](https://github.com/adafruit/Adafruit_Blinka_Raspberry_Pi5_Piomatter) libraries.
-
-Please see the [README for the `pi5` display adapter](RGBMatrixEmulator/adapters/pi5_adapter/README.md) for further information regarding its configuration and usage.
-
 ### Raw Display Adapter
 
 If you prefer fine-grained control over the raw pixel data, such as to build integration testing or build your own UI on top of it, you can use the `raw` display adapter.

rgbmatrixemulator-0.17.0/PKG-INFO → rgbmatrixemulator-0.18.0/README.md

@@ -1,35 +1,3 @@
-Metadata-Version: 2.4
-Name: RGBMatrixEmulator
-Version: 0.17.0
-Summary: A PC emulator for Raspberry Pi LED matrices driven by rpi-rgb-led-matrix
-Project-URL: Homepage, https://github.com/ty-porter/RGBMatrixEmulator
-Author-email: Tyler Porter <tyler.b.porter@gmail.com>
-License-Expression: MIT
-License-File: LICENSE
-Keywords: LED,LED matrix,RPI,matrix,raspberry,raspberry pi
-Classifier: Development Status :: 4 - Beta
-Classifier: Environment :: Console
-Classifier: Intended Audience :: Developers
-Classifier: Intended Audience :: Other Audience
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Natural Language :: English
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Classifier: Topic :: Other/Nonlisted Topic
-Requires-Python: >=3.10
-Requires-Dist: bdfparser<=2.2.0
-Requires-Dist: numpy>=1.2.0
-Requires-Dist: pillow>=10.0.1
-Requires-Dist: tornado>=6.5.5
-Provides-Extra: pi5
-Requires-Dist: adafruit-blinka-raspberry-pi5-piomatter>=1.0.0; (python_version >= '3.11') and extra == 'pi5'
-Requires-Dist: adafruit-blinka>=8.0.0; (python_version >= '3.11') and extra == 'pi5'
-Provides-Extra: pygame
-Requires-Dist: pygame<3,>=2.0.1; extra == 'pygame'
-Provides-Extra: sixel
-Requires-Dist: libsixel-python>=0.5.0; extra == 'sixel'
-Description-Content-Type: text/markdown
-
 # `RGBMatrixEmulator`
 
 [![pypi Badge](https://img.shields.io/pypi/v/RGBMatrixEmulator)](https://pypi.org/project/RGBMatrixEmulator/)
@@ -66,17 +34,15 @@ The following adapters are supported but not installed by default.
 
 * `sixel`
 * `pygame`
-* `pi5` (experimental)
 
 You can install optional adapters via `pip`:
 
 ```sh
 pip install RGBMatrixEmulator[sixel]
 pip install RGBMatrixEmulator[pygame]
-pip install RGBMatrixEmulator[pi5]
 
 # All optional adapters at once
-pip install RGBMatrixEmulator[sixel,pygame,pi5]
+pip install RGBMatrixEmulator[sixel,pygame]
 ```
 
 ## Usage
@@ -184,16 +150,6 @@ The config file enables configurations to be customized on a per-script basis. Y
     "image_format": "JPEG",
     "open_immediately": false
   },
-  "pi5": {
-    "_comment": "For use with the pi5 adapter only.",
-    "pinout": "AdafruitMatrixBonnet",
-    "n_addr_lines": 4,
-    "rotation": "Normal",
-    "n_planes": 10,
-    "n_temporal_planes": 4,
-    "n_lanes": 1,
-    "led_rgb_sequence": "RGB"
-  },
   "log_level": "info"
 }
 ```
@@ -238,18 +194,6 @@ Certain adapters may specify additional configurations. These specialized config
 | browser.image_format     | String  | Image format to use for rendering. Options are "JPEG" or "PNG".
 | browser.open_immediately | Bool    | Open a new browser window immediately on startup (similar to other adapters).
 
-##### `pi5` Options
-
-| Key | Type | Description |
-| --- | ---- | ----------- |
-| pi5.pinout            | String  | The hardware pinout definition. Matches attributes in `piomatter.Pinout` (e.g., "Active3", "AdafruitMatrixHat", "AdafruitMatrixBonnet").
-| pi5.n_addr_lines      | Integer | Number of address lines for the display. Typically `4` for 32-pixel height panels, or `5` for 64-pixel height panels.
-| pi5.led_rgb_sequence  | String  | Color sequence of the LEDs (e.g., "RGB", "BGR", "RBG").
-| pi5.rotation          | String  | Display rotation. Matches attributes in `piomatter.Orientation` (e.g., "Normal", "R180", "CW", "CCW"). Does not work with "Active3" pinouts.
-| pi5.n_lanes           | Integer | Number of parallel matrix chains (lanes). Only works with Active3 boards. Must be 2 or more.
-| pi5.n_planes          | Integer | Colour Bit depth/number of planes. Maximum of 10, minimum of 1.
-| pi5.n_temporal_planes | Integer | Number of temporal planes for dithering/brightness control. Possible values are 0, 2 or 4 and can't be greater than the value of n_planes.
-
 ### Display Adapters
 
 By default, `RGBMatrixEmulator` uses `browser` as its display adapter for maximum compatibility with different operating systems as well as thread-safety. However, you can also use other display adapters as well if the default adapter does not suit your needs.
@@ -262,7 +206,6 @@ Currently supported display adapters are:
 * `tkinter`
 * `turtle`
 * `sixel`
-* `pi5` (experimental)
 * `raw`
 
 You can swap display adapters by changing the `display_adapter` value to one of the above in `emulator_config.json`.
@@ -273,15 +216,6 @@ You can swap display adapters by changing the `display_adapter` value to one of
 
 Please see the [README for the `browser` display adapter](RGBMatrixEmulator/adapters/browser_adapter/README.md) for further information regarding its configuration and usage.
 
-### Raspberry Pi 5 Adapter
-
-> [!WARNING]
-> This adapter is deprecated. It will be removed no later than July 1, 2026. Please use native `rpi-rgb-led-matrix` Raspberry Pi 5 support.
-
-RGBME can be used to "bridge" scripts written for `rpi-rgb-led-matrix` to Raspberry Pi model 5 through [Adafruit Blinka](https://github.com/adafruit/Adafruit_Blinka) and the [Adafruit-Blinka-Raspberry-Pi5-Piomatter](https://github.com/adafruit/Adafruit_Blinka_Raspberry_Pi5_Piomatter) libraries.
-
-Please see the [README for the `pi5` display adapter](RGBMatrixEmulator/adapters/pi5_adapter/README.md) for further information regarding its configuration and usage.
-
 ### Raw Display Adapter
 
 If you prefer fine-grained control over the raw pixel data, such as to build integration testing or build your own UI on top of it, you can use the `raw` display adapter.

{rgbmatrixemulator-0.17.0 → rgbmatrixemulator-0.18.0}/RGBMatrixEmulator/adapters/__init__.py

@@ -34,9 +34,4 @@ ADAPTERS = {
         "class": "RawAdapter",
         "fallback": False,
     },
-    "pi5": {
-        "path": "RGBMatrixEmulator.adapters.pi5_adapter",
-        "class": "Pi5Adapter",
-        "fallback": False,
-    },
 }

{rgbmatrixemulator-0.17.0 → rgbmatrixemulator-0.18.0}/RGBMatrixEmulator/emulation/options.py

@@ -34,9 +34,6 @@ class RGBMatrixOptions:
         self.emulator_title = emulator_config.emulator_title
         self.icon_path = emulator_config.icon_path
 
-        # Pi5 Adapter
-        self.pi5 = emulator_config.pi5
-
     @property
     def screen(self) -> Screen:
         """The emulated screen model (mapper geometry + render).

{rgbmatrixemulator-0.17.0 → rgbmatrixemulator-0.18.0}/RGBMatrixEmulator/internal/emulator_config.py

@@ -31,16 +31,6 @@ class RGBMatrixEmulatorConfig:
             "image_format": "JPEG",
             "open_immediately": False,
         },
-        "pi5": {
-            "_comment": "For use with the pi5 adapter only.",
-            "pinout": "AdafruitMatrixBonnet",
-            "n_addr_lines": 4,
-            "rotation": "Normal",
-            "n_planes": 10,
-            "n_temporal_planes": 4,
-            "n_lanes": 1,
-            "led_rgb_sequence": "RGB",
-        },
         "log_level": "info",
     }
 
@@ -53,7 +43,6 @@ class RGBMatrixEmulatorConfig:
     emulator_title: Optional[str]
     suppress_font_warnings: bool
     log_level: str
-    pi5: "ChildConfig"
     browser: "ChildConfig"
 
     def __init__(self):

{rgbmatrixemulator-0.17.0 → rgbmatrixemulator-0.18.0}/RGBMatrixEmulator/version.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python
 
 # package version
-__version__ = "0.17.0"
+__version__ = "0.18.0"
 """Installed version of RGBMatrixEmulator."""

{rgbmatrixemulator-0.17.0 → rgbmatrixemulator-0.18.0}/pyproject.toml

@@ -48,10 +48,6 @@ pygame = [
 sixel = [
     "libsixel-python>=0.5.0",
 ]
-pi5 = [
-    "Adafruit-Blinka-Raspberry-Pi5-Piomatter>=1.0.0; python_version>='3.11'",
-    "adafruit-blinka>=8.0.0; python_version>='3.11'",
-]
 
 [project.urls]
 Homepage = "https://github.com/ty-porter/RGBMatrixEmulator"

rgbmatrixemulator-0.17.0/RGBMatrixEmulator/adapters/pi5_adapter/README.md

@@ -1,62 +0,0 @@
-# Pi5 Adapter
-
-> [!NOTE]  
-> This adapter is currently experimental. Please report issues to https://github.com/ty-porter/RGBMatrixEmulator/issues
-
-This adapter enables the RGBMatrixEmulator to drive RGB led matrices connected to a Raspberry Pi 5 using the `adafruit-circuitpython-piomatter` library. It bridges the emulator's frame generation with the PIO-based hardware driving capabilities of the Pi 5.
-
-## Configuration
-
-The adapter is configured via the `pi5` section in your `emulator_config.json`.
-
-### Options
-
-| Option | Type | Description |
-| :--- | :--- | :--- |
-| `pinout` | String | The hardware pinout definition. Matches attributes in `piomatter.Pinout` (e.g., `"Active3","AdafruitMatrixHat","AdafruitMatrixBonnet"`). |
-| `n_addr_lines` | Integer | Number of address lines for the display. Typically `4` for 32-pixel height panels, or `5` for 64-pixel height panels. |
-| `led_rgb_sequence` | String | Color sequence of the LEDs (e.g., `"RGB"`, `"BGR"`, `"RBG"`). |
-| `rotation` | String | Display rotation. Matches attributes in `piomatter.Orientation` (e.g., `"Normal"`, `"R180"`, `"CW"`, `"CCW"`). Does not work with `"Active3"` pinouts. |
-| `n_lanes` | Integer | Number of parallel matrix chains (lanes). Only works with Active3 boards.  Must be 2 or more. |
-| `n_planes` | Integer | Colour Bit depth/number of planes. Maximum of 10, minimum of 1|
-| `n_temporal_planes` | Integer | Number of temporal planes for dithering/brightness control. Possible values are 0, 2 or 4 and can't be greater than the value of n_planes. |
-
-### Example Configuration
-
-```json
-"pi5": {
-  "pinout": "AdafruitMatrixBonnet",
-  "n_addr_lines": 4,
-  "led_rgb_sequence": "RGB",
-  "rotation": "Normal",
-  "n_lanes": 2,
-  "n_planes": 6,
-  "n_temporal_planes": 0
-}
-```
-
-## Setup & Non-Root Access
-
-By default, accessing the PIO subsystem on the Raspberry Pi 5 requires root privileges (`sudo`). To run the adapter as a standard user, you must configure a `udev` rule.
-
-### configuring `udev` Rules
-
-1.  Create or edit the file `/etc/udev/rules.d/99-com.rules`:
-
-    ```bash
-    sudo nano /etc/udev/rules.d/99-com.rules
-    ```
-
-2.  Add the following line to the file:
-
-    ```text
-    SUBSYSTEM=="*-pio", GROUP="gpio", MODE="0660"
-    ```
-
-3.  Save the file (Ctrl+S, then Ctrl+X) and reboot your Raspberry Pi:
-
-    ```bash
-    sudo reboot
-    ```
-
-For more details, refer to the [Adafruit Raspberry Pi 5 Setup Guide](https://learn.adafruit.com/rgb-matrix-panels-with-raspberry-pi-5/raspberry-pi-5-setup#add-pio-subsystem-rule-configuration-3191958).

rgbmatrixemulator-0.17.0/RGBMatrixEmulator/adapters/pi5_adapter/__init__.py

@@ -1,250 +0,0 @@
-from RGBMatrixEmulator.adapters.base import BaseAdapter
-from RGBMatrixEmulator.logger import Logger
-
-import sys
-from pathlib import Path
-import numpy as np
-
-try:
-    import adafruit_blinka_raspberry_pi5_piomatter as piomatter
-except ImportError:
-    piomatter = None
-
-
-class Pi5Adapter(BaseAdapter):
-    def __init__(self, width, height, options):
-        Logger.warning(
-            "The Pi5 adapter is deprecated. rpi-rgb-led-matrix now provides Raspberry Pi 5 support natively. "
-            "This adapter will be removed no later than July 1, 2026.",
-        )
-
-        super().__init__(width, height, options)
-        self.matrix = None
-        self.framebuffer = None
-        self.pixel_swizzle = None
-
-        self.__ensure_pi5_runtime()
-
-    def load_emulator_window(self):
-        config = self.options.pi5
-
-        # Validate n_planes
-        if config.n_planes > 10:
-            config.n_planes = 10
-        elif config.n_planes < 1:
-            Logger.warning(
-                f"n_planes must be at least 1. Got {config.n_planes}, setting to 1."
-            )
-            config.n_planes = 1
-
-        # Validate n_temporal_planes
-        valid_temporal = [0, 2, 4]
-        if config.n_temporal_planes not in valid_temporal:
-            closest = min(
-                valid_temporal, key=lambda x: abs(x - config.n_temporal_planes)
-            )
-            Logger.warning(
-                f"Invalid n_temporal_planes {config.n_temporal_planes}. "
-                f"Snapping to closest valid value: {closest}."
-            )
-            config.n_temporal_planes = closest
-
-        if config.n_temporal_planes > config.n_planes:
-            # Find max valid value <= n_planes
-            new_val = max(
-                [v for v in valid_temporal if v <= config.n_planes], default=0
-            )
-            Logger.warning(
-                f"n_temporal_planes ({config.n_temporal_planes}) cannot be greater than n_planes ({config.n_planes}). "
-                f"Reducing to {new_val}."
-            )
-            config.n_temporal_planes = new_val
-
-        if config.n_addr_lines == 5 and self.height < 64:
-            Logger.critical(
-                f"n_addr_lines=5 requires a display height of at least 64 pixels. Current height: {self.height}"
-            )
-            sys.exit(1)
-
-        # Configure Geometry
-        pinout_str = config.pinout
-
-        # Handle LED Sequence (RGB vs BGR vs Other)
-        # Check if BGR is requested and if there is a BGR pinout variant
-        sequence = config.led_rgb_sequence.upper()
-
-        if sequence == "BGR":
-            # Attempt to find the BGR variant of the pinout
-            # Typical naming convention: AdafruitMatrixBonnet -> AdafruitMatrixBonnetBGR
-            bgr_pinout_str = f"{pinout_str}BGR"
-            if hasattr(piomatter.Pinout, bgr_pinout_str):
-                pinout_str = bgr_pinout_str
-                # Handled by hardware/pinout, so we don't need to software swizzle
-                sequence = "RGB"  # Treat as normal for rest of pipeline
-            else:
-                Logger.warning(
-                    f"BGR Sequence requested but pinout '{bgr_pinout_str}' not found in piomatter.Pinout. Will attempt software pixel swap."
-                )
-
-        # Resolve Pinout Enum
-        if hasattr(piomatter.Pinout, pinout_str):
-            pinout = getattr(piomatter.Pinout, pinout_str)
-        else:
-            Logger.warning(
-                f"Pinout '{pinout_str}' not found in piomatter.Pinout. Defaulting to AdafruitMatrixBonnet."
-            )
-            pinout = piomatter.Pinout.AdafruitMatrixBonnet
-
-        # Setup Software Swizzle if needed
-        # We need to map RGB (original) to Dest Sequence
-        # Common cases: RGB (0,1,2), RBG (0,2,1), GRB (1,0,2), GBR (1,2,0), BRG (2,0,1), BGR (2,1,0)
-        # Note: If we handled BGR via pinout, sequence is set to "RGB" above so we skip this.
-        if sequence != "RGB":
-            swizzle_map = {
-                "RGB": [0, 1, 2],
-                "RBG": [0, 2, 1],
-                "GRB": [1, 0, 2],
-                "GBR": [1, 2, 0],
-                "BRG": [2, 0, 1],
-                "BGR": [2, 1, 0],
-            }
-
-            if sequence in swizzle_map:
-                self.pixel_swizzle = swizzle_map[sequence]
-                Logger.info(
-                    f"Using software pixel swizzle for sequence '{sequence}': {self.pixel_swizzle}"
-                )
-            else:
-                Logger.warning(
-                    f"Unknown LED sequence '{sequence}'. Display colors may be incorrect."
-                )
-
-        rotation_str = config.rotation
-        if hasattr(piomatter.Orientation, rotation_str):
-            rotation = getattr(piomatter.Orientation, rotation_str)
-        else:
-            Logger.warning(
-                f"Rotation '{rotation_str}' not found in piomatter.Orientation. Defaulting to Normal."
-            )
-            rotation = piomatter.Orientation.Normal
-
-        if "Active3" not in pinout_str and config.n_lanes > 2:
-            Logger.warning(
-                f"Pinout '{pinout_str}' does not support multiple lanes. "
-                "Setting n_lanes to 2."
-            )
-            config.n_lanes = 2
-
-        if config.n_lanes == 2 and "Active3" not in pinout_str:
-            # Simple Geometry
-            geometry = piomatter.Geometry(
-                width=self.width,
-                height=self.height,
-                n_planes=config.n_planes,
-                n_addr_lines=config.n_addr_lines,
-                n_temporal_planes=config.n_temporal_planes,
-                rotation=rotation,
-            )
-        else:
-            if config.n_lanes < 2:
-                Logger.warning(
-                    f"Active3 pinouts require n_lanes >= 2. Got {config.n_lanes}, setting to 2."
-                )
-                config.n_lanes = 2
-
-            pixelmap = None
-            if config.n_lanes > 1 or "Active3" in pinout_str:
-                try:
-                    from adafruit_blinka_raspberry_pi5_piomatter.pixelmappers import (
-                        simple_multilane_mapper,
-                    )
-
-                    pixelmap = simple_multilane_mapper(
-                        self.width, self.height, config.n_addr_lines, config.n_lanes
-                    )
-                except ImportError:
-                    Logger.warning(
-                        "Could not import simple_multilane_mapper. Active3/Multilane support may fail."
-                    )
-
-            geometry = piomatter.Geometry(
-                width=self.width,
-                height=self.height,
-                n_addr_lines=config.n_addr_lines,
-                n_planes=config.n_planes,
-                n_temporal_planes=config.n_temporal_planes,
-                n_lanes=config.n_lanes,
-                map=pixelmap,
-            )
-
-        self.framebuffer = np.zeros(
-            shape=(geometry.height, geometry.width, 3), dtype=np.uint8
-        )
-
-        self.matrix = piomatter.PioMatter(
-            colorspace=piomatter.Colorspace.RGB888Packed,
-            pinout=pinout,
-            framebuffer=self.framebuffer,
-            geometry=geometry,
-        )
-
-        # Register cleanup to clear the screen on exit
-        import atexit
-
-        def cleanup():
-            if self.framebuffer is not None and self.matrix is not None:
-                self.framebuffer.fill(0)
-                self.matrix.show()
-                # Deinit if possible, though show() with 0s might be enough
-                # self.matrix.deinit() # PioMatter object might not support deinit or it's automatic on GC
-
-        atexit.register(cleanup)
-
-        self.loaded = True
-
-    def draw_to_screen(self, pixels):
-        if not self.loaded:
-            return
-
-        # pixels is (height, width, 3)
-        try:
-            pixel_data = np.array(pixels, dtype=np.uint8)
-
-            # Apply software swizzle if configured
-            if self.pixel_swizzle:
-                pixel_data = pixel_data[:, :, self.pixel_swizzle]
-
-            np.copyto(self.framebuffer, pixel_data)
-            self.matrix.show()
-        except Exception as e:
-            # Throttle logging?
-            pass
-
-    def __ensure_pi5_runtime(self):
-        """
-        Validates that the code is running on a Raspberry Pi 5
-        and has the necessary dependencies installed.
-        """
-        is_pi5 = False
-        try:
-            model_path = Path("/proc/device-tree/model")
-            if model_path.exists():
-                model_name = model_path.read_text().strip()
-                if "Raspberry Pi 5" in model_name:
-                    is_pi5 = True
-        except Exception:
-            pass
-
-        if not is_pi5:
-            Logger.critical(
-                "This module is designed exclusively for the Raspberry Pi 5."
-            )
-            sys.exit(1)
-
-        if piomatter is None:
-            Logger.critical(
-                "Pi5 adapter cannot load due to missing dependencies for Raspberry Pi 5.\n"
-                "Please install dependencies using the [pi5] feature option:\n"
-                "    pip install RGBMatrixEmulator[pi5]"
-            )
-            sys.exit(1)