vyv / psn-py

PosiStageNet Protocol - Python Wrapper

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

psn logo

An Open Protocol for On-Stage, Live 3D Position Data

Initially developed as a means for VYV's Photon Media Server to internally communicate the position of freely-moving projection surfaces, PosiStageNet became an open standard through a close collaboration between VYV and MA Lighting, makers of the world-reknowned GrandMA2 lighting console.

The result is a combined positioning and lighting system that allows for effects of an unparalleled scale, where large numbers of moving lights can precisely follow multiple performers on stage. The protocol’s applications do not stop at lighting – sound designers can use its data to accurately pan sound effects and music automatically according to the action on stage, and automation operators can obtain another level of feedback on the position of motor-driven stage elements – or even set targets. And that’s just the start; the applications of 3D stage positioning systems are only beginning to be explored.

If you have implemented PosiStageNet in your system and would like to be mentioned on the website, or you have used PosiStageNet for a project and would like to submit material for our Projects Showcase, or for other enquiries, please contact us at info@posistage.net

Python Wrapper

This package contains a Python wrapper around the C++ implementation of the protocol and pre-built Windows libraries for Python 3 x86/x64. It also contains a simple example of how to use the wrapper from the server or the client side.

The implementation is cross-platform so it should compile under Windows, Linux and Mac OS X. A Visual Studio project is given for compiling under Windows.

To clone the repository with all submodules, use git clone https://github.com/vyv/psn-py/ --recursive

For any question about the wrapper, please write at info@posistage.net

Usage

To use the wrapper in your script, you need the 'psn' python module (psn.pyd). If you are running on Windows, copy the corresponding pre-built module found in the libs folder in the script folder. If you are running on Linux or OS X or using a Python version that is not listed in libs, you need to compile the library using a C++ compiler of your choice. If you compile the library using another IDE, please provide us the resulting library so we can add it to the list!

About

PosiStageNet Protocol - Python Wrapper

License:MIT License


Languages

Language:C++ 100.0%