Skip to content

pixsper/posistagedotnet

main
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.

PosiStageDotNet

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.

PSN Logo

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

Build status

NuGet

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();

About

C# implementation of the PosiStageNet protocol for network transport of positional data

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages