|
1
|
|
|
""" |
|
2
|
|
|
* PyDMXControl: A Python 3 module to control DMX via Python. Featuring fixture profiles and working with uDMX. |
|
3
|
|
|
* <https://github.com/MattIPv4/PyDMXControl/> |
|
4
|
|
|
* Copyright (C) 2018 Matt Cowley (MattIPv4) ([email protected]) |
|
5
|
|
|
""" |
|
6
|
|
|
|
|
7
|
|
|
from threading import Thread |
|
8
|
|
|
from time import sleep, time |
|
9
|
|
|
from typing import Callable, Dict |
|
10
|
|
|
from collections import OrderedDict |
|
11
|
|
|
|
|
12
|
|
|
from .exceptions import EventAlreadyExistsException |
|
13
|
|
|
|
|
14
|
|
|
# DMXMINWAIT = 0.000001 * 92 |
|
15
|
|
|
DMXMINWAIT = 0.01 # Provides far smoother animation |
|
16
|
|
|
|
|
17
|
|
|
|
|
18
|
|
|
class Ticker: |
|
19
|
|
|
|
|
20
|
|
|
@staticmethod |
|
21
|
|
|
def millis_now() -> float: |
|
22
|
|
|
return time() * 1000.0 |
|
23
|
|
|
|
|
24
|
|
|
def __init__(self): |
|
25
|
|
|
self.__interval = 1000.0 |
|
26
|
|
|
self.__last = None |
|
27
|
|
|
self.__callbacks = [] |
|
28
|
|
|
self.__paused = False |
|
29
|
|
|
self.__ticking = False |
|
30
|
|
|
self.thread = None |
|
31
|
|
|
|
|
32
|
|
|
def __ticker(self): |
|
33
|
|
|
# New |
|
34
|
|
|
if self.__last is None: |
|
35
|
|
|
self.__last = self.millis_now() |
|
36
|
|
|
|
|
37
|
|
|
# If diff in milliseconds is interval |
|
38
|
|
|
if self.millis_now() - self.__last >= self.__interval: |
|
39
|
|
|
# If have any callbacks |
|
40
|
|
|
if self.__callbacks: |
|
41
|
|
|
# Loop over each callback |
|
42
|
|
|
for callback in self.__callbacks: |
|
43
|
|
|
# Check is valid callback |
|
44
|
|
|
if callback and callable(callback): |
|
45
|
|
|
callback() |
|
46
|
|
|
# Finished, update last tick time |
|
47
|
|
|
self.__last = self.millis_now() |
|
48
|
|
|
|
|
49
|
|
|
def __ticker__loop(self): |
|
50
|
|
|
# Reset |
|
51
|
|
|
self.__last = None |
|
52
|
|
|
self.__paused = False |
|
53
|
|
|
# Use a variable so loop can be stopped |
|
54
|
|
|
self.__ticking = True |
|
55
|
|
|
while self.__ticking: |
|
56
|
|
|
# Allow for pausing |
|
57
|
|
|
if not self.__paused: |
|
58
|
|
|
# Call ticker |
|
59
|
|
|
self.__ticker() |
|
60
|
|
|
# Sleep DMX delay time |
|
61
|
|
|
sleep(DMXMINWAIT) |
|
62
|
|
|
|
|
63
|
|
|
def set_interval(self, milliseconds: float): |
|
64
|
|
|
self.__interval = milliseconds |
|
65
|
|
|
|
|
66
|
|
|
def get_interval(self) -> float: |
|
67
|
|
|
return self.__interval |
|
68
|
|
|
|
|
69
|
|
|
def set_callback(self, callback: Callable): |
|
70
|
|
|
self.__callbacks = [callback] |
|
71
|
|
|
|
|
72
|
|
|
def add_callback(self, callback: Callable): |
|
73
|
|
|
self.__callbacks.append(callback) |
|
74
|
|
|
|
|
75
|
|
|
def remove_callback(self, callback: Callable): |
|
76
|
|
|
if callback in self.__callbacks: |
|
77
|
|
|
self.__callbacks.remove(callback) |
|
78
|
|
|
|
|
79
|
|
|
def clear_callbacks(self): |
|
80
|
|
|
self.__callbacks = [] |
|
81
|
|
|
|
|
82
|
|
|
def stop(self): |
|
83
|
|
|
# Stop the threaded loop |
|
84
|
|
|
self.__ticking = False |
|
85
|
|
|
|
|
86
|
|
|
@property |
|
87
|
|
|
def paused(self) -> bool: |
|
88
|
|
|
return self.__paused |
|
89
|
|
|
|
|
90
|
|
|
def pause(self) -> bool: |
|
91
|
|
|
# Toggle pause state |
|
92
|
|
|
self.__paused = not self.__paused |
|
93
|
|
|
return self.paused |
|
94
|
|
|
|
|
95
|
|
|
def start(self): |
|
96
|
|
|
if not self.__ticking: |
|
97
|
|
|
# Create the thread and run loop |
|
98
|
|
|
self.thread = Thread(target=self.__ticker__loop) |
|
99
|
|
|
self.thread.daemon = True |
|
100
|
|
|
self.thread.start() |
|
101
|
|
|
|
|
102
|
|
|
|
|
103
|
|
|
class TimedEvent: |
|
104
|
|
|
|
|
105
|
|
|
def __init__(self, run_time: int, callback: callable, args: tuple = (), name: str = ""): |
|
106
|
|
|
self.__time = run_time |
|
107
|
|
|
self.__cb = callback |
|
108
|
|
|
self.__args = args |
|
109
|
|
|
self.__name = name |
|
110
|
|
|
self.__fired = None |
|
111
|
|
|
|
|
112
|
|
|
@property |
|
113
|
|
|
def time(self) -> str: |
|
114
|
|
|
return "{}ms".format("{:.4f}".format(self.__time).rstrip("0").rstrip(".")) |
|
115
|
|
|
|
|
116
|
|
|
@property |
|
117
|
|
|
def name(self) -> str: |
|
118
|
|
|
return "{}".format(self.__name) |
|
119
|
|
|
|
|
120
|
|
|
@property |
|
121
|
|
|
def func(self) -> str: |
|
122
|
|
|
return "<func {}>".format(self.__cb.__name__) |
|
123
|
|
|
|
|
124
|
|
|
@property |
|
125
|
|
|
def args(self) -> str: |
|
126
|
|
|
return "[{}]".format(", ".join(["{}".format(f) for f in self.__args])) |
|
127
|
|
|
|
|
128
|
|
|
@property |
|
129
|
|
|
def fired(self) -> str: |
|
130
|
|
|
if self.__fired is None: |
|
131
|
|
|
return "" |
|
132
|
|
|
return "{:.4f}ms ({:.4f}ms late)".format(self.__fired, self.__fired - self.__time) |
|
133
|
|
|
|
|
134
|
|
|
@property |
|
135
|
|
|
def data(self) -> Dict[str, str]: |
|
136
|
|
|
return { |
|
137
|
|
|
"time": self.time, |
|
138
|
|
|
"name": self.name, |
|
139
|
|
|
"func": self.func, |
|
140
|
|
|
"args": self.args, |
|
141
|
|
|
"fired": self.fired |
|
142
|
|
|
} |
|
143
|
|
|
|
|
144
|
|
|
def __str__(self) -> str: |
|
145
|
|
|
return "Event {} (\"{}\") {}".format(self.__time, self.name, self.func) |
|
146
|
|
|
|
|
147
|
|
|
def run(self, start_time) -> str: |
|
148
|
|
|
self.__cb(*self.__args) |
|
149
|
|
|
self.__fired = (time() * 1000.0) - start_time |
|
150
|
|
|
return "{} fired at {}".format(str(self), self.fired) |
|
151
|
|
|
|
|
152
|
|
|
|
|
153
|
|
|
class TimedEvents: |
|
154
|
|
|
|
|
155
|
|
|
def __init__(self, debug_messages: bool = False): |
|
156
|
|
|
self.__events = {} |
|
157
|
|
|
self.__running = False |
|
158
|
|
|
self.__messages = debug_messages |
|
159
|
|
|
self.__run_cbs = [] |
|
160
|
|
|
|
|
161
|
|
|
def __run(self, start_millis): |
|
162
|
|
|
# Don't allow to run more that once simultaneously |
|
163
|
|
|
if self.__running: |
|
164
|
|
|
return |
|
165
|
|
|
|
|
166
|
|
|
# Set starting params |
|
167
|
|
|
start = (time() * 1000.0) - start_millis |
|
168
|
|
|
events_left = OrderedDict(sorted(self.__events.items())) |
|
169
|
|
|
self.__running = True |
|
170
|
|
|
|
|
171
|
|
|
# Skip events in the past |
|
172
|
|
|
for timestamp, event in events_left.copy().items(): |
|
173
|
|
|
if timestamp < start_millis: |
|
174
|
|
|
del events_left[timestamp] |
|
175
|
|
|
|
|
176
|
|
|
# Keep looping until last event timestamp |
|
177
|
|
|
end = start + max(self.__events.keys()) + 1000 |
|
178
|
|
|
while end > time() * 1000.0 and self.__running: |
|
179
|
|
|
# Find all events to run |
|
180
|
|
|
for timestamp, event in events_left.copy().items(): |
|
181
|
|
|
# Look into the past so we don't ever miss any |
|
182
|
|
|
if timestamp <= (time() * 1000.0) - start: |
|
183
|
|
|
msg = event.run(start) # Run |
|
184
|
|
|
if self.__messages: # Debug if needed |
|
185
|
|
|
print(msg) |
|
186
|
|
|
del events_left[timestamp] # Remove - we're done with it |
|
187
|
|
|
else: |
|
188
|
|
|
# We're into the future |
|
189
|
|
|
break |
|
190
|
|
|
sleep(0.000001) |
|
191
|
|
|
|
|
192
|
|
|
# Let debug know we're done |
|
193
|
|
|
if self.__messages: |
|
194
|
|
|
print("Timed events playback completed") |
|
195
|
|
|
|
|
196
|
|
|
def run(self, start_millis: int = 0): |
|
197
|
|
|
# Create the thread and run loop |
|
198
|
|
|
thread = Thread(target=self.__run, args=[start_millis]) |
|
199
|
|
|
thread.daemon = True |
|
200
|
|
|
thread.start() |
|
201
|
|
|
|
|
202
|
|
|
for cb in self.__run_cbs: |
|
203
|
|
|
thread = Thread(target=cb) |
|
204
|
|
|
thread.daemon = True |
|
205
|
|
|
thread.start() |
|
206
|
|
|
|
|
207
|
|
|
def stop(self): |
|
208
|
|
|
self.__running = False |
|
209
|
|
|
|
|
210
|
|
|
def toggle_debug_messages(self) -> bool: |
|
211
|
|
|
self.__messages = not self.__messages |
|
212
|
|
|
return self.__messages |
|
213
|
|
|
|
|
214
|
|
|
def add_event(self, milliseconds_in: int, callback: callable, *args, name: str = ""): |
|
215
|
|
|
milliseconds_in = int(milliseconds_in) |
|
216
|
|
|
if milliseconds_in in self.__events: |
|
217
|
|
|
raise EventAlreadyExistsException(milliseconds_in) |
|
218
|
|
|
self.__events[milliseconds_in] = TimedEvent(milliseconds_in, callback, args, name) |
|
219
|
|
|
|
|
220
|
|
|
def remove_event(self, milliseconds_in: int): |
|
221
|
|
|
milliseconds_in = int(milliseconds_in) |
|
222
|
|
|
if milliseconds_in in self.__events: |
|
223
|
|
|
del self.__events[milliseconds_in] |
|
224
|
|
|
|
|
225
|
|
|
def add_run_callback(self, callback: callable): |
|
226
|
|
|
self.__run_cbs.append(callback) |
|
227
|
|
|
|
|
228
|
|
|
def clear_run_callbacks(self): |
|
229
|
|
|
self.__run_cbs = [] |
|
230
|
|
|
|
|
231
|
|
|
@property |
|
232
|
|
|
def data(self) -> Dict[int, Dict[str, str]]: |
|
233
|
|
|
return {k: v.data for k, v in self.__events.items()} |
|
234
|
|
|
|
|
235
|
|
|
def sleep_till_done(self): |
|
236
|
|
|
# Hold until all events completed |
|
237
|
|
|
while self.__running: |
|
238
|
|
|
sleep(DMXMINWAIT) |
|
239
|
|
|
|