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

  http://naspro.sourceforge.net/plugins.html#naspro-bridges

  Version: 0.5.1

About
-----

  NASPRO bridges is 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.

  The code is released under the LGPL 2.1
  (http://www.gnu.org/licenses/lgpl-2.1.html).

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

  * Linux (tested);
  * Windows >= XP, 32 and 64 bit (both not tested);
  * FreeBSD (not tested);
  * Mac OS X (not tested);
  * Haiku (not tested);
  * Syllable (not tested).

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

  * NASPRO Bridge it
    (http://naspro.sourceforge.net/libraries.html#naspro-bridge-it) >= 0.4.1.
  * (optional) ALSA (http://www.alsa-project.org/) or libdssialsacompat
    (http://www.smbolton.com/linux.html) for the DSSI bridge.

Build-time dependencies
-----------------------

  * pkg-config (http://pkg-config.freedesktop.org/);
  * An environment capable of running Autotools-based build systems;
  * (optional) LADSPA SDK (http://www.ladspa.org/) for building the LADSPA
    bridge;
  * (optional) DSSI (http://dssi.sourceforge.net/) >= 1.0.0 for building the
    DSSI bridge;
  * (optional) GNU Autoconf (http://www.gnu.org/software/autoconf/) >= 2.68, 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:

    * run_adding() and set_run_adding_gain() are not supported;
    * default port values are not exported for ports with sample rate hint;
    * LRDF is not directly supported, a bunch of handcrafted data bundles is
      supplied instead in order to replace it - their installation is enabled
      by default but you can disnable it using the --disable-lrdf-bundles option
      at ./configure time (BEWARE: installing LRDF bundles breaks zynjacku <= 6,
      a patch for zynjacku 6 available on the NASPRO website).

  DSSI bridge:

    * GUIs 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;
    * default port values are not exported for ports with sample rate hint;
    * MIDI programs are not directly supported, but they are translated to LV2
      presets - this can be disabled by using the --disable-dssi-presets option
      at ./configure time - preset values are however not exported for ports
      with sample rate hint.

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
  (http://lv2plug.in/ns/ext/dynmanifest/) (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.

Installation
------------

  As usual:

  $ ./configure && make && make install

  Extra ./configure options
  -------------------------

    --with-lv2dir=DIR       where to put LV2 bundles [LIBDIR/lv2]
    --enable-lrdf-bundles   install LRDF-equivalent LV2 bundles [default=yes]
    --enable-dssi-presets   bridge DSSI programs as LV2 presets [default=yes]
