lifx-async 4.6.1__py3-none-any.whl → 4.7.1__py3-none-any.whl

lifx/devices/matrix.py

@@ -699,6 +699,7 @@ class MatrixLight(Light):
         source_fb: int = 1,
         target_fb: int = 0,
         duration: float = 0.0,
+        length: int = 1,
     ) -> None:
         """Copy frame buffer (for tiles with >64 zones).
 
@@ -710,6 +711,7 @@ class MatrixLight(Light):
             source_fb: Source frame buffer index (usually 1)
             target_fb: Target frame buffer index (usually 0)
             duration: time in seconds to transition if target_fb is 0
+            length: Number of tiles to update starting from tile_index (default 1)
 
         Example:
             >>> # For 16x8 tile (128 zones):
@@ -739,12 +741,18 @@ class MatrixLight(Light):
             >>> await matrix.copy_frame_buffer(
             ...     tile_index=0, source_fb=1, target_fb=0, duration=2.0
             ... )
+
+            >>> # For a chain of 5 tiles, update all simultaneously:
+            >>> await matrix.copy_frame_buffer(
+            ...     tile_index=0, source_fb=1, target_fb=0, length=5
+            ... )
         """
         _LOGGER.debug(
-            "Copying frame buffer %d -> %d for tile %d on %s",
+            "Copying frame buffer %d -> %d for tile %d (length=%d) on %s",
             source_fb,
             target_fb,
             tile_index,
+            length,
             self.label or self.serial,
         )
 
@@ -761,7 +769,7 @@ class MatrixLight(Light):
         await self.connection.send_packet(
             packets.Tile.CopyFrameBuffer(
                 tile_index=tile_index,
-                length=1,
+                length=length,
                 src_fb_index=source_fb,
                 dst_fb_index=target_fb,
                 src_x=0,

lifx/devices/multizone.py

@@ -604,6 +604,8 @@ class MultiZoneLight(Light):
         colors: list[HSBK],
         duration: float = 0.0,
         apply: ExtendedAppReq = ExtendedAppReq.APPLY,
+        *,
+        fast: bool = False,
     ) -> None:
         """Set colors for multiple zones efficiently (up to 82 zones per call).
 
@@ -615,12 +617,15 @@ class MultiZoneLight(Light):
             colors: List of HSBK colors to set (max 82)
             duration: Transition duration in seconds (default 0.0)
             apply: Application mode (default APPLY)
+            fast: If True, send fire-and-forget without waiting for response.
+                  Use for high-frequency animations (>20 updates/second).
 
         Raises:
             ValueError: If colors list is too long or zone index is invalid
             LifxDeviceNotFoundError: If device is not connected
-            LifxTimeoutError: If device does not respond
+            LifxTimeoutError: If device does not respond (only when fast=False)
             LifxUnsupportedCommandError: If device doesn't support this command
+                (only when fast=False)
 
         Example:
             ```python
@@ -630,6 +635,11 @@ class MultiZoneLight(Light):
                 for i in range(10)
             ]
             await light.set_extended_color_zones(0, colors)
+
+            # High-speed animation loop
+            for frame in animation_frames:
+                await light.set_extended_color_zones(0, frame, fast=True)
+                await asyncio.sleep(0.033)  # ~30 FPS
             ```
         """
         if zone_index < 0:
@@ -637,7 +647,9 @@ class MultiZoneLight(Light):
         if len(colors) > 82:
             raise ValueError(f"Too many colors: {len(colors)} (max 82 per request)")
         if len(colors) == 0:
-            raise ValueError("Colors list cannot be empty")  # Convert to protocol HSBK
+            raise ValueError("Colors list cannot be empty")
+
+        # Convert to protocol HSBK
         protocol_colors = [color.to_protocol() for color in colors]
 
         # Pad to 82 colors if needed
@@ -647,17 +659,25 @@ class MultiZoneLight(Light):
         # Convert duration to milliseconds
         duration_ms = int(duration * 1000)
 
-        # Send request
-        result = await self.connection.request(
-            packets.MultiZone.SetExtendedColorZones(
-                duration=duration_ms,
-                apply=apply,
-                index=zone_index,
-                colors_count=len(colors),
-                colors=protocol_colors,
-            ),
+        packet = packets.MultiZone.SetExtendedColorZones(
+            duration=duration_ms,
+            apply=apply,
+            index=zone_index,
+            colors_count=len(colors),
+            colors=protocol_colors,
         )
-        self._raise_if_unhandled(result)
+
+        if fast:
+            # Fire-and-forget: no ack, no response, no waiting
+            await self.connection.send_packet(
+                packet,
+                ack_required=False,
+                res_required=False,
+            )
+        else:
+            # Standard: wait for response and check for errors
+            result = await self.connection.request(packet)
+            self._raise_if_unhandled(result)
 
         _LOGGER.debug(
             {
@@ -678,6 +698,7 @@ class MultiZoneLight(Light):
                     ],
                     "duration": duration_ms,
                     "apply": apply.name,
+                    "fast": fast,
                 },
             }
         )

{lifx_async-4.6.1.dist-info → lifx_async-4.7.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lifx-async
-Version: 4.6.1
+Version: 4.7.1
 Summary: A modern, type-safe, async Python library for controlling LIFX lights
 Author-email: Avi Miller <me@dje.li>
 Maintainer-email: Avi Miller <me@dje.li>

{lifx_async-4.6.1.dist-info → lifx_async-4.7.1.dist-info}/RECORD

@@ -10,8 +10,8 @@ lifx/devices/ceiling.py,sha256=qXZeTGAnPbKpnMyEOI2DsffC9HddmWzsW_Q_Fnkpwkw,33087
 lifx/devices/hev.py,sha256=T5hvt2q_vdgPBvThx_-M7n5pZu9pL0y9Fs3Zz_KL0NM,15588
 lifx/devices/infrared.py,sha256=ePk9qxX_s-hv5gQMvio1Vv8FYiCd68HF0ySbWgSrvuU,8130
 lifx/devices/light.py,sha256=gk92lhViUWINGaxDWbs4qn8Stnn2fGCfRkC5Kk0Q-hI,34087
-lifx/devices/matrix.py,sha256=AVNM2071NFtPg3Eq7kZ3asRGus36He02iDDvIa8RaQ0,41951
-lifx/devices/multizone.py,sha256=8OJ6zP5xgSCmlMQDj2mLUZ352EMkbYMbDZ1X-Cux7AU,32786
+lifx/devices/matrix.py,sha256=TcfVvqFCIhGXjOtaQEARQCXe9XqSFDZ4wEQdRZBiQpA,42301
+lifx/devices/multizone.py,sha256=zQj0qKxWccHAmkIpqIcGzZsKjCQL-_bAquz78o0Izng,33570
 lifx/effects/__init__.py,sha256=4DF31yp7RJic5JoltMlz5dCtF5KQobU6NOUtLUKkVKE,1509
 lifx/effects/base.py,sha256=YO0Hbg2VYHKPtfYnWxmrtzYoPGOi9BUXhn8HVFKv5IM,10283
 lifx/effects/colorloop.py,sha256=kuuyENJS2irAN8vZAFsDa2guQdDbmmc4PJNiyZTfFPE,15840
@@ -42,7 +42,7 @@ lifx/theme/canvas.py,sha256=4h7lgN8iu_OdchObGDgbxTqQLCb-FRKC-M-YCWef_i4,8048
 lifx/theme/generators.py,sha256=nq3Yvntq_h-eFHbmmow3LcAdA_hEbRRaP5mv9Bydrjk,6435
 lifx/theme/library.py,sha256=tKlKZNqJp8lRGDnilWyDm_Qr1vCRGGwuvWVS82anNpQ,21326
 lifx/theme/theme.py,sha256=qMEx_8E41C0Cc6f083XHiAXEglTv4YlXW0UFsG1rQKg,5521
-lifx_async-4.6.1.dist-info/METADATA,sha256=bjtJ7SbLYx_SKkUzvEZqWaPJqqGrDG8aiLyqim1AbSE,2609
-lifx_async-4.6.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-lifx_async-4.6.1.dist-info/licenses/LICENSE,sha256=eBz48GRA3gSiWn3rYZAz2Ewp35snnhV9cSqkVBq7g3k,1832
-lifx_async-4.6.1.dist-info/RECORD,,
+lifx_async-4.7.1.dist-info/METADATA,sha256=Zrtws6NJBuCkoGw4dUBUJ6IPG2c5JW_BLJeKALgYY6U,2609
+lifx_async-4.7.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+lifx_async-4.7.1.dist-info/licenses/LICENSE,sha256=eBz48GRA3gSiWn3rYZAz2Ewp35snnhV9cSqkVBq7g3k,1832
+lifx_async-4.7.1.dist-info/RECORD,,