Sixel + Kitty support for "fine resolutions"

gambaterm/audio.py

@@ -114,6 +114,13 @@ def adapt_sample_rate(self) -> None:
         # Return the adjusted sample rate
         self.sampling_ratio = self.nominal_sampling_ratio * correction
 
+    @property
+    def fill_fraction(self) -> float:
+        """Instantaneous ring buffer fill ratio (0.0–1.0)."""
+        if self.ring_size == 0:
+            return 0.0
+        return max(0.0, (self.write_counter - self.read_counter) / self.ring_size)
+
     def send(self, console: Console, audio: npt.NDArray[np.int16]) -> None:
         # Resample input audio to output rate with speed adjustment
         resampled = self.resampler.process(
@@ -250,6 +257,12 @@ def send(self, console: Console, audio: npt.NDArray[np.int16]) -> None:
         if self.audio_out is not None:
             self.audio_out.send(console, audio)
 
+    @property
+    def fill_fraction(self) -> float:
+        if self.audio_out is not None:
+            return self.audio_out.fill_fraction
+        return 0.0
+
 
 @contextmanager
 def audio_player(

gambaterm/blessed_keyboard_input.py

@@ -70,7 +70,7 @@ def blessed_key_pressed_context(
 
         def _update() -> None:
             while True:
-                key = term.inkey(timeout=0)
+                key = term.inkey(timeout=0, capture_cpr=True)
                 if not key:
                     break
                 if not key.released:

gambaterm/colors.py

@@ -20,6 +20,13 @@ def cycle(self) -> ColorMode:
             value += 1
         return ColorMode(value)
 
+    def cycle_back(self) -> ColorMode:
+        """Cycle to the previous color mode."""
+        value = int(self) - 1
+        if value <= int(ColorMode.COULD_NOT_DETECT):
+            value = int(ColorMode.HAS_24_BIT_COLOR)
+        return ColorMode(value)
+
     def report(self) -> str:
         """Return a human-readable report of the color mode."""
         if self == ColorMode.COULD_NOT_DETECT:

gambaterm/console.py

@@ -139,6 +139,7 @@ def __init__(
 
         self.gb = GB()
         self.force_gameboy = force_gameboy
+        self.last_video = np.zeros((self.HEIGHT, self.WIDTH), dtype=np.uint32)
 
         # Set save_directory
         if save_directory is not None:

gambaterm/controller_input.py

@@ -51,13 +51,11 @@ def pygame_button_pressed_context(
     try:
         import pygame
     except ImportError:
-        raise SystemExit(
-            """\
+        raise SystemExit("""\
 The pygame library is not available, which is required to get controller support.
 Please use the following command to install gambaterm with controller support:
   pip3 install gambaterm[controller-support]
-"""
-        )
+""")
 
     pygame.init()
     pygame.joystick.init()