Files
qlcplus/tests/test_pad_layer.py
jimmyandClaude Opus 5.5 c7546e5ea9 Show in the test show whether the pads are on the cans or the movers.
A Pads layer frame under the movers pads has Cans pads and Movers pads
buttons (scripts/shows/layer_indicator.py). The pad controller holds channel
16 note 0 (cans) or 1 (movers) down and the other up whenever Pause changes,
QLC+ reloads or it starts, and the Flash buttons light while their note is
held, so the lit one is the layer and a missed message can't leave them the
wrong way round. Each flashes an empty scene of its own: with one between
them, QLC+ lit both.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-23 15:09:49 +13:00

205 lines
8.6 KiB
Python

import sys
import unittest
from pathlib import Path
sys.path.insert(0, str(Path(__file__).resolve().parents[1]))
from padcontroller.layer import PlayLayer # noqa: E402
PLAY_DOWN = [0xB0, 27, 127]
PLAY_UP = [0xB0, 27, 0]
# The pad latches Pause: one message a press, 127 and 0 on alternate presses.
PAUSE_ON = [0xB0, 28, 127]
PAUSE_OFF = [0xB0, 28, 0]
CANS_LIT = [[0x8F, 1, 0], [0x9F, 0, 127]] # channel 16: note 0 down, 1 up
MOVERS_LIT = [[0x8F, 0, 0], [0x9F, 1, 127]]
class PlayLayerTest(unittest.TestCase):
def test_notes_pass_through_when_play_is_up(self):
layer = PlayLayer()
self.assertEqual(layer.handle([0x99, 52, 100]), [[0x99, 52, 100]])
def test_play_is_not_passed_on(self):
layer = PlayLayer()
self.assertEqual(layer.handle(PLAY_DOWN), [])
self.assertEqual(layer.handle(PLAY_UP), [])
def test_bank_2_moves_up_while_play_is_held(self):
layer = PlayLayer()
layer.handle(PLAY_DOWN)
self.assertEqual(layer.handle([0x99, 52, 100]), [[0x99, 68, 100]])
self.assertEqual(layer.handle([0x99, 67, 100]), [[0x99, 83, 100]])
layer.handle(PLAY_UP)
self.assertEqual(layer.handle([0x99, 52, 100]), [[0x99, 52, 100]])
def test_other_notes_and_ccs_are_left_alone(self):
layer = PlayLayer()
layer.handle(PLAY_DOWN)
self.assertEqual(layer.handle([0x99, 40, 100]), [[0x99, 40, 100]])
self.assertEqual(layer.handle([0xB0, 30, 64]), [[0xB0, 30, 64]])
def test_release_matches_its_press(self):
layer = PlayLayer()
layer.handle(PLAY_DOWN)
layer.handle([0x99, 55, 100])
layer.handle(PLAY_UP)
self.assertEqual(layer.handle([0x89, 55, 0]), [[0x89, 71, 0]])
layer.handle([0x99, 55, 100])
layer.handle(PLAY_DOWN)
self.assertEqual(layer.handle([0x99, 55, 0]), [[0x99, 55, 0]])
def test_pads_1_and_2_pass_straight_through(self):
layer = PlayLayer()
self.assertEqual(layer.handle([0x99, 36, 100]), [[0x99, 36, 100]])
self.assertEqual(layer.handle([0x89, 36, 0]), [[0x89, 36, 0]])
self.assertEqual(layer.handle([0x99, 37, 100]), [[0x99, 37, 100]])
def test_peak_and_side_knobs_pass_straight_through(self):
layer = PlayLayer()
self.assertEqual(layer.handle([0xB0, 35, 60]), [[0xB0, 35, 60]])
self.assertEqual(layer.handle([0xB0, 34, 90]), [[0xB0, 34, 90]])
self.assertEqual(layer.handle([0xB0, 37, 80]), [[0xB0, 37, 80]])
def test_colours_remember_the_last_pad_in_each_set(self):
layer = PlayLayer()
layer.handle([0x99, 52, 100])
layer.handle([0x99, 55, 100])
layer.handle(PLAY_DOWN)
layer.handle([0x99, 61, 100]) # Colour 2 Blue, sent as 77
self.assertEqual(layer.colours, {1: (9, 55), 2: (9, 77)})
def test_pressing_the_lit_colour_again_turns_it_off(self):
layer = PlayLayer()
layer.handle([0x99, 52, 100])
layer.handle([0x89, 52, 0])
layer.handle([0x99, 52, 100])
self.assertEqual(layer.colours[1], None)
def test_reopen_presses_the_colours_again(self):
layer = PlayLayer()
layer.handle([0x99, 54, 100])
layer.handle(PLAY_DOWN)
layer.handle([0x99, 66, 100])
layer.handle(PLAY_UP)
self.assertEqual(layer.reopen(), CANS_LIT + [[0x99, 54, 127], [0x89, 54, 0], [0x99, 82, 127], [0x89, 82, 0]])
self.assertEqual(layer.colours, {1: (9, 54), 2: (9, 82)}) # still on, for the next reopen
def test_pause_toggles_bank_1_to_the_movers(self):
layer = PlayLayer()
self.assertEqual(layer.handle(PAUSE_ON), MOVERS_LIT)
self.assertEqual(layer.handle([0x99, 40, 100]), [[0x99, 88, 100]])
self.assertEqual(layer.handle([0x99, 51, 100]), [[0x99, 99, 100]])
self.assertEqual(layer.handle([0x99, 52, 100]), [[0x99, 52, 100]])
self.assertEqual(layer.handle(PAUSE_OFF), CANS_LIT)
self.assertEqual(layer.handle([0x99, 44, 100]), [[0x99, 44, 100]])
def test_pads_1_and_2_move_up_on_the_movers_layer(self):
layer = PlayLayer()
layer.handle(PAUSE_ON)
self.assertEqual(layer.handle([0x99, 36, 100]), [[0x99, 84, 100]])
self.assertEqual(layer.handle([0x89, 36, 0]), [[0x89, 84, 0]])
self.assertEqual(layer.handle([0x99, 37, 100]), [[0x99, 85, 100]])
self.assertEqual(layer.handle([0x89, 37, 0]), [[0x89, 85, 0]])
def test_bank_1_release_matches_its_press_across_pause(self):
layer = PlayLayer()
layer.handle(PAUSE_ON)
layer.handle([0x99, 48, 100])
layer.handle(PAUSE_OFF)
self.assertEqual(layer.handle([0x89, 48, 0]), [[0x89, 96, 0]])
def test_reopen_with_no_colours_only_lights_the_layer(self):
self.assertEqual(PlayLayer().reopen(), CANS_LIT)
def test_pause_lights_the_layer_it_moves_to(self):
layer = PlayLayer()
self.assertEqual(layer.layer_lamp(), CANS_LIT)
self.assertEqual(layer.handle(PAUSE_ON), MOVERS_LIT)
self.assertEqual(layer.handle(PAUSE_OFF), CANS_LIT)
self.assertEqual(layer.reopen(), CANS_LIT)
def test_pause_follows_the_pads_latch(self):
layer = PlayLayer()
self.assertEqual(layer.handle(PAUSE_OFF), CANS_LIT) # already on the cans: stays there
self.assertFalse(layer.movers)
self.assertEqual(layer.handle(PAUSE_ON), MOVERS_LIT)
self.assertEqual(layer.handle(PAUSE_ON), MOVERS_LIT) # a repeat changes nothing
self.assertTrue(layer.movers)
def test_wander_off_settles_pan_and_tilt(self):
layer = PlayLayer()
self.assertEqual(layer.handle([0xB0, 38, 40]), [[0xB0, 38, 40]])
layer.handle([0xB0, 39, 0])
layer.handle(PAUSE_ON)
self.assertEqual(layer.handle([0x99, 48, 100]), [[0x99, 96, 100]])
layer.handle([0x89, 48, 0])
self.assertEqual((layer.moving, layer.settle), (96, False))
layer.handle([0x99, 48, 100])
self.assertEqual((layer.moving, layer.settle), (None, True))
self.assertEqual(layer.nudge(), [[0xB0, 38, 39], [0xB0, 39, 1]])
self.assertEqual(layer.positions(), [[0xB0, 38, 40], [0xB0, 39, 0]])
def test_chase_on_the_cans_layer_is_not_wander(self):
layer = PlayLayer()
layer.handle([0x99, 48, 100])
layer.handle([0x99, 48, 100])
self.assertEqual((layer.moving, layer.settle), (None, False))
def test_ballyhoo_takes_over_from_wander_without_a_settle(self):
layer = PlayLayer()
layer.handle(PAUSE_ON)
layer.handle([0x99, 48, 100])
self.assertEqual(layer.handle([0x99, 49, 100]), [[0x99, 97, 100]])
self.assertEqual((layer.moving, layer.settle), (97, False))
layer.handle([0x99, 49, 100])
self.assertEqual((layer.moving, layer.settle), (None, True))
def test_colour_1_restarts_the_can_pattern_on_top(self):
layer = PlayLayer()
layer.handle([0x99, 40, 127])
self.assertEqual(layer.handle([0x99, 57, 127]), [[0x99, 57, 127]])
self.assertTrue(layer.restart_pattern)
self.assertEqual(layer.pattern_tap(), [[0x99, 40, 127], [0x89, 40, 0]])
self.assertEqual(layer.pattern, 40)
def test_colour_1_leaves_the_cans_alone_with_no_pattern(self):
layer = PlayLayer()
layer.handle([0x99, 36, 127])
layer.handle([0x99, 36, 127])
self.assertEqual(layer.handle([0x99, 57, 127]), [[0x99, 57, 127]])
self.assertFalse(layer.restart_pattern)
self.assertEqual(layer.pattern_tap(), [])
def test_a_new_pattern_takes_over_in_the_solo_frame(self):
layer = PlayLayer()
layer.handle([0x99, 40, 127])
layer.handle([0x99, 37, 127])
self.assertEqual(layer.pattern, 37)
def test_colour_2_does_not_restart_the_can_pattern(self):
layer = PlayLayer()
layer.handle([0x99, 43, 127])
layer.handle(PLAY_DOWN)
self.assertEqual(layer.handle([0x99, 57, 127]), [[0x99, 73, 127]])
self.assertFalse(layer.restart_pattern)
def test_pattern_pads_on_the_movers_layer_are_not_can_patterns(self):
layer = PlayLayer()
layer.handle(PAUSE_ON)
layer.handle([0x99, 42, 127])
self.assertIsNone(layer.pattern)
def test_every_movement_pad_settles_when_it_goes_off(self):
for pad_note, sent in ((51, 99), (44, 92), (47, 95), (40, 88)):
layer = PlayLayer()
layer.handle(PAUSE_ON)
self.assertEqual(layer.handle([0x99, pad_note, 100]), [[0x99, sent, 100]])
self.assertEqual((layer.moving, layer.settle), (sent, False))
layer.handle([0x99, pad_note, 100])
self.assertEqual((layer.moving, layer.settle), (None, True))
if __name__ == "__main__":
unittest.main()