libs/ardour/ardour/control_protocol_manager.h

   1 /*
   2     Copyright (C) 2000-2007 Paul Davis
   3
   4     This program is free software; you can redistribute it and/or modify
   5     it under the terms of the GNU General Public License as published by
   6     the Free Software Foundation; either version 2 of the License, or
   7     (at your option) any later version.
   8
   9     This program is distributed in the hope that it will be useful,
  10     but WITHOUT ANY WARRANTY; without even the implied warranty of
  11     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12     GNU General Public License for more details.
  13
  14     You should have received a copy of the GNU General Public License
  15     along with this program; if not, write to the Free Software
  16     Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  17
  18 */
  19
  20 #ifndef ardour_control_protocol_manager_h
  21 #define ardour_control_protocol_manager_h
  22
  23 #include <string>
  24 #include <list>
  25
  26
  27 #include <glibmm/thread.h>
  28
  29 #include "pbd/stateful.h"
  30 #include "ardour/session_handle.h"
  31
  32 namespace ARDOUR {
  33
  34 class ControlProtocol;
  35 class ControlProtocolDescriptor;
  36 class Session;
  37
  38 struct ControlProtocolInfo {
  39     ControlProtocolDescriptor* descriptor;
  40     ControlProtocol* protocol;
  41     std::string name;
  42     std::string path;
  43     bool requested;
  44     bool mandatory;
  45     bool supports_feedback;
  46     XMLNode* state;
  47
  48     ControlProtocolInfo() : descriptor (0), protocol (0), requested(false),
  49                 mandatory(false), supports_feedback(false), state (0)
  50         {}
  51     ~ControlProtocolInfo() { delete state; }
  52 };
  53
  54 class ControlProtocolManager : public PBD::Stateful, public ARDOUR::SessionHandlePtr
  55 {
  56   public:
  57         ~ControlProtocolManager ();
  58
  59         static ControlProtocolManager& instance();
  60
  61         void set_session (Session*);
  62         void discover_control_protocols ();
  63         void foreach_known_protocol (boost::function<void(const ControlProtocolInfo*)>);
  64         void load_mandatory_protocols ();
  65         void midi_connectivity_established ();
  66
  67         ControlProtocol* instantiate (ControlProtocolInfo&);
  68         int              teardown (ControlProtocolInfo&);
  69
  70         std::list<ControlProtocolInfo*> control_protocol_info;
  71
  72         static const std::string state_node_name;
  73
  74         void set_protocol_states (const XMLNode&);
  75
  76         int set_state (const XMLNode&, int version);
  77         XMLNode& get_state (void);
  78
  79   private:
  80         ControlProtocolManager ();
  81         static ControlProtocolManager* _instance;
  82
  83         Glib::Mutex protocols_lock;
  84         std::list<ControlProtocol*>    control_protocols;
  85
  86         void session_going_away ();
  87
  88         int control_protocol_discover (std::string path);
  89         ControlProtocolDescriptor* get_descriptor (std::string path);
  90         ControlProtocolInfo* cpi_by_name (std::string);
  91 };
  92
  93 } // namespace
  94
  95 #endif // ardour_control_protocol_manager_h