README.md

PosiStageDotNet is a C# library for implementing the PosiStageNet protocol in any project compatible with .Net 4.5 or .Net Platform Standard 1.3. The protocol is used to pass position, speed, orientation and other automation data between entertainment control systems, for example, between an automation controller and a lighting desk or media server.

See http://www.posistage.net/ for more information on PosiStageNet.

NuGet

The library is available from NuGet.org as DBDesign.PosiStageDotNet.

License

The library is LGPL 3.0 licensed, allowing use in non-GPL-licensed projects. Any modifications to the source however must be given back to the community under the same license.

Simple Examples

Sending Data

// Set this to the IP of the network interface you want to send PSN packets on
var adapterIp = IPAddress.Parse("10.0.0.1");

var psnServer = new PsnServer("Test PSN Server", adapterIp);

var trackers = new []
{
    new PsnTracker(0, "Tracker 0", 
        position: Tuple.Create(0f, 0f, 0f), 
        speed: Tuple.Create(0f, 0f, 0f), 
        orientation: Tuple.Create(0f, 0f, 0f)),
    new PsnTracker(1, "Tracker 1", 
        position: Tuple.Create(10.4f, 0f, 0f), 
        speed: Tuple.Create(1.23f, 0f, 0f), 
        orientation: Tuple.Create(0f, 85.34f, 0f)),
    new PsnTracker(2, "Tracker 2", 
        position: Tuple.Create(5.232f, 2.654f, 13.765f), 
        speed: Tuple.Create(1f, 3f, 0f), 
        orientation: Tuple.Create(23.3f, 43.3f, 76.2f))
};

psnServer.SetTrackers(trackers);

psnServer.StartSending();

// Take some more readings...

// PsnTrackers are immutable, use the 'with' methods to create a copy with mutated values
var tracker2Update = trackers[2].WithPosition(Tuple.Create(6.345f, 2.23f, 13.098f));

// We can update values for individual trackers, replacing any tracker data with the same index
psnServer.UpdateTrackers(tracker2Update);

// When you're finished...
psnServer.StopSending();

// Don't forget to dispose!
psnServer.Dispose();

Receiving Data

// Set this to the IP of the network interface you want to listen for PSN packets on
var adapterIp = IPAddress.Parse("10.0.0.1");

var psnClient = new PsnClient(adapterIp);

psnClient.TrackersUpdated += (s, e) =>
{
    foreach (var t in e.Values)
        Console.WriteLine(t);
};

psnClient.StartListening();

// Do something with the tracker data

// When you're finished...
psnClient.StopListening();

// Don't forget to dispose!
psnClient.Dispose();