File: README

package info (click to toggle)
naspro-bridges 0.5.1-2
  • links: PTS
  • area: main
  • in suites: buster, stretch
  • size: 2,372 kB
  • ctags: 217
  • sloc: sh: 11,337; ansic: 1,270; makefile: 45
file content (104 lines) | stat: -rw-r--r-- 3,745 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
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]