NASPRO bridges
==============

  http://naspro.atheme.org/naspro-bridges/

  Version: 0.2.91

About
-----

  A collection of bridges to LV2 that, once installed, allow you to use plugins
  developed for other plugin standards in LV2 hosts.

  As of now, it contains two bridges: a LADSPA (http://www.ladspa.org/) 1.1
  bridge and a DSSI (http://dssi.sourceforge.net/) 1.0.0/1.1.0 bridge.

Supported platforms
-------------------

  * Linux (tested);
  * Windows (tested only with MinGW32/Wine);
  * FreeBSD (not tested);
  * Mac OS X (not tested);
  * Haiku (not tested);
  * Syllable (not tested).

Runtime dependencies
--------------------

  * NASPRO Bridge it (http://naspro.atheme.org/naspro-bridge-it/) >= 0.2.91.
  * (optional) ALSA (http://www.alsa-project.org/) or libdssialsacompat
    (http://www.smbolton.com/linux.html) for the DSSI bridge to work.

Extra build-time dependencies
-----------------------------

  * pkg-config (http://pkg-config.freedesktop.org/);
  * an environment capable of running Autotools-based build systems;
  * LV2 Dynamic Manifest (http://lv2plug.in/ns/ext/dyn-manifest/) revision 1.0;
  * (optional) LADSPA SDK (http://www.ladspa.org/) for building the LADSPA
    bridge;
  * (optional) DSSI (http://dssi.sourceforge.net/) >= 1.0.0, LV2 Events
    (http://lv2plug.in/ns/ext/event/) revision 1.0 and LV2 URI Map
    (http://lv2plug.in/ns/ext/uri-map/) revision 1.0 for building the DSSI
    bridge;
  * (optional) GNU Autoconf (http://www.gnu.org/software/autoconf/) >= 2.61, GNU
    Automake (http://www.gnu.org/software/automake/) and GNU Libtool
    (http://www.gnu.org/software/libtool/) to regenerate the build system.

Limitations
-----------

  LADSPA bridge:

    * LRDF is not directly supported, a bunch of handcrafted data bundles is
      supplied instead in order to replace it, but its installation is disabled
      by default - you can enable it using the --enable-lrdf-bundles option at
      ./configure time (BEWARE: this breaks zynjacku <= 6 and is not supported
      by lilv <= 0.4.2 ---> patch for zynjacku 6 available on the NASPRO
      website);
    * run_adding() and set_run_adding_gain() are not supported.

  DSSI bridge:

    * GUIs are not supported;
    * MIDI banks/programs are not supported;
    * there is a maximum number of events per run_synth() call (it is 4096,
      should be enough in most cases);
    * run_synth_adding(), run_multiple_synths() and run_multiple_synths_adding()
      are not supported.

Usage
-----

  Once installed, given that the bridge bundles are in a directory contained
  within the LV2 discovery path used by the host (e.g., LV2_PATH environment
  variable), they should Just Work(TM) without user intervention.

  The host must support the LV2 Dynamic Manifest specification (e.g., zynjacku
  >= 5.1 or host using lilv > 0.4.2 or lilv = 0.4.2 with a patch you can find on
  the NASPRO website, both built with dynamic manifest support enabled).

  You can use LADSPA_PATH and DSSI_PATH environment variables to provide plugin
  discovery locations as you like.
