SO业务编排>> kinesys-osc>> 返回
项目作者： jcoopertech

项目描述 ：
Open Sound Control (OSC) for Kinesys Vector v2 Motion Control and Automation.
高级语言： Python
项目地址: git://github.com/jcoopertech/kinesys-osc.git
创建时间： 2020-05-04T13:44:00Z
项目社区：https://github.com/jcoopertech/kinesys-osc
开源协议：MIT License
下载


kinesys-osc

OSC control for Kinesys Vector v2 Motion Control and Automation System.

Purpose

Emulates Kinesys Vector V2 Keyboard Shortcuts, to emulate an operator starting playbacks. This is to enable timecode triggered automation in a simulation environment.

Disclaimer

This code should never be used to control motors or drives in a real world scenario.
You take sole responsibility for how you use this code.

This system was built for a virtual show, where Vector sends Media Server Packets to D3, for simulation of set piece movement.

There are going to be bugs and scenarios which this code cannot protect against. Only through trial and error do we find them.
Make sure you always have an attentive automation operator if implementing this code in real life (not recommended at all).

Dependencies

Available in requirements.txt (kinesys-osc_pkg/requirements.txt)

  1. pyAutoGUI
  2. pythonosc

Usage

On Windows:

  1. python control_vector_osc.py [--ip IP] [--port PORT] [--cuelist FILE_NAME]

On Mac:

  1. python3 control_vector_osc.py [--ip IP] [--port PORT] [--cuelist FILE_NAME]

Default values:

If argument is ommited, default values are:

  1. --ip: 127.0.0.1
  2. --port: 42020
  3. --cuelist: None

If cuelist is None, we will load whatever is programmed in the file as “cuelist“

Example cuelist array is below:
Note: Elements should be floats, and have one decimal - Vector will only do Q Numbers to 1dp.

  1. cuelist = [
  2. 0.1, 0.2, 0.3, 1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0, 9.0, 10.0, 10.9
  3. ]

Available Vector control commands:

All OSC commands below are prefixed with the following system_address:

  1. system_id = "CustomStringHere"
  2. system_address = f"/kinesys/{system_id}"

By default, system_id = "SST_Auto"

Shown below are the currently available Vector control features, next to the button presses they emulate.
These commands should be given as values under the /control address

  1. command_keys = {
  2. "all_stop": "space",
  3. "red_stop": "f2",
  4. "blue_stop": "f4",
  5. "green_stop": "f6",
  6. "yellow_stop": "f8",
  7. "red_start": "f1",
  8. "blue_start": "f3",
  9. "green_start": "f5",
  10. "yellow_start": "f7",
  11. "next_cue": "pagedown",
  12. "prev_cue": "pageup",
  13. "first_cue": "home",
  14. "last_cue": "end",
  15. "load": "f12",
  16. }

Example operation of control OSC:

This gives an example of the OSC commands needed to load the first cue, then start the red playback in Vector.

  1. /kinesys/SST_Auto/control first_cue
  2. /kinesys/SST_Auto/control load
  3. /kinesys/SST_Auto/control red_start

Cuelists

We can go to a specific place in the Vector show by using the place command.
This requires you to have an up-to-date cuelist array in the programming code - so that Python knows what cue Vector is skipping.
If one is missing / one is added, we’ll start to undershoot or overshoot cues in the cuelist - which won’t be fun.

Available Cuelist manipulation commands:

/place - to go to a specific Cue in Vector

/cue/add N - to add a cue of number N (the cuelist is automatically sorted)

/cue/delete N - delete the cue

/cue/save F - save the current python cuelist array to F.qlist

/cue/open F - load the cuelist array from the F.qlist file on disk.

Example operation of OSC cuelist manipulation

This sequence of commands adds cue 2.1, deletes cue 1, and saves these changes to mycuelist.qlist.
We then put Vector into cue 6, which can then be loaded, and playbacks started as needed.

Please note: all numbers should be floats

  1. /kinesys/SST_Auto/cue/add 2.1
  2. /kinesys/SST_Auto/cue/delete 1.0
  3. /kinesys/SST_Auto/cue/save mycuelist
  4. /kinesys/SST_Auto/place 6.0
  5. /kinesys/SST_Auto/control load
  6. /kinesys/SST_Auto/control yellow_start