Extend PatternPlayer interface

supriya/enums.py

@@ -20,7 +20,6 @@ class AddAction(IntEnumeration):
 
 
 class BinaryOperator(IntEnumeration):
-
     ABSOLUTE_DIFFERENCE = 38  # |a - b|
     ADDITION = 0
     AMCLIP = 40
@@ -181,7 +180,6 @@ class DoneAction(IntEnumeration):
 
 
 class EnvelopeShape(IntEnumeration):
-
     CUBED = 7
     CUSTOM = 5
     EXPONENTIAL = 2
@@ -205,7 +203,6 @@ class HeaderFormat(IntEnumeration):
 
 
 class NodeAction(IntEnumeration):
-
     NODE_CREATED = 0
     NODE_REMOVED = 1
     NODE_ACTIVATED = 2
@@ -421,7 +418,6 @@ class SignalRange(IntEnumeration):
 
 
 class UnaryOperator(IntEnumeration):
-
     ABSOLUTE_VALUE = 5
     AMPLITUDE_TO_DB = 22
     ARCCOS = 32
@@ -479,7 +475,6 @@ class UnaryOperator(IntEnumeration):
 
 
 class Unit(IntEnumeration):
-
     UNDEFINED = 0
     DECIBELS = 1
     AMPLITUDE = 2

supriya/patterns/players.py

@@ -54,11 +54,14 @@ def __init__(
         self._notes_by_uuid: Dict[Union[UUID, Tuple[UUID, int]], float] = {}
         self._uuid: UUID = uuid or uuid4()
         self._next_delta: Optional[float] = None
+        self._initial_offset: Optional[float] = None
 
     def _clock_callback(
         self, clock_context: ClockContext, *args, **kwargs
     ) -> Optional[float]:
         for clock_context, seconds, offset, events in self._find_events(clock_context):
+            if self._initial_offset is None:
+                self._initial_offset = offset
             with self._context.at(seconds):
                 for event, priority in events:
                     event.perform(
@@ -239,6 +242,15 @@ def stop(self, quantization: Optional[str] = None) -> None:
                 self._stop_callback, event_type=2, quantization=quantization
             )
 
+    def uuid_to_note_id(self, uuid: UUID, index: Optional[int] = None) -> float:
+        if index is not None:
+            return self._notes_by_uuid[uuid, index]
+        return self._notes_by_uuid[uuid]
+
+    @property
+    def initial_offset(self) -> Optional[float]:
+        return self._initial_offset
+
     @property
     def uuid(self) -> UUID:
         return self._uuid

supriya/synthdefs/synthdefs.py

@@ -889,7 +889,6 @@ def clear(self) -> None:
 
 
 class SuperColliderSynthDef:
-
     ### INITIALIZER ###
 
     def __init__(self, name, body, rates=None):

supriya/ugens/bases.py

@@ -263,7 +263,6 @@ def wrap(cls: Type) -> Type:
 
 
 class UGenMethodMixin:
-
     ### SPECIAL METHODS ###
 
     def __abs__(self):

supriya/utils/intervals.py

@@ -1488,7 +1488,6 @@ def __init__(self, start_offset):
 
 
 class IntervalTreeDriver:
-
     ### INITIALIZER ###
 
     def __init__(self, intervals=None):