lv2_plugin.h

Go to the documentation of this file.

/*
 * Copyright (C) 2008-2016 David Robillard <d@drobilla.net>
 * Copyright (C) 2008-2017 Paul Davis <paul@linuxaudiosystems.com>
 * Copyright (C) 2009-2012 Carl Hetherington <carl@carlh.net>
 * Copyright (C) 2012-2019 Robin Gareus <robin@gareus.org>
 * Copyright (C) 2013 John Emmas <john@creativepost.co.uk>
 * Copyright (C) 2017 Johannes Mueller <github@johannes-mueller.org>
 *
 * 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 program 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 program; if not, write to the Free Software Foundation, Inc.,
 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
 */
 
#ifndef __ardour_lv2_plugin_h__
#define __ardour_lv2_plugin_h__
 
#include <set>
#include <string>
#include <vector>
 
#include "pbd/mutex.h"
#include "pbd/ringbuffer.h"
 
#include "temporal/tempo.h"
 
#include "ardour/plugin.h"
#include "ardour/plugin_scan_result.h"
#include "ardour/uri_map.h"
#include "ardour/worker.h"
 
 
#ifdef LV2_EXTENDED // -> needs to eventually go upstream to lv2plug.in
#include "ardour/lv2_extensions.h"
#endif
 
#ifndef PATH_MAX
#define PATH_MAX 1024
#endif
 
 
namespace ARDOUR {
 
// a callback function for lilv_state_new_from_instance(). friend of LV2Plugin
// so we can pass an LV2Plugin* in user_data and access its private members.
const void* lv2plugin_get_port_value(const char* port_symbol,
                                     void*       user_data,
                                     uint32_t*   size,
                                     uint32_t*   type);
 
class AudioEngine;
class Session;
struct LV2_Evbuf;
 
class LIBARDOUR_API LV2Plugin : public ARDOUR::Plugin, public ARDOUR::Workee
{
  public:
        LV2Plugin (ARDOUR::AudioEngine& engine,
                   ARDOUR::Session&     session,
                   const void*          c_plugin,
                   samplecnt_t          sample_rate);
        LV2Plugin (const LV2Plugin &);
        ~LV2Plugin ();
 
        static bool force_state_save; // to be used only by session-state
 
        std::string unique_id () const;
        const char* uri () const;
        const char* label () const;
        const char* name () const;
        const char* maker () const;
 
        uint32_t    num_ports () const;
        uint32_t    parameter_count () const;
        float       default_value (uint32_t port);
        samplecnt_t max_latency () const;
        void        set_parameter (uint32_t port, float val, sampleoffset_t);
        float       get_parameter (uint32_t port) const;
        std::string get_docs() const;
        std::string get_parameter_docs(uint32_t which) const;
        int         get_parameter_descriptor (uint32_t which, ParameterDescriptor&) const;
        uint32_t    nth_parameter (uint32_t port, bool& ok) const;
 
        IOPortDescription describe_io_port (DataType dt, bool input, uint32_t id) const;
 
        const void* extension_data (const char* uri) const;
 
#ifdef LV2_EXTENDED
        int  setup_export (const char*, LV2_Options_Option const* options = NULL);
        int  finalize_export ();
        bool can_export () const { return _export_interface; }
#endif
 
        const void* c_plugin();
        const void* c_ui();
        const void* c_ui_type();
 
        bool is_external_ui () const;
        bool is_external_kx () const;
        bool ui_is_resizable () const;
 
        const char* port_symbol (uint32_t port) const;
        uint32_t    port_index (const char* symbol) const;
 
        const LV2_Feature* const* features () { return _features; }
 
        std::set<Evoral::Parameter> automatable () const;
        virtual void set_automation_control (uint32_t, std::shared_ptr<AutomationControl>);
 
        void activate ();
        void deactivate ();
        void cleanup ();
 
        int set_block_size (pframes_t);
        bool requires_fixed_sized_buffers () const;
        bool connect_all_audio_outputs () const;
 
        int connect_and_run (BufferSet& bufs,
                             samplepos_t start, samplepos_t end, double speed,
                             ChanMapping const& in, ChanMapping const& out,
                             pframes_t nframes, samplecnt_t offset);
 
        std::string describe_parameter (Evoral::Parameter);
        std::string state_node_name () const { return "lv2"; }
 
        bool parameter_is_audio (uint32_t) const;
        bool parameter_is_control (uint32_t) const;
        bool parameter_is_input (uint32_t) const;
        bool parameter_is_output (uint32_t) const;
        bool parameter_is_toggled (uint32_t) const;
 
        uint32_t designated_bypass_port ();
 
        std::shared_ptr<ScalePoints>
        get_scale_points(uint32_t port_index) const;
 
        void set_insert_id(PBD::ID id);
        void set_state_dir (const std::string& d = "");
 
        int      set_state (const XMLNode& node, int version);
        bool     load_preset (PresetRecord);
        std::string current_preset () const;
 
        bool has_editor () const;
        bool has_message_output () const;
 
        void add_slave (std::shared_ptr<Plugin>, bool);
        void remove_slave (std::shared_ptr<Plugin>);
        void set_non_realtime (bool);
 
        bool write_from_ui(uint32_t       index,
                           uint32_t       protocol,
                           uint32_t       size,
                           const uint8_t* body);
 
        typedef void UIMessageSink(void*       controller,
                                   uint32_t    index,
                                   uint32_t    size,
                                   uint32_t    format,
                                   const void* buffer);
 
        void enable_ui_emission();
        void emit_to_ui(void* controller, UIMessageSink sink);
 
        Worker* worker() { return _worker; }
 
        URIMap&       uri_map()       { return _uri_map; }
        const URIMap& uri_map() const { return _uri_map; }
 
        int work(Worker& worker, uint32_t size, const void* data);
        int work_response(uint32_t size, const void* data);
 
        void                       set_property(uint32_t key, const Variant& value);
        const PropertyDescriptors& get_supported_properties (bool readonly) const {
                return readonly ? _ro_property_descriptors : _property_descriptors;
        }
        const ParameterDescriptor& get_property_descriptor(uint32_t id) const;
        Variant                    get_property_value (uint32_t) const;
        void                       announce_property_values();
 
        /* LV2 Option Options */
        static void set_global_ui_background_color (uint32_t c) {
                _ui_background_color = c;
        }
        static void set_global_ui_foreground_color (uint32_t c) {
                _ui_foreground_color = c;
        }
        static void set_global_ui_contrasting_color (uint32_t c) {
                _ui_contrasting_color = c;
        }
        static void set_global_ui_style_boxy (bool yn) {
                _ui_style_boxy = yn ? 1 : 0;
        }
        static void set_global_ui_style_flat (bool yn) {
                _ui_style_flat = yn ? 1 : 0;
        }
        static void set_main_window_id (unsigned long id) {
                _ui_transient_win_id = id;
        }
 
  private:
        struct Impl;
        Impl*         _impl;
        void*         _module;
        LV2_Feature** _features;
        Worker*       _worker;
        Worker*       _state_worker;
        samplecnt_t   _sample_rate;
        float         _fsample_rate;
        float*        _control_data;
        float*        _shadow_data;
        float*        _defaults;
        LV2_Evbuf**   _ev_buffers;
        LV2_Evbuf**   _atom_ev_buffers;
        float*        _bpm_control_port; 
        float*        _freewheel_control_port; 
        float*        _latency_control_port; 
        samplepos_t   _next_cycle_start; 
        double        _next_cycle_speed; 
        double        _next_cycle_beat;  
        double        _current_bpm;
        double        _prev_time_scale;  
        PBD::ID       _insert_id;
        bool          _non_realtime;
        std::string   _plugin_state_dir;
        uint32_t      _bpm_control_port_index;
        uint32_t      _patch_port_in_index;
        uint32_t      _patch_port_out_index;
        URIMap&       _uri_map;
        bool          _no_sample_accurate_ctrl;
        bool          _connect_all_audio_outputs;
        bool          _can_write_automation;
        samplecnt_t   _max_latency;
        samplecnt_t   _current_latency;
 
        friend const void* lv2plugin_get_port_value(const char* port_symbol,
                                                    void*       user_data,
                                                    uint32_t*   size,
                                                    uint32_t*   type);
 
        typedef enum {
                PORT_INPUT    = 1,       
                PORT_OUTPUT   = 1 << 1,  
                PORT_AUDIO    = 1 << 2,  
                PORT_CONTROL  = 1 << 3,  
                PORT_SEQUENCE = 1 << 5,  
                PORT_MIDI     = 1 << 6,  
                PORT_POSITION = 1 << 7,  
                PORT_PATCHMSG = 1 << 8,  
                PORT_AUTOCTRL = 1 << 9,  
                PORT_CTRLED   = 1 << 10, 
                PORT_CTRLER   = 1 << 11, 
                PORT_NOAUTO   = 1 << 12, 
                PORT_OTHOPT   = 1 << 13  
        } PortFlag;
 
        typedef unsigned PortFlags;
 
        std::vector<PortFlags>         _port_flags;
        std::vector<size_t>            _port_minimumSize;
        std::map<std::string,uint32_t> _port_indices;
 
        std::map<uint32_t, Variant>    _property_values;
 
        PropertyDescriptors _property_descriptors;
        PropertyDescriptors _ro_property_descriptors;
 
        struct AutomationCtrl {
                AutomationCtrl (const AutomationCtrl &other)
                        : ac (other.ac)
                        , guard (other.guard)
                { }
 
                AutomationCtrl (std::shared_ptr<ARDOUR::AutomationControl> c)
                        : ac (c)
                        , guard (false)
                { }
                std::shared_ptr<ARDOUR::AutomationControl> ac;
                bool guard;
        };
 
        typedef std::shared_ptr<AutomationCtrl> AutomationCtrlPtr;
        typedef std::map<uint32_t, AutomationCtrlPtr> AutomationCtrlMap;
        AutomationCtrlMap _ctrl_map;
        AutomationCtrlPtr get_automation_control (uint32_t);
 
        struct UIMessage {
                uint32_t index;
                uint32_t protocol;
                uint32_t size;
        };
 
        bool write_to_ui(uint32_t       index,
                         uint32_t       protocol,
                         uint32_t       size,
                         const uint8_t* body);
 
        bool write_to(PBD::RingBuffer<uint8_t>* dest,
                      uint32_t                  index,
                      uint32_t                  protocol,
                      uint32_t                  size,
                      const uint8_t*            body);
 
        // Created on demand so the space is only consumed if necessary
        PBD::RingBuffer<uint8_t>* _to_ui;
        PBD::RingBuffer<uint8_t>* _from_ui;
 
        PBD::Mutex _work_mutex;
 
        PBD::Mutex                   _slave_lock;
        std::set<std::shared_ptr<LV2Plugin>> _slaves;
 
#ifdef LV2_EXTENDED
        static void queue_draw (LV2_Inline_Display_Handle);
        static void midnam_update (LV2_Midnam_Handle);
        static void bankpatch_notify (LV2_BankPatch_Handle, uint8_t, uint32_t, uint8_t);
 
        bool _inline_display_in_gui;
        const LV2_Inline_Display_Interface* _display_interface;
        const LV2_Midnam_Interface* _midname_interface;
        const LV2_Export_Interface* _export_interface;
 
        uint32_t _bankpatch[16];
        bool seen_bankpatch;
        bool knows_bank_patch () { return seen_bankpatch; }
        uint32_t bank_patch (uint8_t chn) {
                assert (chn < 16);
                if (chn > 15) return UINT32_MAX;
                return _bankpatch[chn];
        }
#endif
 
        typedef struct {
                const void* (*extension_data) (const char* uri);
        } LV2_DataAccess;
 
        LV2_DataAccess _data_access_extension_data;
        LV2_Feature    _data_access_feature;
        LV2_Feature    _instance_access_feature;
        LV2_Feature    _make_path_feature;
        LV2_Feature    _log_feature;
        LV2_Feature    _work_schedule_feature;
        LV2_Feature    _options_feature;
        LV2_Feature    _def_state_feature;
        LV2_Feature    _block_length_feature;
#ifdef LV2_EXTENDED
        LV2_Feature    _queue_draw_feature;
        LV2_Feature    _midnam_feature;
        LV2_Feature    _bankpatch_feature;
#endif
 
        // Options passed to plugin
        int32_t              _seq_size;
        static int32_t       _ui_style_flat;
        static int32_t       _ui_style_boxy;
        static uint32_t      _ui_background_color;
        static uint32_t      _ui_foreground_color;
        static uint32_t      _ui_contrasting_color;
        static unsigned long _ui_transient_win_id;
        static float         _ui_update_hz;
 
        mutable unsigned _state_version;
 
        bool _was_activated;
        bool _has_state_interface;
 
        const std::string plugin_dir () const;
        const std::string scratch_dir () const;
        const std::string file_dir () const;
        const std::string state_dir (unsigned num) const;
 
        static char* lv2_state_make_path (void*       host_data,
                                          const char* path);
 
        void init (const void* c_plugin, samplecnt_t rate);
        void allocate_atom_event_buffers ();
        void run (pframes_t nsamples, bool sync_work = false);
 
        void load_supported_properties(PropertyDescriptors& descs, bool writable);
 
#ifdef LV2_EXTENDED
        bool has_inline_display ();
        bool inline_display_in_gui ();
        Plugin::Display_Image_Surface* render_inline_display (uint32_t, uint32_t);
 
        bool has_midnam ();
        bool read_midnam ();
        std::string midnam_model ();
        bool _midnam_dirty;
#endif
 
        samplecnt_t plugin_latency () const;
 
        void latency_compute_run ();
        std::string do_save_preset (std::string);
        void do_remove_preset (std::string);
        void find_presets ();
        void add_state (XMLNode *) const;
 
        Temporal::GridIterator grid_iterator;
};
 
 
class LIBARDOUR_API LV2PluginInfo : public PluginInfo , public std::enable_shared_from_this<ARDOUR::LV2PluginInfo> {
public:
        LV2PluginInfo (const char* plugin_uri);
        ~LV2PluginInfo ();
 
        static PluginInfoList* discover (std::function <void (std::string const&, PluginScanLogEntry::PluginScanResult, std::string const&, bool)> cb);
 
        PluginPtr load (Session& session);
        std::vector<Plugin::PresetRecord> get_presets (bool user_only) const;
 
        bool is_instrument () const;
        bool is_utility () const;
        bool is_analyzer () const;
 
        char * _plugin_uri;
 
private:
        bool _is_instrument;
        bool _is_utility;
        bool _is_analyzer;
};
 
typedef std::shared_ptr<LV2PluginInfo> LV2PluginInfoPtr;
 
} // namespace ARDOUR
 
#endif /* __ardour_lv2_plugin_h__ */