diff options
| -rw-r--r-- | doc/doxy-style.css | 2 | ||||
| -rw-r--r-- | doc/reference.doxygen.in | 6 | ||||
| -rw-r--r-- | lv2/lv2plug.in/ns/ext/atom/atom.hpp | 81 | ||||
| -rw-r--r-- | lv2/lv2plug.in/ns/ext/urid/urid.hpp | 114 | ||||
| -rw-r--r-- | lv2/lv2plug.in/ns/lv2core/Feature.hpp | 74 | ||||
| -rw-r--r-- | lv2/lv2plug.in/ns/lv2core/Lib.hpp | 81 | ||||
| -rw-r--r-- | lv2/lv2plug.in/ns/lv2core/Plugin.hpp | 260 | ||||
| -rw-r--r-- | plugins/eg-midiamp.lv2/README.txt | 3 | ||||
| -rw-r--r-- | plugins/eg-midiamp.lv2/manifest.ttl.in | 7 | ||||
| -rw-r--r-- | plugins/eg-midiamp.lv2/manifest.ttl.in~949f1baa9a283df26a7238c6bd4bb97272ae1192 | 7 | ||||
| -rw-r--r-- | plugins/eg-midiamp.lv2/manifest.ttl.in~HEAD | 7 | ||||
| -rw-r--r-- | plugins/eg-midiamp.lv2/midiamp.cpp | 128 | ||||
| -rw-r--r-- | plugins/eg-midiamp.lv2/midiamp.ttl | 35 | ||||
| l--------- | plugins/eg-midiamp.lv2/waf | 1 | ||||
| -rw-r--r-- | plugins/eg-midiamp.lv2/wscript | 66 | ||||
| -rw-r--r-- | plugins/wscript | 8 | ||||
| -rw-r--r-- | wscript | 4 |
17 files changed, 882 insertions, 2 deletions
diff --git a/doc/doxy-style.css b/doc/doxy-style.css index f6ff8bb..29ef6d8 100644 --- a/doc/doxy-style.css +++ b/doc/doxy-style.css @@ -1,4 +1,5 @@ body { + font-family: sans-serif; max-width: 80em; margin: 0; margin-left: auto; @@ -347,6 +348,7 @@ td.mlabels-right { .memtemplate { color: #4665A2; font-weight: bold; + padding-left: 6px; } .memnav { diff --git a/doc/reference.doxygen.in b/doc/reference.doxygen.in index ff210f4..a8c362e 100644 --- a/doc/reference.doxygen.in +++ b/doc/reference.doxygen.in @@ -431,7 +431,7 @@ EXTRACT_ALL = NO # be included in the documentation. # The default value is: NO. -EXTRACT_PRIVATE = YES +EXTRACT_PRIVATE = NO # If the EXTRACT_PACKAGE tag is set to YES, all members with package or internal # scope will be included in the documentation. @@ -808,7 +808,9 @@ INPUT = @LV2_SRCDIR@/doc/mainpage.dox \ @LV2_SRCDIR@/lv2/lv2plug.in/ns/ext/worker/worker.h \ @LV2_SRCDIR@/lv2/lv2plug.in/ns/extensions/ui/ui.h \ @LV2_SRCDIR@/lv2/lv2plug.in/ns/extensions/units/units.h \ - @LV2_SRCDIR@/lv2/lv2plug.in/ns/lv2core/lv2.h + @LV2_SRCDIR@/lv2/lv2plug.in/ns/lv2core/lv2.h \ + @LV2_SRCDIR@/lv2/lv2plug.in/ns/lv2core/Plugin.hpp \ + @LV2_SRCDIR@/lv2/lv2plug.in/ns/lv2core/Lib.hpp # This tag can be used to specify the character encoding of the source files # that doxygen parses. Internally doxygen uses the UTF-8 encoding. Doxygen uses diff --git a/lv2/lv2plug.in/ns/ext/atom/atom.hpp b/lv2/lv2plug.in/ns/ext/atom/atom.hpp new file mode 100644 index 0000000..87871c0 --- /dev/null +++ b/lv2/lv2plug.in/ns/ext/atom/atom.hpp @@ -0,0 +1,81 @@ +/* + Copyright 2008-2014 David Robillard <http://drobilla.net> + + Permission to use, copy, modify, and/or distribute this software for any + purpose with or without fee is hereby granted, provided that the above + copyright notice and this permission notice appear in all copies. + + THIS SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES + WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF + MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR + ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN + ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF + OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. +*/ + +#ifndef LV2_ATOM_ATOM_HPP +#define LV2_ATOM_ATOM_HPP + +#include "lv2/lv2plug.in/ns/ext/atom/atom.h" +#include "lv2/lv2plug.in/ns/ext/atom/util.h" + +namespace lv2 { +namespace atom { + +typedef LV2_Atom Atom; + +struct Event : public LV2_Atom_Event +{ + inline uint32_t type() const { return body.type; } + inline uint32_t size() const { return body.size; } + + /** Convenience accessor for byte-oriented payloads. */ + inline uint8_t operator[](size_t i) const { + return *((const uint8_t*)(&body + 1) + i); + } +}; + +class Sequence : public LV2_Atom_Sequence +{ +public: + class const_iterator { + public: + inline const_iterator(const Event* ev) : m_ev(ev) {} + + inline const_iterator operator++() { + m_ev = (const Event*)( + (const uint8_t*)m_ev + + sizeof(LV2_Atom_Event) + + lv2_atom_pad_size(m_ev->body.size)); + return *this; + } + + inline bool operator==(const const_iterator& i) const { + return m_ev == i.m_ev; + } + + inline bool operator!=(const const_iterator& i) const { + return m_ev != i.m_ev; + } + + inline const Event& operator*() const { return *m_ev; } + inline const Event* operator->() const { return m_ev; } + + private: + const Event* m_ev; + }; + + inline const_iterator begin() const { + return const_iterator((const Event*)(&body + 1)); + } + + inline const_iterator end() const { + return const_iterator((const Event*)((const char*)&body + atom.size)); + } +}; + +} // namespace atom +} // namespace lv2 + +#endif // LV2_ATOM_ATOM_HPP diff --git a/lv2/lv2plug.in/ns/ext/urid/urid.hpp b/lv2/lv2plug.in/ns/ext/urid/urid.hpp new file mode 100644 index 0000000..38fa8be --- /dev/null +++ b/lv2/lv2plug.in/ns/ext/urid/urid.hpp @@ -0,0 +1,114 @@ +/* + Copyright 2015 David Robillard <http://drobilla.net> + + Permission to use, copy, modify, and/or distribute this software for any + purpose with or without fee is hereby granted, provided that the above + copyright notice and this permission notice appear in all copies. + + THIS SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES + WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF + MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR + ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN + ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF + OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. +*/ + +#ifndef LV2_URID_HPP +#define LV2_URID_HPP + +#include "lv2/lv2plug.in/ns/lv2core/Feature.hpp" +#include "lv2/lv2plug.in/ns/ext/urid/urid.h" + +namespace lv2 { +namespace urid { + +/** + URI mapped to an integer. +*/ +typedef LV2_URID URID; + +/** + URID Map Feature (LV2_URID__map) +*/ +template<bool Required> +class Map : public Feature<LV2_URID_Map, Required> +{ +public: + Map(const LV2_Feature*const* features, + bool* valid) + : Feature<LV2_URID_Map, true>(features, LV2_URID__map, valid) + {} + + /** + Get the numeric ID of a URI. + + If the ID does not already exist, it will be created. + + This function is referentially transparent; any number of calls with the + same arguments is guaranteed to return the same value over the life of a + plugin instance. Note, however, that several URIs MAY resolve to the + same ID if the host considers those URIs equivalent. + + This function is not necessarily very fast or RT-safe: plugins SHOULD + cache any IDs they might need in performance critical situations. + + The return value 0 is reserved and indicates that an ID for that URI + could not be created for whatever reason. However, hosts SHOULD NOT + return 0 from this function in non-exceptional circumstances (i.e. the + URI map SHOULD be dynamic). + + @param handle Must be the callback_data member of this struct. + @param uri The URI to be mapped to an integer ID. + */ + LV2_URID map(const char* uri) { + return this->m_data->map(this->m_data->handle, uri); + } + + /** + Convenience wrapper for calling map(). + */ + LV2_URID operator()(const char* uri) { return map(uri); } +}; + +/** + URI Unmap Feature (LV2_URID__unmap) +*/ +template<bool Required> +class Unmap : public Feature<LV2_URID_Unmap, Required> +{ +public: + Unmap(const LV2_Feature*const* features, + bool* valid) + : Feature<LV2_URID_Map, true>(features, LV2_URID__unmap, valid) + {} + + /** + Get the URI for a previously mapped numeric ID. + + Returns NULL if `urid` is not yet mapped. Otherwise, the corresponding + URI is returned in a canonical form. This MAY not be the exact same + string that was originally passed to LV2_URID_Map::map(), but it MUST be + an identical URI according to the URI syntax specification (RFC3986). A + non-NULL return for a given `urid` will always be the same for the life + of the plugin. Plugins that intend to perform string comparison on + unmapped URIs SHOULD first canonicalise URI strings with a call to + map_uri() followed by a call to unmap_uri(). + + @param handle Must be the callback_data member of this struct. + @param urid The ID to be mapped back to the URI string. + */ + const char* unmap(LV2_URID urid) { + return this->m_data->unmap(this->m_data->handle, urid); + } + + /** + Convenience wrapper for calling unmap(). + */ + const char* operator()(LV2_URID urid) { return unmap(urid); } +}; + +} // namespace urid +} // namespace lv2 + +#endif // LV2_URID_HPP diff --git a/lv2/lv2plug.in/ns/lv2core/Feature.hpp b/lv2/lv2plug.in/ns/lv2core/Feature.hpp new file mode 100644 index 0000000..81be218 --- /dev/null +++ b/lv2/lv2plug.in/ns/lv2core/Feature.hpp @@ -0,0 +1,74 @@ +/* + Copyright 2015 David Robillard <http://drobilla.net> + + Permission to use, copy, modify, and/or distribute this software for any + purpose with or without fee is hereby granted, provided that the above + copyright notice and this permission notice appear in all copies. + + THIS SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES + WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF + MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR + ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN + ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF + OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. +*/ + +#ifndef LV2_FEATURE_HPP +#define LV2_FEATURE_HPP + +#include <string.h> + +#include "lv2/lv2plug.in/ns/lv2core/lv2.h" +#include "lv2/lv2plug.in/ns/ext/urid/urid.h" + +namespace lv2 { + +/** + Feature. + + Features allow hosts to make additional functionality available to plugins + without requiring modification to the LV2 API. Extensions may define new + features and specify the `URI` and `data` to be used if necessary. + Some features, such as lv2:isLive, do not require the host to pass data. +*/ +template<typename Data, bool Required> +class Feature +{ +public: + /** + Initialize feature by retrieving data from the host. + + @param features Feature array passed by the host. + @param uri URI of this feature. + @param valid Set to false iff feature is required but unsupported. + */ + Feature(const LV2_Feature*const* features, + const char* uri, + bool* valid) + : m_data(nullptr) + , m_supported(false) + { + for (const LV2_Feature*const* f = features; *f; ++f) { + if (!strcmp((*f)->URI, uri)) { + m_data = (Data*)(*f)->data; + m_supported = true; + break; + } + } + if (Required && !m_supported) { + *valid = false; + } + } + + Data* data() const { return m_data; } + bool supported() const { return m_supported; } + +protected: + Data* m_data; + bool m_supported; +}; + +} // namespace lv2 + +#endif // LV2_URID_HPP diff --git a/lv2/lv2plug.in/ns/lv2core/Lib.hpp b/lv2/lv2plug.in/ns/lv2core/Lib.hpp new file mode 100644 index 0000000..5d7670b --- /dev/null +++ b/lv2/lv2plug.in/ns/lv2core/Lib.hpp @@ -0,0 +1,81 @@ +/* + Copyright 2015 David Robillard <http://drobilla.net> + + Permission to use, copy, modify, and/or distribute this software for any + purpose with or without fee is hereby granted, provided that the above + copyright notice and this permission notice appear in all copies. + + THIS SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES + WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF + MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR + ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN + ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF + OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. +*/ + +#ifndef LV2_LIB_HPP +#define LV2_LIB_HPP + +#include "lv2/lv2plug.in/ns/lv2core/Plugin.hpp" + +namespace lv2 { + +/** + C++ wrapper for an LV2 plugin library. + + This interface is a convenience for plugin authors only, and is not an ABI + used by hosts. Plugin authors should inherit from this interface, passing + their derived class as the template parameter, and provide an + lv2_lib_descriptor entry point in C: + + @code + class MyLib : public lv2::Lib<MyLib> { ... }; + + LV2_SYMBOL_EXPORT static const LV2_Lib_Descriptor* + lv2_lib_descriptor(const char* bundle_path, + const LV2_Feature *const * features) + { + return new MyLib(bundle_path, features); + } + @endcode +*/ +template<class Derived> +class Lib : public LV2_Lib_Descriptor +{ +public: + /** + Library constructor. + */ + Lib(const char* bundle_path, + const LV2_Feature*const* features) + { + LV2_Lib_Descriptor::handle = this; + LV2_Lib_Descriptor::size = sizeof(LV2_Lib_Descriptor); + LV2_Lib_Descriptor::cleanup = s_cleanup; + LV2_Lib_Descriptor::get_plugin = s_get_plugin; + } + + /** + Plugin accessor, override to return your plugin descriptors. + + Plugins are accessed by index using values from 0 upwards. Out of range + indices MUST result in this function returning NULL, so the host can + enumerate plugins by increasing `index` until NULL is returned. + */ + const LV2_Descriptor* get_plugin(uint32_t index) { return NULL; } + +private: + static void s_cleanup(LV2_Lib_Handle handle) { + delete reinterpret_cast<Derived*>(handle); + } + + static const LV2_Descriptor* s_get_plugin(LV2_Lib_Handle handle, + uint32_t index) { + return reinterpret_cast<Derived*>(handle)->get_plugin(index); + } +}; + +} /* namespace lv2 */ + +#endif /* LV2_LIB_HPP */ diff --git a/lv2/lv2plug.in/ns/lv2core/Plugin.hpp b/lv2/lv2plug.in/ns/lv2core/Plugin.hpp new file mode 100644 index 0000000..f671640 --- /dev/null +++ b/lv2/lv2plug.in/ns/lv2core/Plugin.hpp @@ -0,0 +1,260 @@ +/* + Copyright 2015 David Robillard <http://drobilla.net> + + Permission to use, copy, modify, and/or distribute this software for any + purpose with or without fee is hereby granted, provided that the above + copyright notice and this permission notice appear in all copies. + + THIS SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES + WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF + MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR + ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN + ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF + OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. +*/ + +#ifndef LV2_PLUGIN_HPP +#define LV2_PLUGIN_HPP + +#include "lv2/lv2plug.in/ns/lv2core/lv2.h" + +namespace lv2 { + +/** + C++ interface for writing an LV2 plugin. + + This interface is a convenience for plugin authors only, and is not an ABI + used by hosts. To implement a plugin, inherit from this interface with the + derived class passed as the template parameter. The C LV2_Descriptor for the + plugin can be fetched with descriptor(). + + @code + class MyPlug : public lv2::Plugin<MyPlug> { + // ... + }; + + static const LV2_Descriptor p = MyPlug::descriptor("http://example.org/plug"); + @endcode + + This class is a stateless interface and imposes no restrictions or overhead + compared to a plugin implemented using the underlying C interface. Note + that this is not a virtual class, so calling methods from a Plugin* base + pointer will not work. Instead, anything that must dispatch on Plugin + methods takes a template parameter for static dispatch. + + The destructor will be called when the host cleans up the plugin. +*/ +template<class Derived> +class Plugin +{ +public: + /** + Instantiate the plugin. + + Note that instance initialisation should generally occur in activate() + rather than here. If a host calls instantiate(), it MUST call cleanup() + at some point in the future. + + @param sample_rate Sample rate, in Hz, for the new plugin instance. + + @param bundle_path Path to the LV2 bundle which contains this plugin + binary. It MUST include the trailing directory separator (e.g. '/') so + that simply appending a filename will yield the path to that file in the + bundle. + + @param features A NULL terminated array of LV2_Feature structs which + represent the features the host supports. Plugins may refuse to + instantiate if required features are not found here. However, hosts MUST + NOT use this as a discovery mechanism: instead, use the RDF data to + determine which features are required and do not attempt to instantiate + unsupported plugins at all. This parameter MUST NOT be NULL, i.e. a host + that supports no features MUST pass a single element array containing + NULL. + + @param valid A pointer to a boolean that must be set to true if the + plugin instantiates correctly. The C++ wrappers will free the instance + and return NULL to the host automatically on failure. + + @return A handle for the new plugin instance, or NULL if instantiation + has failed. + */ + Plugin(double sample_rate, + const char* bundle_path, + const LV2_Feature*const* features, + bool* valid) + {} + + /** + Connect a port on a plugin instance to a memory location. + + Plugin writers should be aware that the host may elect to use the same + buffer for more than one port and even use the same buffer for both + input and output (see lv2:inPlaceBroken in lv2.ttl). + + If the plugin has the feature lv2:hardRTCapable then there are various + things that the plugin MUST NOT do within the connect_port() function; + see lv2core.ttl for details. + + connect_port() MUST be called at least once for each port before run() + is called, unless that port is lv2:connectionOptional. The plugin must + pay careful attention to the block size passed to run() since the block + allocated may only just be large enough to contain the data, and is not + guaranteed to remain constant between run() calls. + + connect_port() may be called more than once for a plugin instance to + allow the host to change the buffers that the plugin is reading or + writing. These calls may be made before or after activate() or + deactivate() calls. + + @param port Index of the port to connect. The host MUST NOT try to + connect a port index that is not defined in the plugin's RDF data. If + it does, the plugin's behaviour is undefined (a crash is likely). + + @param data_location Pointer to data of the type defined by the port + type in the plugin's RDF data (e.g. an array of float for an + lv2:AudioPort). This pointer must be stored by the plugin instance and + used to read/write data when run() is called. Data present at the time + of the connect_port() call MUST NOT be considered meaningful. + */ + void connect_port(uint32_t port, void* data_location) {} + + /** + Initialise a plugin instance and activate it for use. + + This is separated from instantiate() to aid real-time support and so + that hosts can reinitialise a plugin instance by calling deactivate() + and then activate(). In this case the plugin instance MUST reset all + state information dependent on the history of the plugin instance except + for any data locations provided by connect_port(). If there is nothing + for activate() to do then this field may be NULL. + + When present, hosts MUST call this function once before run() is called + for the first time. This call SHOULD be made as close to the run() call + as possible and indicates to real-time plugins that they are now live, + however plugins MUST NOT rely on a prompt call to run() after + activate(). + + The host MUST NOT call activate() again until deactivate() has been + called first. If a host calls activate(), it MUST call deactivate() at + some point in the future. Note that connect_port() may be called before + or after activate(). + */ + void activate() {} + + /** + Run a plugin instance for a block. + + Note that if an activate() function exists then it must be called before + run(). If deactivate() is called for a plugin instance then run() may + not be called until activate() has been called again. + + If the plugin has the feature lv2:hardRTCapable then there are various + things that the plugin MUST NOT do within the run() function (see + lv2core.ttl for details). + + As a special case, when `sample_count` is 0, the plugin should update + any output ports that represent a single instant in time (e.g. control + ports, but not audio ports). This is particularly useful for latent + plugins, which should update their latency output port so hosts can + pre-roll plugins to compute latency. Plugins MUST NOT crash when + `sample_count` is 0. + + @param sample_count The block size (in samples) for which the plugin + instance must run. + */ + void run(uint32_t sample_count) {} + + /** + Deactivate a plugin instance (counterpart to activate()). + + Hosts MUST deactivate all activated instances after they have been run() + for the last time. This call SHOULD be made as close to the last run() + call as possible and indicates to real-time plugins that they are no + longer live, however plugins MUST NOT rely on prompt deactivation. If + there is nothing for deactivate() to do then this field may be NULL + + Deactivation is not similar to pausing since the plugin instance will be + reinitialised by activate(). However, deactivate() itself MUST NOT fully + reset plugin state. For example, the host may deactivate a plugin, then + store its state (using some extension to do so). + + Hosts MUST NOT call deactivate() unless activate() was previously + called. Note that connect_port() may be called before or after + deactivate(). + */ + void deactivate() {} + + /** + Return additional plugin data defined by some extenion. + + A typical use of this facility is to return a struct containing function + pointers to extend the LV2_Descriptor API. + + The actual type and meaning of the returned object MUST be specified + precisely by the extension. This function MUST return NULL for any + unsupported URI. If a plugin does not support any extension data, this + field may be NULL. + + The host is never responsible for freeing the returned value. + */ + static const void* extension_data(const char* uri) { return NULL; } + + /** + Get an LV2_Descriptor for a plugin class. + + @code + static const LV2_Descriptor a = lv2::descriptor<Amp>("http://example.org/amp"); + @endcode + */ + static LV2_Descriptor descriptor(const char* uri) { + const LV2_Descriptor desc = { uri, + &s_instantiate, + &s_connect_port, + &s_activate, + &s_run, + &s_deactivate, + &s_cleanup, + &Plugin::extension_data }; + return desc; + } + +private: + static LV2_Handle s_instantiate(const LV2_Descriptor* descriptor, + double rate, + const char* bundle, + const LV2_Feature* const* features) { + bool valid = true; + Derived* instance = new Derived(rate, bundle, features, &valid); + if (!valid) { + delete instance; + return nullptr; + } + return reinterpret_cast<LV2_Handle>(instance); + } + + static void s_connect_port(LV2_Handle instance, uint32_t port, void* buf) { + reinterpret_cast<Derived*>(instance)->connect_port(port, buf); + } + + static void s_activate(LV2_Handle instance) { + reinterpret_cast<Derived*>(instance)->activate(); + } + + static void s_run(LV2_Handle instance, uint32_t sample_count) { + reinterpret_cast<Derived*>(instance)->run(sample_count); + } + + static void s_deactivate(LV2_Handle instance) { + reinterpret_cast<Derived*>(instance)->deactivate(); + } + + static void s_cleanup(LV2_Handle instance) { + delete reinterpret_cast<Derived*>(instance); + } +}; + +} /* namespace lv2 */ + +#endif /* LV2_PLUGIN_HPP */ + diff --git a/plugins/eg-midiamp.lv2/README.txt b/plugins/eg-midiamp.lv2/README.txt new file mode 100644 index 0000000..8a02965 --- /dev/null +++ b/plugins/eg-midiamp.lv2/README.txt @@ -0,0 +1,3 @@ +== MIDI Controlled Amplifier == + +A MIDI controlled amplifier implemented in C++. diff --git a/plugins/eg-midiamp.lv2/manifest.ttl.in b/plugins/eg-midiamp.lv2/manifest.ttl.in new file mode 100644 index 0000000..a40ca8d --- /dev/null +++ b/plugins/eg-midiamp.lv2/manifest.ttl.in @@ -0,0 +1,7 @@ +@prefix lv2: <http://lv2plug.in/ns/lv2core#> . +@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . + +<http://lv2plug.in/plugins/eg-midiamp> + a lv2:Plugin ; + lv2:binary <midiamp@LIB_EXT@> ; + rdfs:seeAlso <midiamp.ttl> . diff --git a/plugins/eg-midiamp.lv2/manifest.ttl.in~949f1baa9a283df26a7238c6bd4bb97272ae1192 b/plugins/eg-midiamp.lv2/manifest.ttl.in~949f1baa9a283df26a7238c6bd4bb97272ae1192 new file mode 100644 index 0000000..a40ca8d --- /dev/null +++ b/plugins/eg-midiamp.lv2/manifest.ttl.in~949f1baa9a283df26a7238c6bd4bb97272ae1192 @@ -0,0 +1,7 @@ +@prefix lv2: <http://lv2plug.in/ns/lv2core#> . +@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . + +<http://lv2plug.in/plugins/eg-midiamp> + a lv2:Plugin ; + lv2:binary <midiamp@LIB_EXT@> ; + rdfs:seeAlso <midiamp.ttl> . diff --git a/plugins/eg-midiamp.lv2/manifest.ttl.in~HEAD b/plugins/eg-midiamp.lv2/manifest.ttl.in~HEAD new file mode 100644 index 0000000..a40ca8d --- /dev/null +++ b/plugins/eg-midiamp.lv2/manifest.ttl.in~HEAD @@ -0,0 +1,7 @@ +@prefix lv2: <http://lv2plug.in/ns/lv2core#> . +@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . + +<http://lv2plug.in/plugins/eg-midiamp> + a lv2:Plugin ; + lv2:binary <midiamp@LIB_EXT@> ; + rdfs:seeAlso <midiamp.ttl> . diff --git a/plugins/eg-midiamp.lv2/midiamp.cpp b/plugins/eg-midiamp.lv2/midiamp.cpp new file mode 100644 index 0000000..2fff4e7 --- /dev/null +++ b/plugins/eg-midiamp.lv2/midiamp.cpp @@ -0,0 +1,128 @@ +/* + Copyright 2015 David Robillard <d@drobilla.net> + + Permission to use, copy, modify, and/or distribute this software for any + purpose with or without fee is hereby granted, provided that the above + copyright notice and this permission notice appear in all copies. + + THIS SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES + WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF + MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR + ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN + ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF + OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. +*/ + +#include <math.h> +#include <stdlib.h> + +#include "lv2/lv2plug.in/ns/ext/atom/atom.hpp" +#include "lv2/lv2plug.in/ns/ext/midi/midi.h" +#include "lv2/lv2plug.in/ns/ext/urid/urid.hpp" +#include "lv2/lv2plug.in/ns/lv2core/Lib.hpp" +#include "lv2/lv2plug.in/ns/lv2core/Plugin.hpp" + +/** MIDI-controlled amplifier. */ +class MidiAmp : public lv2::Plugin<MidiAmp> { +public: + MidiAmp(double rate, + const char* bundle_path, + const LV2_Feature* const* features, + bool* valid) + : Plugin(rate, bundle_path, features, valid) + , m_map(features, valid) + , m_vol(1.0f) + { + if (!*valid) { + return; + } + + midi_MidiEvent = m_map(LV2_MIDI__MidiEvent); + } + + typedef enum { + AMP_CONTROL = 0, + AMP_INPUT = 1, + AMP_OUTPUT = 2 + } PortIndex; + + void connect_port(uint32_t port, void* data) { + switch ((PortIndex)port) { + case AMP_CONTROL: + m_ports.control = (const lv2::atom::Sequence*)data; + break; + case AMP_INPUT: + m_ports.input = (const float*)data; + break; + case AMP_OUTPUT: + m_ports.output = (float*)data; + break; + } + } + + void run(const uint32_t n_samples) { + uint32_t offset = 0; + for (const lv2::atom::Event& ev : *m_ports.control) { + // Emit audio up to this event's time + for (uint32_t o = offset; o < ev.time.frames; ++o) { + m_ports.output[o] = m_ports.input[0] * m_vol; + } + + // Process event + if (ev.type() == midi_MidiEvent) { + const uint8_t* const msg = (const uint8_t*)(&ev + 1); + if (lv2_midi_message_type(msg) == LV2_MIDI_MSG_CONTROLLER && + msg[1] == LV2_MIDI_CTL_MSB_MAIN_VOLUME) { + m_vol = msg[2] / 127.0f; + } + } + + offset = ev.time.frames; + } + + // Emit remaining audio to the end of the block + for (uint32_t o = offset; o < n_samples; ++o) { + m_ports.output[o] = m_ports.input[0] * m_vol; + } + } + +private: + typedef struct { + const lv2::atom::Sequence* control; + const float* input; + float* output; + } Ports; + + lv2::urid::Map<true> m_map; + lv2::urid::URID midi_MidiEvent; + Ports m_ports; + float m_vol; +}; + +/** Plugin library. */ +class MidiAmpLib : public lv2::Lib<MidiAmpLib> +{ +public: + MidiAmpLib(const char* bundle_path, + const LV2_Feature*const* features) + : lv2::Lib<MidiAmpLib>(bundle_path, features) + , m_amp(MidiAmp::descriptor("http://lv2plug.in/plugins/eg-midiamp")) + {} + + const LV2_Descriptor* get_plugin(uint32_t index) { + return index == 0 ? &m_amp : NULL; + } + +private: + LV2_Descriptor m_amp; +}; + +/** Library entry point. */ +LV2_SYMBOL_EXPORT const LV2_Lib_Descriptor* +lv2_lib_descriptor(const char* bundle_path, + const LV2_Feature *const * features) + +{ + return new MidiAmpLib(bundle_path, features); +} diff --git a/plugins/eg-midiamp.lv2/midiamp.ttl b/plugins/eg-midiamp.lv2/midiamp.ttl new file mode 100644 index 0000000..2d985b2 --- /dev/null +++ b/plugins/eg-midiamp.lv2/midiamp.ttl @@ -0,0 +1,35 @@ +@prefix doap: <http://usefulinc.com/ns/doap#> . +@prefix lv2: <http://lv2plug.in/ns/lv2core#> . +@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> . +@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . +@prefix atom: <http://lv2plug.in/ns/ext/atom#> . + +<http://lv2plug.in/plugins/eg-midiamp> + a lv2:Plugin , + lv2:AmplifierPlugin ; + lv2:project <http://lv2plug.in/ns/lv2> ; + doap:name "MIDI Controlled Amplifier" ; + doap:license <http://opensource.org/licenses/isc> ; + lv2:optionalFeature lv2:hardRTCapable ; + lv2:port [ + a lv2:InputPort , + atom:AtomPort ; + atom:bufferType atom:Sequence ; + atom:supports <http://lv2plug.in/ns/ext/midi#MidiEvent> ; + lv2:designation lv2:control ; + lv2:index 0 ; + lv2:symbol "control" ; + lv2:name "Control" + ] , [ + a lv2:AudioPort , + lv2:InputPort ; + lv2:index 1 ; + lv2:symbol "in" ; + lv2:name "In" + ] , [ + a lv2:AudioPort , + lv2:OutputPort ; + lv2:index 2 ; + lv2:symbol "out" ; + lv2:name "Out" + ] . diff --git a/plugins/eg-midiamp.lv2/waf b/plugins/eg-midiamp.lv2/waf new file mode 120000 index 0000000..59a1ac9 --- /dev/null +++ b/plugins/eg-midiamp.lv2/waf @@ -0,0 +1 @@ +../../waf
\ No newline at end of file diff --git a/plugins/eg-midiamp.lv2/wscript b/plugins/eg-midiamp.lv2/wscript new file mode 100644 index 0000000..af0ec06 --- /dev/null +++ b/plugins/eg-midiamp.lv2/wscript @@ -0,0 +1,66 @@ +#!/usr/bin/env python +from waflib.extras import autowaf as autowaf +import re + +# Variables for 'waf dist' +APPNAME = 'eg-midiamp.lv2' +VERSION = '1.0.0' + +# Mandatory variables +top = '.' +out = 'build' + +def options(opt): + opt.load('compiler_cxx') + autowaf.set_options(opt) + +def configure(conf): + conf.load('compiler_cxx') + autowaf.configure(conf) + autowaf.set_c99_mode(conf) + autowaf.display_header('Midiamp Configuration') + + if not autowaf.is_child(): + autowaf.check_pkg(conf, 'lv2', uselib_store='LV2') + + conf.check(features='cxx cxxshlib', lib='m', uselib_store='M', mandatory=False) + + autowaf.display_msg(conf, 'LV2 bundle directory', conf.env.LV2DIR) + print('') + +def build(bld): + bundle = 'eg-midiamp.lv2' + + # Make a pattern for shared objects without the 'lib' prefix + module_pat = re.sub('^lib', '', bld.env.cshlib_PATTERN) + module_ext = module_pat[module_pat.rfind('.'):] + + # Build manifest.ttl by substitution (for portable lib extension) + bld(features = 'subst', + source = 'manifest.ttl.in', + target = '%s/%s' % (bundle, 'manifest.ttl'), + install_path = '${LV2DIR}/%s' % bundle, + LIB_EXT = module_ext) + + # Copy other data files to build bundle (build/eg-midiamp.lv2) + for i in ['midiamp.ttl']: + bld(features = 'subst', + is_copy = True, + source = i, + target = '%s/%s' % (bundle, i), + install_path = '${LV2DIR}/%s' % bundle) + + # Use LV2 headers from parent directory if building as a sub-project + includes = None + if autowaf.is_child: + includes = '../..' + + # Build plugin library + obj = bld(features = 'cxx cxxshlib', + source = 'midiamp.cpp', + name = 'midiamp', + target = '%s/midiamp' % bundle, + install_path = '${LV2DIR}/%s' % bundle, + uselib = 'M LV2', + includes = includes) + obj.env.cxxshlib_PATTERN = module_pat diff --git a/plugins/wscript b/plugins/wscript index f5f6571..94269e4 100644 --- a/plugins/wscript +++ b/plugins/wscript @@ -31,6 +31,14 @@ def build(bld): files += bld.path.ant_glob('%s/*.c' % i) files += bld.path.ant_glob('%s/*.h' % i) + if bld.env.BUILD_CXX: + for i in ['eg-midiamp.lv2']: + print i + files += bld.path.ant_glob('%s/*.txt' % i) + files += bld.path.ant_glob('%s/manifest.ttl*' % i) + files += bld.path.ant_glob('%s/*.ttl' % i) + files += bld.path.ant_glob('%s/*.cpp' % i) + # Compile book sources into book.txt asciidoc source bld(rule = bld_book_src, source = files, @@ -23,6 +23,7 @@ out = 'build' def options(opt): opt.load('compiler_c') + opt.load('compiler_cxx') opt.load('lv2') autowaf.set_options(opt, False, True) opt.add_option('--test', action='store_true', dest='build_tests', @@ -40,6 +41,7 @@ def options(opt): def configure(conf): try: conf.load('compiler_c') + conf.load('compiler_cxx') except: Options.options.build_tests = False Options.options.no_plugins = True @@ -47,6 +49,8 @@ def configure(conf): conf.load('lv2') autowaf.configure(conf) autowaf.set_c99_mode(conf) + conf.check_cxx(cxxflags=["-std=c++0x"]) + conf.env.append_unique('CXXFLAGS', ['-std=c++0x']) if Options.options.online_docs: Options.options.docs = True |