X-Git-Url: https://git.ayoreis.com/hackapet/Adafruit_Blinka_Displayio.git/blobdiff_plain/62e0eafb17cffc425e519fd3389ef4ea699e0267..09889f5e46420240ade4451f7af6f54814f8cfcd:/displayio/_display.py diff --git a/displayio/_display.py b/displayio/_display.py index ba6ea9e..9e72054 100644 --- a/displayio/_display.py +++ b/displayio/_display.py @@ -212,7 +212,7 @@ class Display: # 100Hz looks decent and doesn't keep the CPU too busy self._backlight = PWMOut(backlight_pin, frequency=100, duty_cycle=0) self._backlight_type = BACKLIGHT_PWM - except ImportError: + except (ImportError, NotImplementedError): # PWMOut not implemented on this platform pass if self._backlight_type is None: @@ -243,8 +243,14 @@ class Display: self._core.send(DISPLAY_DATA, CHIP_SELECT_UNTOUCHED, pixels) def show(self, group: Group) -> None: - """Switches to displaying the given group of layers. When group is None, the + """ + .. note:: `show()` is deprecated and will be removed when CircuitPython 9.0.0 + is released. Use ``.root_group = group`` instead. + + Switches to displaying the given group of layers. When group is None, the default CircuitPython terminal will be shown. + + :param Group group: The group to show. """ if group is None: group = circuitpython_splash @@ -525,3 +531,17 @@ class Display: def bus(self) -> _DisplayBus: """Current Display Bus""" return self._core.get_bus() + + @property + def root_group(self) -> Group: + """ + The root group on the display. + If the root group is set to `displayio.CIRCUITPYTHON_TERMINAL`, the default + CircuitPython terminal will be shown. + If the root group is set to ``None``, no output will be shown. + """ + return self._core.current_group + + @root_group.setter + def root_group(self, new_group: Group) -> None: + self._set_root_group(new_group)