From 9c6f9915175dcefe2190d7d504258b672f672087 Mon Sep 17 00:00:00 2001 From: Lars Luthman Date: Sat, 26 Mar 2011 18:47:00 +0000 Subject: Added ui-event bundle --- ext/ui-event.ttl/lv2_ui_event.h | 37 ++++++++++++++++++ ext/ui-event.ttl/manifest.ttl | 8 ++++ ext/ui-event.ttl/ui-event.ttl | 84 +++++++++++++++++++++++++++++++++++++++++ 3 files changed, 129 insertions(+) create mode 100644 ext/ui-event.ttl/lv2_ui_event.h create mode 100644 ext/ui-event.ttl/manifest.ttl create mode 100644 ext/ui-event.ttl/ui-event.ttl (limited to 'ext/ui-event.ttl') diff --git a/ext/ui-event.ttl/lv2_ui_event.h b/ext/ui-event.ttl/lv2_ui_event.h new file mode 100644 index 0000000..16739f7 --- /dev/null +++ b/ext/ui-event.ttl/lv2_ui_event.h @@ -0,0 +1,37 @@ +/************************************************************************ + * + * Event port protocol for the in-process LV2 UI extension + * + * Copyright (C) 2010 Lars Luthman + * + * 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 header file just defines a preprocessor macro for the URI prefix + for this extension. +*/ + +#ifndef LV2_UI_EVENT_H +#define LV2_UI_EVENT_H + + +/** The URI prefix for this extension. */ +#define LV2_UI_EVENT_URI "http://lv2plug.in/ns/ext/ui-event" + + +#endif diff --git a/ext/ui-event.ttl/manifest.ttl b/ext/ui-event.ttl/manifest.ttl new file mode 100644 index 0000000..d37bb13 --- /dev/null +++ b/ext/ui-event.ttl/manifest.ttl @@ -0,0 +1,8 @@ +@prefix lv2: . +@prefix rdfs: . + + + a lv2:Specification; + lv2:minorVersion 0; + lv2:microVersion 1; + rdfs:seeAlso . diff --git a/ext/ui-event.ttl/ui-event.ttl b/ext/ui-event.ttl/ui-event.ttl new file mode 100644 index 0000000..0abd09c --- /dev/null +++ b/ext/ui-event.ttl/ui-event.ttl @@ -0,0 +1,84 @@ +# In-process UI extension +# +# Copyright (C) 2010-2011 Lars Luthman +# +# based on lv2.ttl, which is +# Copyright (C) 2006-2008 Steve Harris, Dave Robillard +# +# This extension should be considered a replacement for the earlier +# in-process UI extension with the URI . +# Hosts and plugins that used that extension should use this one instead. +# The earlier in-process UI extension is not compatible with LV2 revision 3 +# and later and may break in subtle ways. +# +# Permission is hereby granted, free of charge, to any person obtaining a +# copy of this software and associated documentation files (the "Software"), +# to deal in the Software without restriction, including without limitation +# the rights to use, copy, modify, merge, publish, distribute, sublicense, +# and/or sell copies of the Software, and to permit persons to whom the +# Software is furnished to do so, subject to the following conditions: +# +# The above copyright notice and this permission notice shall be included +# in all copies or substantial portions of the Software. +# +# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL +# THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR +# OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, +# ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR +# OTHER DEALINGS IN THE SOFTWARE. + +@prefix ui: . +@prefix ev: . +@prefix uiev: . +@prefix lv2: . +@prefix rdf: . +@prefix rdfs: . +@prefix doap: . +@prefix foaf: . + + a lv2:Specification ; + doap:license ; + doap:name "LV2 UI Event port protocol" ; + doap:release [ + doap:revision "0.1" ; + doap:created "2011-03-26" + ]; + doap:maintainer [ + a foaf:Person; + foaf:name "Lars Luthman"; + foaf:mbox ; + ]; + lv2:documentation """ +This extension defines an ui:PortProtocol for passing events (MIDI, OSC, +etc) between LV2 plugins and UIs. +""". + +uiev:events a ui:PortProtocol; + rdfs:label "Event buffer"; + lv2:documentation """ +
    +
  1. This PortProtocol is valid for ports with the type ev:EventPort.
    2. +
  2. The host MUST call port_event() whenever there is an event in an input + port prior to the plugin instance's run() function is called, and whenever + there is an event in an output port after run() has been called. The + UI MUST NOT depend on the timing of the calls. However, the host MUST + do the calls in the same order that the events occur in. The host is + allowed and encouraged to bundle multiple events into a single port_event() + call if it improves performance.
    3. +
  3. The data buffer passed to port_event() is an LV2_Event_Buffer, as specified + in the Event extension. The stamp_type MUST be ignored. The frames and + subframes fields of every event in the buffer MUST be ignored. Events + with type 0 (reference counted events) MUST be ignored.
    4. +
  4. The data buffer passed to write_event() is an LV2_Event_Buffer, as specified + in the Event extension. The stamp_type MUST be ignored. The frames and + subframes fields of every event in the buffer MUST be ignored. Events + with type 0 MUST NOT be written to the buffer.
    5. +
  5. The host MUST pass all the events in the buffer to the plugin instance's + event port in the same order, but the plugin and the UI MUST NOT depend on + the timing of the events, or on whether they are all sent to the plugin in + the same run() call or distributed over multiple calls.
    6. +
  6. The data pointer in the LV2_Feature object for this feature should be + NULL.
    7. +""". -- cgit v1.2.1