Unify manual/auto timing semantics for key patterns, add preset background support, and improve runtime observability while keeping the driver responsive under beat-triggered selects. Co-authored-by: Cursor <cursoragent@cursor.com>
161 lines
5.4 KiB
Python
161 lines
5.4 KiB
Python
import random
|
|
import utime
|
|
|
|
# Default cool palette (icy blues, violet, mint) when preset has no colours.
|
|
_DEFAULT_COOL = (
|
|
(120, 200, 255),
|
|
(80, 140, 255),
|
|
(180, 120, 255),
|
|
(100, 220, 240),
|
|
(160, 200, 255),
|
|
(90, 180, 220),
|
|
)
|
|
|
|
|
|
class Twinkle:
|
|
def __init__(self, driver):
|
|
self.driver = driver
|
|
|
|
def _palette(self, preset):
|
|
colors = preset.c
|
|
if not colors:
|
|
return list(_DEFAULT_COOL)
|
|
out = []
|
|
for c in colors:
|
|
if isinstance(c, (list, tuple)) and len(c) == 3:
|
|
out.append(
|
|
(
|
|
max(0, min(255, int(c[0]))),
|
|
max(0, min(255, int(c[1]))),
|
|
max(0, min(255, int(c[2]))),
|
|
)
|
|
)
|
|
return out if out else list(_DEFAULT_COOL)
|
|
|
|
def run(self, preset):
|
|
"""Twinkle: n1 activity, n2 density; n3/n4 min/max length of adjacent on/off runs."""
|
|
palette = self._palette(preset)
|
|
num = self.driver.num_leds
|
|
bg_color = self.driver.apply_brightness(preset.background_or(palette), preset.b)
|
|
if num <= 0:
|
|
while True:
|
|
yield
|
|
return
|
|
|
|
def activity_rate():
|
|
r = int(preset.n1)
|
|
if r <= 0:
|
|
r = 48
|
|
return max(1, min(255, r))
|
|
|
|
def density255():
|
|
"""Higher → more LEDs lit on average when a twinkle step fires (0 = default mid)."""
|
|
d = int(preset.n2)
|
|
if d <= 0:
|
|
d = 128
|
|
return max(0, min(255, d))
|
|
|
|
def cluster_len_bounds():
|
|
"""n3 = min adjacent LEDs per twinkle, n4 = max (both 0 → 1..4)."""
|
|
lo = int(preset.n3)
|
|
hi = int(preset.n4)
|
|
if lo <= 0 and hi <= 0:
|
|
lo, hi = 1, min(4, num)
|
|
else:
|
|
if lo <= 0:
|
|
lo = 1
|
|
if hi <= 0:
|
|
hi = lo
|
|
if hi < lo:
|
|
lo, hi = hi, lo
|
|
lo = max(1, min(lo, num))
|
|
hi = max(lo, min(hi, num))
|
|
return lo, hi
|
|
|
|
def random_cluster_len():
|
|
lo, hi = cluster_len_bounds()
|
|
# When min and max match, every lit/dim run is exactly that many LEDs (still capped by strip length).
|
|
if lo == hi:
|
|
return lo
|
|
return random.randint(lo, hi)
|
|
|
|
def cluster_base_index(start, k):
|
|
"""Shift run left so a length-k segment fits; keeps full k when num >= k."""
|
|
k = min(max(0, int(k)), num)
|
|
if k <= 0:
|
|
return 0
|
|
return max(0, min(int(start), num - k))
|
|
|
|
dens = density255()
|
|
on = [random.randint(0, 255) < dens for _ in range(num)]
|
|
colour_i = [random.randint(0, len(palette) - 1) for _ in range(num)]
|
|
last_update = utime.ticks_ms()
|
|
|
|
if not preset.a:
|
|
for i in range(num):
|
|
if on[i]:
|
|
base = palette[colour_i[i] % len(palette)]
|
|
self.driver.n[i] = self.driver.apply_brightness(base, preset.b)
|
|
else:
|
|
self.driver.n[i] = bg_color
|
|
self.driver.n.write()
|
|
yield
|
|
return
|
|
|
|
while True:
|
|
now = utime.ticks_ms()
|
|
delay_ms = max(1, int(preset.d))
|
|
if utime.ticks_diff(now, last_update) >= delay_ms:
|
|
rate = activity_rate()
|
|
dens = density255()
|
|
# Snapshot for decisions; apply all darks then all lights so
|
|
# overlaps in the same tick favour lit runs (lights win).
|
|
prev_on = on[:]
|
|
prev_ci = colour_i[:]
|
|
next_on = list(prev_on)
|
|
next_ci = list(prev_ci)
|
|
|
|
light_i = []
|
|
dark_i = []
|
|
for i in range(num):
|
|
if random.randint(0, 255) < rate:
|
|
r = random.randint(0, 255)
|
|
if not prev_on[i]:
|
|
if r < dens:
|
|
light_i.append(i)
|
|
else:
|
|
if r < (255 - dens):
|
|
dark_i.append(i)
|
|
|
|
def light_adjacent(start):
|
|
k = random_cluster_len()
|
|
b = cluster_base_index(start, k)
|
|
for dj in range(k):
|
|
idx = b + dj
|
|
next_on[idx] = True
|
|
next_ci[idx] = random.randint(0, len(palette) - 1)
|
|
|
|
def dark_adjacent(start):
|
|
k = random_cluster_len()
|
|
b = cluster_base_index(start, k)
|
|
for dj in range(k):
|
|
idx = b + dj
|
|
next_on[idx] = False
|
|
|
|
for i in dark_i:
|
|
dark_adjacent(i)
|
|
for i in light_i:
|
|
light_adjacent(i)
|
|
|
|
for i in range(num):
|
|
if next_on[i]:
|
|
base = palette[next_ci[i] % len(palette)]
|
|
self.driver.n[i] = self.driver.apply_brightness(base, preset.b)
|
|
else:
|
|
self.driver.n[i] = bg_color
|
|
self.driver.n.write()
|
|
on = next_on
|
|
colour_i = next_ci
|
|
last_update = utime.ticks_add(last_update, delay_ms)
|
|
yield
|