Open Sound Control

OpenSoundControl (OSC) is a communication protocol which can allow to send information from BlenderDMX out to other software.

It is used to send fixture selection to other software, like DMX consoles and the current definition (which can be customized) is allowing for nice integration with the BlinderKitten lighting software.

Two events are hooked into OSC right now:

  • fixture selection
  • fixture clear

Fixture selection

fixture_selection

Due to limitations of how object selection works (and is understood) in BlenderDMX, fixture selection works only when a fixture is selected in the Fixtures panel or via the Programmer Selection icons.

Clear fixture selection

fixture_clear

The Clear selection icon triggers the fixture clean selection

image

Defining OSC commands

The assets/osc_templates directory contains a default.json file, the commands (fixture_selection, fixture_clear) can have a list of keys and values which are sent via OSC. The fixture_selection command takes a parameter fixture, from which various attributes can be used, in the selection case it is a fixture_id.

{
  "fixture_selection": [
    {
      "key": "/key/fixture",
      "value": ""
    },
    {
      "key": "/key/{fixture.fixture_id}",
      "value": ""
    }
  ],
  "fixture_clear": [
    {
      "key": "/key/clear",
      "value": ""
    }
  ]
}

All OSC handlers are located in file osc_utils.py, where the static methods of the DMX_OSC_Handlers class define the usage.

Edit this page on GitHub