wehub-resource-sync
52 lines
2.4 KiB
C#
52 lines
2.4 KiB
C#
#nullable enable
|
|
|
|
using System;
|
|
using NAudio.Midi;
|
|
|
|
namespace T3.IoServices;
|
|
|
|
/// <summary>
|
|
/// Parallel dispatch path for replaying recorded IO events through graph-side input
|
|
/// operators (<c>MidiInput</c>, <c>OscInput</c>) without going through the normal
|
|
/// hardware-bound <c>MidiConnectionManager</c> / <c>OscConnectionManager</c> routes.
|
|
/// Makes those ops fire identically whether their events come from a real device or
|
|
/// from a recorded <c>.data</c> file, identified by the same device name.
|
|
/// </summary>
|
|
/// <remarks>
|
|
/// Does <b>not</b> reach <c>CompatibleMidiDevice</c> instances (the surface controllers
|
|
/// driving variations / snapshots) — those filter by <c>sender == _midiInputConnection</c>
|
|
/// and always need a real <see cref="MidiIn"/>. Variation replay is out of scope for
|
|
/// this bus by design.
|
|
/// <para>
|
|
/// The producer side is the <c>SimulateIoData</c> operator; consumers subscribe in
|
|
/// their constructor and unsubscribe on dispose. Real-time recording
|
|
/// (<see cref="IoDataSetRecorder"/>) only listens to the connection managers, so
|
|
/// simulated events never feed back into a concurrent recording.
|
|
/// </para>
|
|
/// </remarks>
|
|
public static class SimulatedIoBus
|
|
{
|
|
/// <summary>
|
|
/// One replayed MIDI event. Identifies the source device by product name (the same
|
|
/// string <c>MidiInput.Device</c> matches against) rather than by <see cref="MidiIn"/>
|
|
/// instance, so simulation works without the original hardware connected.
|
|
/// </summary>
|
|
/// <param name="DeviceProductName">Source device name as recorded.</param>
|
|
/// <param name="Event">Reconstructed NAudio MIDI event — typically <c>NoteEvent</c>,
|
|
/// <c>ControlChangeEvent</c>, <c>PitchWheelChangeEvent</c>, or
|
|
/// <c>ChannelAfterTouchEvent</c>.</param>
|
|
public sealed record SimulatedMidiEvent(string DeviceProductName, MidiEvent Event);
|
|
|
|
/// <summary>
|
|
/// One replayed OSC event. The port matches the recorded source's port so an
|
|
/// <c>OscInput</c> bound to that port receives the event identically to a real one.
|
|
/// </summary>
|
|
public sealed record SimulatedOscEvent(int Port, string Address, object Value);
|
|
|
|
public static event Action<SimulatedMidiEvent>? MidiEventReceived;
|
|
public static event Action<SimulatedOscEvent>? OscEventReceived;
|
|
|
|
public static void DispatchMidi(SimulatedMidiEvent ev) => MidiEventReceived?.Invoke(ev);
|
|
public static void DispatchOsc(SimulatedOscEvent ev) => OscEventReceived?.Invoke(ev);
|
|
}
|