diff -Nru invada-studio-plugins-lv2-1.2.0/debian/changelog invada-studio-plugins-lv2-1.2.0+repack0/debian/changelog --- invada-studio-plugins-lv2-1.2.0/debian/changelog 2012-07-12 17:27:36.000000000 +0000 +++ invada-studio-plugins-lv2-1.2.0+repack0/debian/changelog 2012-07-12 16:20:04.000000000 +0000 @@ -1,3 +1,61 @@ +invada-studio-plugins-lv2 (1.2.0+repack0-4~11.04) natty; urgency=medium + + * Backport from debian wheezy. + + -- DNS777 Thu, 12 Jul 2012 15:00:00 +0000 + +invada-studio-plugins-lv2 (1.2.0+repack0-4) unstable; urgency=low + + * Team upload. + * Port to LV2's first stable spec. + * Update debian/copyright to the machine-readable format. + * Bump Standards. + + -- Alessio Treglia Mon, 14 May 2012 20:58:52 +0200 + +invada-studio-plugins-lv2 (1.2.0+repack0-3) unstable; urgency=low + + * Fixed watch file + + -- Jaromír Mikeš Sun, 19 Feb 2012 16:15:02 +0100 + +invada-studio-plugins-lv2 (1.2.0+repack0-2) unstable; urgency=low + + [ Jaromír Mikeš ] + * Copyright switched to rev. 204 + * Switched to debhelper short + * Patches forwarded + + [ Alessio Treglia ] + * Added patch fixing wrong graph in compressor GUI. + + -- Jaromír Mikeš Sun, 19 Feb 2012 03:40:29 +0100 + +invada-studio-plugins-lv2 (1.2.0+repack0-1) unstable; urgency=low + + * Team upload. + + [ Jaromír Mikeš ] + * Added DM-Upload-Allowed: yes + * Changed link to GPL-2 instead of GPL. + * Added invada-studio-plugins-lv2.lintian-overrides file + + [ Alessio Treglia ] + * Imported Upstream version 1.2.0+repack0: + - Get rid of lv2_ui.h, now provided from lv2-extensions-good. + * Switch to 3.0 (quilt) format. + * Link with --as-needed. + * debian/control: Single-space indentation, remove trailing dot from the + description. + * Build-depend on lv2-extensions-good. + * Add patch to point the #include statements to the right location of the + ui-ext's header. + * Remove copyright notice about lv2_ui.h. + * Add gbp config file. + * Bump Standards. + + -- Alessio Treglia Wed, 08 Jun 2011 11:09:06 +0200 + invada-studio-plugins-lv2 (1.2.0-1) unstable; urgency=low * Initial release (Closes: #540044) diff -Nru invada-studio-plugins-lv2-1.2.0/debian/control invada-studio-plugins-lv2-1.2.0+repack0/debian/control --- invada-studio-plugins-lv2-1.2.0/debian/control 2012-07-12 17:27:36.000000000 +0000 +++ invada-studio-plugins-lv2-1.2.0+repack0/debian/control 2012-07-12 16:18:17.000000000 +0000 @@ -2,29 +2,35 @@ Section: sound Priority: optional Maintainer: Debian Multimedia Maintainers -Uploaders: Free Ekanayaka , - Jaromír Mikeš -Build-Depends: debhelper (>= 7.0.0), - fakeroot, - libgtk2.0-dev, - lv2core -Standards-Version: 3.8.3 +Uploaders: + Free Ekanayaka , + Jaromír Mikeš +Build-Depends: + debhelper (>= 7.0.50~), + fakeroot, + libgtk2.0-dev, + lv2-dev +Standards-Version: 3.9.3 Vcs-Git: git://git.debian.org/git/pkg-multimedia/invada-lv2.git Vcs-Browser: http://git.debian.org/?p=pkg-multimedia/invada-lv2.git;a=summary Homepage: https://launchpad.net/invada-studio/+download Package: invada-studio-plugins-lv2 Architecture: any -Depends: ${shlibs:Depends}, - ${misc:Depends}, - libcairo2, - libgnome2-0, - libglade2-0, - libxml2, - libglib2.0-0, - libgtk2.0-0 -Provides: lv2-plugin -Suggests: zynjacku, ardour +Depends: + libcairo2, + libglade2-0, + libglib2.0-0, + libgnome2-0, + libgtk2.0-0, + libxml2, + ${misc:Depends}, + ${shlibs:Depends} +Provides: + lv2-plugin +Suggests: + ardour, + zynjacku Description: Invada Studio Plugins - a set of LV2 audio plugins Distortion Plugins Tube - (Mono and Stereo version) @@ -48,8 +54,8 @@ Long slow stereo phaser. . Reverb Plugins - ER Reverb - (Mono and Sum version) - Early reflection based reverb. + ER Reverb - (Mono and Sum version) + Early reflection based reverb. . Utility Plugins Input Module (Stereo only) @@ -58,4 +64,3 @@ Peak, VU, Phase and spectrograph meters. Test Tones (Mono only) Generate testtones at specific frequencies. - . diff -Nru invada-studio-plugins-lv2-1.2.0/debian/copyright invada-studio-plugins-lv2-1.2.0+repack0/debian/copyright --- invada-studio-plugins-lv2-1.2.0/debian/copyright 2012-07-12 17:27:36.000000000 +0000 +++ invada-studio-plugins-lv2-1.2.0+repack0/debian/copyright 2012-05-14 18:58:06.000000000 +0000 @@ -1,44 +1,31 @@ -This package was debianized by Debian Multimedia Maintainers on -Wed, 05 Aug 2009 05:33:07 +0200. - -It was downloaded from https://launchpad.net/invada-studio/+download - -Upstream Author: - - Fraser Stuart - -Copyright: - - Copyright (C) 2009 Fraser Stuart - -Copyright exceptions: - -The plugingui/lv2_ui.h file is copyrighted by: - - Copyright (C) 2006-2008 Lars Luthman - -License: - - This package is free software; you can redistribute it and/or modify - it under the terms of the GNU General Public License as published by - the Free Software Foundation; either version 2 of the License, or - (at your option) any later version. - - This package is distributed in the hope that it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - GNU General Public License for more details. - - You should have received a copy of the GNU General Public License - along with this package; if not, write to the Free Software - Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA - -License exceptions: - -The plugingui/lv2_ui.h file is licensed under the GNU LGPL v2.1 or later - -On Debian systems, the complete text of the GNU General -Public License can be found in `/usr/share/common-licenses/GPL'. - -The Debian packaging is Copyright (C) 2009, Jaromír Mikeš and -is licensed under the GPL, see above. +Format: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/ +Upstream-Name: invada-studio-plugins-lv2 +Upstream-Contact: Fraser Stuart +Source: https://launchpad.net/invada-studio/+download + +Files: * +Copyright: + 2009 Fraser Stuart +License: GPL-2+ + +Files: debian/* +Copyright: + 2009-2012 Jaromír Mikeš + 2011-2012 Alessio Treglia +License: GPL-2+ + +License: GPL-2+ + This program is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 2 of the License, or + (at your option) any later version. + . + This package is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. +Comment: + On Debian systems, the complete text of the GNU General + Public License can be found in `/usr/share/common-licenses/GPL-2'. + You should have received a copy of the GNU General Public License + along with this program. If not, see . diff -Nru invada-studio-plugins-lv2-1.2.0/debian/gbp.conf invada-studio-plugins-lv2-1.2.0+repack0/debian/gbp.conf --- invada-studio-plugins-lv2-1.2.0/debian/gbp.conf 1970-01-01 00:00:00.000000000 +0000 +++ invada-studio-plugins-lv2-1.2.0+repack0/debian/gbp.conf 2012-05-14 18:56:50.000000000 +0000 @@ -0,0 +1,3 @@ +[DEFAULT] +pristine-tar = True +sign-tags = True diff -Nru invada-studio-plugins-lv2-1.2.0/debian/invada-studio-plugins-lv2.lintian-overrides invada-studio-plugins-lv2-1.2.0+repack0/debian/invada-studio-plugins-lv2.lintian-overrides --- invada-studio-plugins-lv2-1.2.0/debian/invada-studio-plugins-lv2.lintian-overrides 1970-01-01 00:00:00.000000000 +0000 +++ invada-studio-plugins-lv2-1.2.0+repack0/debian/invada-studio-plugins-lv2.lintian-overrides 2012-05-14 18:56:50.000000000 +0000 @@ -0,0 +1,3 @@ +#All files for LV2 plugin should installed installed in .lv2 directory +#http://lv2plug.in/docs/index.php?title=Main_Page +invada-studio-plugins-lv2: image-file-in-usr-lib usr/lib/lv2/invada.lv2/gtk/invada_logo.png diff -Nru invada-studio-plugins-lv2-1.2.0/debian/patches/0001-find_lv2_ui_header.patch invada-studio-plugins-lv2-1.2.0+repack0/debian/patches/0001-find_lv2_ui_header.patch --- invada-studio-plugins-lv2-1.2.0/debian/patches/0001-find_lv2_ui_header.patch 1970-01-01 00:00:00.000000000 +0000 +++ invada-studio-plugins-lv2-1.2.0+repack0/debian/patches/0001-find_lv2_ui_header.patch 2012-05-14 18:56:50.000000000 +0000 @@ -0,0 +1,115 @@ +Description: ui extension is now provided by lv2-extensions-good, point the + #include statements to the right location. +Author: Alessio Treglia +Forwarded: yes +--- + plugingui/inv_compressor_gui.c | 2 +- + plugingui/inv_delay_gui.c | 2 +- + plugingui/inv_erreverb_gui.c | 2 +- + plugingui/inv_filter_gui.c | 2 +- + plugingui/inv_input_gui.c | 2 +- + plugingui/inv_meter_gui.c | 2 +- + plugingui/inv_phaser_gui.c | 2 +- + plugingui/inv_testtone_gui.c | 2 +- + plugingui/inv_tube_gui.c | 2 +- + 9 files changed, 9 insertions(+), 9 deletions(-) + +--- invada-lv2.orig/plugingui/inv_compressor_gui.c ++++ invada-lv2/plugingui/inv_compressor_gui.c +@@ -25,7 +25,7 @@ + #include + #include + #include +-#include "lv2_ui.h" ++#include "lv2/lv2plug.in/ns/extensions/ui/ui.h" + #include "widgets/widgets.h" + #include "widgets/display-Compressor.h" + #include "widgets/knob.h" +--- invada-lv2.orig/plugingui/inv_delay_gui.c ++++ invada-lv2/plugingui/inv_delay_gui.c +@@ -25,7 +25,7 @@ + #include + #include + #include +-#include "lv2_ui.h" ++#include "lv2/lv2plug.in/ns/extensions/ui/ui.h" + #include "widgets/widgets.h" + #include "widgets/knob.h" + #include "widgets/lamp.h" +--- invada-lv2.orig/plugingui/inv_erreverb_gui.c ++++ invada-lv2/plugingui/inv_erreverb_gui.c +@@ -25,7 +25,7 @@ + #include + #include + #include +-#include "lv2_ui.h" ++#include "lv2/lv2plug.in/ns/extensions/ui/ui.h" + #include "widgets/widgets.h" + #include "widgets/display-ErReverb.h" + #include "widgets/knob.h" +--- invada-lv2.orig/plugingui/inv_filter_gui.c ++++ invada-lv2/plugingui/inv_filter_gui.c +@@ -25,7 +25,7 @@ + #include + #include + #include +-#include "lv2_ui.h" ++#include "lv2/lv2plug.in/ns/extensions/ui/ui.h" + #include "widgets/widgets.h" + #include "widgets/knob.h" + #include "widgets/lamp.h" +--- invada-lv2.orig/plugingui/inv_input_gui.c ++++ invada-lv2/plugingui/inv_input_gui.c +@@ -25,7 +25,7 @@ + #include + #include + #include +-#include "lv2_ui.h" ++#include "lv2/lv2plug.in/ns/extensions/ui/ui.h" + #include "widgets/widgets.h" + #include "widgets/knob.h" + #include "widgets/lamp.h" +--- invada-lv2.orig/plugingui/inv_meter_gui.c ++++ invada-lv2/plugingui/inv_meter_gui.c +@@ -25,7 +25,7 @@ + #include + #include + #include +-#include "lv2_ui.h" ++#include "lv2/lv2plug.in/ns/extensions/ui/ui.h" + #include "widgets/widgets.h" + #include "widgets/meter-peak.h" + #include "widgets/meter-phase.h" +--- invada-lv2.orig/plugingui/inv_phaser_gui.c ++++ invada-lv2/plugingui/inv_phaser_gui.c +@@ -25,7 +25,7 @@ + #include + #include + #include +-#include "lv2_ui.h" ++#include "lv2/lv2plug.in/ns/extensions/ui/ui.h" + #include "widgets/widgets.h" + #include "widgets/knob.h" + #include "widgets/lamp.h" +--- invada-lv2.orig/plugingui/inv_testtone_gui.c ++++ invada-lv2/plugingui/inv_testtone_gui.c +@@ -25,7 +25,7 @@ + #include + #include + #include +-#include "lv2_ui.h" ++#include "lv2/lv2plug.in/ns/extensions/ui/ui.h" + #include "widgets/widgets.h" + #include "widgets/knob.h" + #include "widgets/lamp.h" +--- invada-lv2.orig/plugingui/inv_tube_gui.c ++++ invada-lv2/plugingui/inv_tube_gui.c +@@ -25,7 +25,7 @@ + #include + #include + #include +-#include "lv2_ui.h" ++#include "lv2/lv2plug.in/ns/extensions/ui/ui.h" + #include "widgets/widgets.h" + #include "widgets/knob.h" + #include "widgets/lamp.h" diff -Nru invada-studio-plugins-lv2-1.2.0/debian/patches/0002-fixed_wrong_graph_in_compressor_gui.patch invada-studio-plugins-lv2-1.2.0+repack0/debian/patches/0002-fixed_wrong_graph_in_compressor_gui.patch --- invada-studio-plugins-lv2-1.2.0/debian/patches/0002-fixed_wrong_graph_in_compressor_gui.patch 1970-01-01 00:00:00.000000000 +0000 +++ invada-studio-plugins-lv2-1.2.0+repack0/debian/patches/0002-fixed_wrong_graph_in_compressor_gui.patch 2012-05-14 18:56:50.000000000 +0000 @@ -0,0 +1,38 @@ +From: Pablo Lopez Rios +Description: Fixed wrong graph in compressor GUI. +Bug-Ubuntu: https://launchpad.net/bugs/755151 +Forwarded: yes +--- + plugingui/widgets/display-Compressor.c | 7 +++---- + 1 file changed, 3 insertions(+), 4 deletions(-) + +--- invada-lv2.orig/plugingui/widgets/display-Compressor.c ++++ invada-lv2/plugingui/widgets/display-Compressor.c +@@ -314,7 +314,7 @@ inv_display_comp_paint(GtkWidget *widget + + gint i; + float rmsC,rmsV,attackC,releaseC,env; +- float y,threshsig; ++ float y; + cairo_t *cr; + GtkStyle *style; + char label[50]; +@@ -677,8 +677,7 @@ inv_display_comp_paint(GtkWidget *widget + /* compressed signal */ + + // gain change at +6 db <- GRAPH MUST END HERE +- threshsig=pow(10,threshold/20); +- y = 20*log10(threshsig+((2-threshsig)/ratio)); ++ y = threshold+(6-threshold)/ratio; + + if(bypass==INV_PLUGIN_BYPASS) { + cairo_set_source_rgb(cr, 0.4, 0.4, 0.4); +@@ -687,7 +686,7 @@ inv_display_comp_paint(GtkWidget *widget + } + cairo_set_line_width(cr,2); + +- cairo_move_to(cr, 306 , 200-(21*gain/6)); ++ cairo_move_to(cr, 306 , 199-(21*gain/6)); + cairo_line_to(cr, 536+(30*threshold/6), 38-(21*gain/6)-(21*threshold/6)); + cairo_line_to(cr, 566 , 38-(21*gain/6)-(21*y/6)); + cairo_stroke(cr); diff -Nru invada-studio-plugins-lv2-1.2.0/debian/patches/series invada-studio-plugins-lv2-1.2.0+repack0/debian/patches/series --- invada-studio-plugins-lv2-1.2.0/debian/patches/series 1970-01-01 00:00:00.000000000 +0000 +++ invada-studio-plugins-lv2-1.2.0+repack0/debian/patches/series 2012-05-14 18:56:50.000000000 +0000 @@ -0,0 +1,2 @@ +0001-find_lv2_ui_header.patch +0002-fixed_wrong_graph_in_compressor_gui.patch diff -Nru invada-studio-plugins-lv2-1.2.0/debian/rules invada-studio-plugins-lv2-1.2.0+repack0/debian/rules --- invada-studio-plugins-lv2-1.2.0/debian/rules 2012-07-12 17:27:36.000000000 +0000 +++ invada-studio-plugins-lv2-1.2.0+repack0/debian/rules 2012-05-14 18:56:50.000000000 +0000 @@ -1,75 +1,10 @@ #!/usr/bin/make -f -# -*- makefile -*- -# Sample debian/rules that uses debhelper. -# GNU copyright 1997 to 1999 by Joey Hess. +LDFLAGS+=-Wl,--as-needed CFLAGS = -Wall -g -ifneq (,$(findstring noopt,$(DEB_BUILD_OPTIONS))) - CFLAGS += -O0 -else - CFLAGS += -O2 -endif -ifeq (,$(findstring nostrip,$(DEB_BUILD_OPTIONS))) - INSTALL_PROGRAM += -s -endif +%: + dh $@ -configure: configure-stamp -configure-stamp: - dh_testdir - - touch configure-stamp - - -build: build-stamp - -build-stamp: configure-stamp - dh_testdir - - $(MAKE) - - touch build-stamp - -clean: - dh_testdir - dh_testroot - rm -f build-stamp configure-stamp - - [ ! -f Makefile ] || $(MAKE) clean - - dh_clean - -install: build - dh_testdir - dh_testroot - dh_prep - dh_installdirs - - $(MAKE) install-sys INSTALL_SYS_PLUGINS_DIR=$(CURDIR)/debian/invada-studio-plugins-lv2/usr/lib/lv2 - - -# Build architecture-independent files here. -binary-indep: build install -# We have nothing to do by default. - -# Build architecture-dependent files here. -binary-arch: build install - dh_testdir - dh_testroot - dh_installchangelogs - dh_installdocs - dh_installexamples - dh_installman - dh_link - dh_strip - dh_compress - dh_fixperms - dh_makeshlibs - dh_installdeb - dh_shlibdeps - dh_gencontrol - dh_md5sums - dh_builddeb - -binary: binary-indep binary-arch -.PHONY: build clean binary-indep binary-arch binary install configure +override_dh_auto_install: + $(MAKE) install-sys INSTALL_SYS_PLUGINS_DIR=$(CURDIR)/debian/invada-studio-plugins-lv2/usr/lib/lv2 diff -Nru invada-studio-plugins-lv2-1.2.0/debian/source/format invada-studio-plugins-lv2-1.2.0+repack0/debian/source/format --- invada-studio-plugins-lv2-1.2.0/debian/source/format 1970-01-01 00:00:00.000000000 +0000 +++ invada-studio-plugins-lv2-1.2.0+repack0/debian/source/format 2012-07-12 17:27:37.000000000 +0000 @@ -0,0 +1 @@ +3.0 (quilt) diff -Nru invada-studio-plugins-lv2-1.2.0/debian/watch invada-studio-plugins-lv2-1.2.0+repack0/debian/watch --- invada-studio-plugins-lv2-1.2.0/debian/watch 2012-07-12 17:27:36.000000000 +0000 +++ invada-studio-plugins-lv2-1.2.0+repack0/debian/watch 2012-05-14 18:56:50.000000000 +0000 @@ -1,4 +1,4 @@ version=3 https://launchpad.net/invada-studio/+download/ \ -http://launchpad.net/invada-studio/lv2/\d\.\d/\+download/invada-studio-plugins-lv2_(.*)-nopkg.tgz +https://launchpad.net/invada-studio/lv2/\d\.\d/\+download/invada-studio-plugins-lv2_(.*)-nopkg.tgz diff -Nru invada-studio-plugins-lv2-1.2.0/plugingui/lv2_ui.h invada-studio-plugins-lv2-1.2.0+repack0/plugingui/lv2_ui.h --- invada-studio-plugins-lv2-1.2.0/plugingui/lv2_ui.h 2009-09-08 18:01:30.000000000 +0000 +++ invada-studio-plugins-lv2-1.2.0+repack0/plugingui/lv2_ui.h 1970-01-01 00:00:00.000000000 +0000 @@ -1,357 +0,0 @@ -/************************************************************************ - * - * In-process UI extension for LV2 - * - * Copyright (C) 2006-2008 Lars Luthman - * - * Based on lv2.h, which was - * - * Copyright (C) 2000-2002 Richard W.E. Furse, Paul Barton-Davis, - * Stefan Westerfeld - * Copyright (C) 2006 Steve Harris, Dave Robillard. - * - * This header is free software; you can redistribute it and/or modify it - * under the terms of the GNU Lesser General Public License as published - * by the Free Software Foundation; either version 2.1 of the License, - * or (at your option) any later version. - * - * This header is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU - * Lesser General Public License for more details. - * - * You should have received a copy of the GNU Lesser General Public - * License along with this library; if not, write to the Free Software - * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 - * USA. - * - ***********************************************************************/ - -/** @file - This extension defines an interface that can be used in LV2 plugins and - hosts to create UIs for plugins. The UIs are plugins that reside in - shared object files in an LV2 bundle and are referenced in the RDF data - using the triples (Turtle shown) -
    
-    @@prefix uiext:  .
-        uiext:ui      .
-        a            uiext:GtkUI .
-      uiext:binary  .
-
- where is the URI of the plugin, is - the URI of the plugin UI and is the relative URI to the shared - object file. While it is possible to have the plugin UI and the plugin in - the same shared object file it is probably a good idea to keep them - separate so that hosts that don't want UIs don't have to load the UI code. - A UI MUST specify its class in the RDF data. In this case the class is - uiext:GtkUI, which is the only class defined by this extension. - - (Note: the prefix above is used throughout this file for the same URI) - - It's entirely possible to have multiple UIs for the same plugin, or to have - the UI for a plugin in a different bundle from the actual plugin - this - way people other than the plugin author can write plugin UIs independently - without editing the original plugin bundle. - - Note that the process that loads the shared object file containing the UI - code and the process that loads the shared object file containing the - actual plugin implementation does not have to be the same. There are many - valid reasons for having the plugin and the UI in different processes, or - even on different machines. This means that you can _not_ use singletons - and global variables and expect them to refer to the same objects in the - UI and the actual plugin. The function callback interface defined in this - header is all you can expect to work. - - Since the LV2 specification itself allows for extensions that may add - new types of data and configuration parameters that plugin authors may - want to control with a UI, this extension allows for meta-extensions that - can extend the interface between the UI and the host. These extensions - mirror the extensions used for plugins - there are required and optional - "features" that you declare in the RDF data for the UI as -
    
-     uiext:requiredFeature  .
-     uiext:optionalFeature  .
-
- These predicates have the same semantics as lv2:requiredFeature and - lv2:optionalFeature - if a UI is declaring a feature as required, the - host is NOT allowed to load it unless it supports that feature, and if it - does support a feature (required or optional) it MUST pass that feature's - URI and any additional data (specified by the meta-extension that defines - the feature) to the UI's instantiate() function. - - These features may be used to specify how to pass data between the UI - and the plugin port buffers - see LV2UI_Write_Function for details. - - There are two features defined in this extension that hosts may want to - implement: -
-    uiext:makeResident
-    uiext:makeSONameResident
-
- If the first feature, @c uiext:makeResident, is required by a UI the host - MUST never unload the shared library containing the UI implementation - during the lifetime of the host process (e.g. never calling dlclose() on - Linux). This feature may be needed by e.g. a uiext:GtkUI that registers - its own Glib types using g_type_register_static() - if it gets unloaded - and then loaded again the type registration will break, since there is no - way to unregister the types when the library is unloaded. - - The second feature, @c uiext:makeSONameResident, is ELF specific - and if it is required by an UI the UI should also list a number of - SO names (shared object names) for libraries that the UI shared object - depends on and that may not be unloaded during the lifetime of the host - process, using the predicate @c uiext:residentSONames, like this: -
-     uiext:residentSONames "libgtkmm-2.4.so.1", "libfoo.so.0"
-
- The host MUST then make sure that the shared libraries with the given ELF - SO names are not unloaded when the plugin UI is, but stay loaded during - the entire lifetime of the host process. On Linux this can be accomplished - by calling dlopen() on the shared library file with that SO name and never - calling a matching dlclose(). However, if a plugin UI requires the - @c uiext:makeSONameResident feature, it MUST always be safe for the host to - just never unload the shared object containing the UI implementation, i.e. - act as if the UI required the @c uiext:makeResident feature instead. Thus - the host only needs to find the shared library files corresponding to the - given SO names if it wants to save RAM by unloading the UI shared object - file when it is no longer needed. - - UIs written to this specification do not need to be threadsafe - the - functions defined below may only be called in the same thread as the UI - main loop is running in. - - Note that this UI extension is NOT a lv2:Feature. There is no way for a - plugin to know whether the host that loads it supports UIs or not, and - the plugin must ALWAYS work without the UI (although it may be rather - useless unless it has been configured using the UI in a previous session). - - A UI does not have to be a graphical widget, it could just as well be a - server listening for OSC input or an interface to some sort of hardware - device, depending on the RDF class of the UI. -*/ - -#ifndef LV2_UI_H -#define LV2_UI_H - -#include - -#define LV2_UI_URI "http://lv2plug.in/ns/extensions/ui" - - -#ifdef __cplusplus -extern "C" { -#endif - - -/** A pointer to some widget or other type of UI handle. - The actual type is defined by the type URI of the UI, e.g. if - " a uiext:GtkUI", this is a pointer - to a GtkWidget compatible with GTK+ 2.0 and the UI can expect the GTK+ - main loop to be running during the entire lifetime of all instances of that - UI. All the functionality provided by this extension is toolkit - independent, the host only needs to pass the necessary callbacks and - display the widget, if possible. Plugins may have several UIs, in various - toolkits, but uiext:GtkUI is the only type that is defined in this - extension. */ -typedef void* LV2UI_Widget; - - -/** A pointer to some host data required to instantiate a UI. - Like the type of the widget, the actual type of this pointer is defined by - the type URI of the UI. Hosts can use this to pass toolkit specific data - to a UI it needs to instantiate (type map, drawing context, etc). For the - uiext:GtkUI type this should be NULL. */ -typedef void* LV2UI_Host_Data; - - -/** This handle indicates a particular instance of a UI. - It is valid to compare this to NULL (0 for C++) but otherwise the - host MUST not attempt to interpret it. The UI plugin may use it to - reference internal instance data. */ -typedef void* LV2UI_Handle; - - -/** This handle indicates a particular plugin instance, provided by the host. - It is valid to compare this to NULL (0 for C++) but otherwise the - UI plugin MUST not attempt to interpret it. The host may use it to - reference internal plugin instance data. */ -typedef void* LV2UI_Controller; - - -/** This is the type of the host-provided function that the UI can use to - send data to a plugin's input ports. The @c buffer parameter must point - to a block of data, @c buffer_size bytes large. The contents of this buffer - will depend on the class of the port it's being sent to, and the transfer - mechanism specified for that port class. - - Transfer mechanisms are Features and may be defined in meta-extensions. - They specify how to translate the data buffers passed to this function - to input data for the plugin ports. If a UI wishes to write data to an - input port, it must list a transfer mechanism Feature for that port's - class as an optional or required feature (depending on whether the UI - will work without being able to write to that port or not). The only - exception is ports of the class lv2:ControlPort, for which @c buffer_size - should always be 4 and the buffer should always contain a single IEEE-754 - float. - - The UI MUST NOT try to write to a port for which there is no specified - transfer mechanism, or to an output port. The UI is responsible for - allocating the buffer and deallocating it after the call. A function - pointer of this type will be provided to the UI by the host in the - instantiate() function. - - An UI may list multiple transfer mechanisms for the same port type. - To tell the host which mechanism is to be used, it passes an integer ID - for the mechanism in the @c format parameter. This ID is retrieved from - a URI-to-integer mapping function provided by the host, using the URI Map - feature with the map URI - "http://lv2plug.in/ns/extensions/ui". Thus a UI that requires transfer - mechanism features MUST also require the URI Map feature. A @c format - value of 0 is a special case that always means that the buffer should - be interpreted as a single IEEE-754 float, and may only be written to - a control port. - - An UI MUST NOT pass a @c format parameter value (except 0) that has not - been returned by the host-provided URI mapping function for a - host-supported transfer mechanism feature URI. -*/ -typedef void (*LV2UI_Write_Function)(LV2UI_Controller controller, - uint32_t port_index, - uint32_t buffer_size, - uint32_t format, - const void* buffer); - - -/** */ -typedef struct _LV2UI_Descriptor { - - /** The URI for this UI (not for the plugin it controls). */ - const char* URI; - - /** Create a new UI object and return a handle to it. This function works - similarly to the instantiate() member in LV2_Descriptor. - - @param descriptor The descriptor for the UI that you want to instantiate. - @param plugin_uri The URI of the plugin that this UI will control. - @param bundle_path The path to the bundle containing the RDF data file - that references this shared object file, including the - trailing '/'. - @param write_function A function provided by the host that the UI can - use to send data to the plugin's input ports. - @param controller A handle for the plugin instance that should be passed - as the first parameter of @c write_function. - @param widget A pointer to an LV2UI_Widget. The UI will write a - widget pointer to this location (what type of widget - depends on the RDF class of the UI) that will be the - main UI widget. - @param features An array of LV2_Feature pointers. The host must pass - all feature URIs that it and the plugin supports and any - additional data, just like in the LV2 plugin - instantiate() function. - */ - LV2UI_Handle (*instantiate)(const struct _LV2UI_Descriptor* descriptor, - const char* plugin_uri, - const char* bundle_path, - LV2UI_Write_Function write_function, - LV2UI_Controller controller, - LV2UI_Widget* widget, - const LV2_Feature* const* features); - - - /** Destroy the UI object and the associated widget. The host must not try - to access the widget after calling this function. - */ - void (*cleanup)(LV2UI_Handle ui); - - /** Tell the UI that something interesting has happened at a plugin port. - What is interesting and how it is written to the buffer passed to this - function is defined by transfer mechanism extensions (see - LV2UI_Write_Function). The only exception is ports of the class - lv2:ControlPort, for which this function should be called - when the port value changes (it does not have to be called for every - single change if the host's UI thread has problems keeping up with - the thread the plugin is running in), @c buffer_size should be 4 and the - buffer should contain a single IEEE-754 float. In this case the @c format - parameter should be 0. - - By default, the host should only call this function for input ports of - the lv2:ControlPort class. However, the default setting can be modified - by using the following URIs in the UI's RDF data: - 
-      uiext:portNotification
-      uiext:noPortNotification
-      uiext:plugin
-      uiext:portIndex
-
- For example, if you want the UI with uri - for the plugin with URI - to get notified when the value of the - output control port with index 4 changes, you would use the following - in the RDF for your UI: - 
-       uiext:portNotification [ uiext:plugin  ;
-                                                      uiext:portIndex 4 ] .
-
- and similarly with uiext:noPortNotification if you wanted - to prevent notifications for a port for which it would be on by default - otherwise. The UI is not allowed to request notifications for ports - for which no transfer mechanism is specified, if it does it should be - considered broken and the host should not load it. - - The @c buffer is only valid during the time of this function call, so if - the UI wants to keep it for later use it has to copy the contents to an - internal buffer. - - This member may be set to NULL if the UI is not interested in any - port events. - - The @c format parameter is used to specify the format of the buffer - contents, with the same restrictions as in LV2_Write_Function. - */ - void (*port_event)(LV2UI_Handle ui, - uint32_t port_index, - uint32_t buffer_size, - uint32_t format, - const void* buffer); - - /** Returns a data structure associated with an extension URI, for example - a struct containing additional function pointers. Avoid returning - function pointers directly since standard C++ has no valid way of - casting a void* to a function pointer. This member may be set to NULL - if the UI is not interested in supporting any extensions. This is similar - to the extension_data() member in LV2_Descriptor. - */ - const void* (*extension_data)(const char* uri); - -} LV2UI_Descriptor; - - - -/** A plugin UI programmer must include a function called "lv2ui_descriptor" - with the following function prototype within the shared object - file. This function will have C-style linkage (if you are using - C++ this is taken care of by the 'extern "C"' clause at the top of - the file). This function will be accessed by the UI host using the - @c dlsym() function and called to get a LV2UI_UIDescriptor for the - wanted plugin. - - Just like lv2_descriptor(), this function takes an index parameter. The - index should only be used for enumeration and not as any sort of ID number - - the host should just iterate from 0 and upwards until the function returns - NULL, or a descriptor with an URI matching the one the host is looking for - is returned. -*/ -const LV2UI_Descriptor* lv2ui_descriptor(uint32_t index); - - -/** This is the type of the lv2ui_descriptor() function. */ -typedef const LV2UI_Descriptor* (*LV2UI_DescriptorFunction)(uint32_t index); - - - -#ifdef __cplusplus -} -#endif - - -#endif