WARNING
rake spec is broken (the Rakefile needs some fixing), instead run:
jruby -S spec -fs specs/opaz_plug_spec.rb
WHAT'S THERE ?
Opaz-PlugDK makes it easier/faster to create portable (Mac OS X, Windows, Linux) VST 2 plugins.
You can mix and match JRuby, Duby and Java to implement the plugins.
QUICK COURSE
AVAILABLE EXAMPLES
The examples are under the plugins folder:
- DubyGain, DubyFilta and DubyFreeComp are reflecting our current work trend, ie: mix JRuby (for declarative stuff) and Duby (for computation)
- HybridGain, HybridFilta and HybridSynth mix JRuby (for declarative stuff) and Java (for computation)
- RubyDelay, RubyFreeComp and RubyGain are pure JRuby version
DEPENDENCIES
Required:
- Java JDK (tested with version 1.6+) - the JRE is not sufficient
- JRuby (tested with version 1.4.0)
Optional:
- Mirah: jgem install mirah (or on Windows: jruby -S gem install mirah)
- JavaFX: install the JavaFX SDK 1.2.3
HOW TO BUILD A PLUGIN
See under plugins/ then use the available rake tasks to package one of them:
rake package plugin=DubyFreeComp
The package system will create ready-to-use VST for Windows, Mac OS X and Linux under the build subfolder of the plugin.
BUILD ORDER
Things are currently compiled in this order:
- src/* (Opaz stuff)
- your_plugin/*.duby
- your_plugin/*.java
- your_plugin/*.fx
PLUGINS STATUS
All the plugins compile and are able to be loaded in Ableton Live, except the Ruby based ones (temporary issue).
GUI SUPPORT
Basic GUI support is included. Example:
class MyEditor
def initialize(frame)
frame.setTitle("Hello from DefaultEditor!")
frame.setSize(400, 300)
end
end
class MyPlugin < OpazPlug
plugin "MyPlugin", "Opaz", "LoGeek"
# ...
editor MyEditor
end
You'll be passed the main container frame so that you can add stuff in it.
LIVE DEBUGGING
Thanks to Daniel309, it's possible to enable live plugin patching through an IRB session.
Tweak tasks/tools.rb around line 90 to enable the IRB debugging editor:
PluginUIClass=IRBPluginGUI
LOGGING
It's often useful to log some informations while creating plugins. You can achieve this by calling "log" from the plugin:
class MyPlugin < OpazPlug
def some_stuff
log("message!")
end
end
The logs end up inside some txt file in the plugin folder.
NOTES
The libs and templates folders are generated using rake prepare:templates and rake prepare:libs. Have a look at the rake file to see more about available tasks (compile, package, deploy).
AUTHORS AND CONTRIBUTORS
- Thibaut Barrère and Daniel309 (author of jVSTwRapper) for the whole thing
- Robert Pitts for his test clean-up patch
- Big thanks to Charles Oliver Nutter for his help on JRuby/Duby!
- Thanks as well to JFXtras for their implementation of SceneToJComponent.