gtk2_ardour/plugin_ui.h

   1 /*
   2     Copyright (C) 2000-2006 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_plugin_ui_h__
  21 #define __ardour_plugin_ui_h__
  22
  23 #ifdef WAF_BUILD
  24 #include "gtk2ardour-config.h"
  25 #endif
  26
  27 #include <vector>
  28 #include <map>
  29 #include <list>
  30
  31 #include <sigc++/signal.h>
  32
  33 #include <gtkmm/button.h>
  34 #include <gtkmm/box.h>
  35 #include <gtkmm/table.h>
  36 #include <gtkmm/eventbox.h>
  37 #include <gtkmm/viewport.h>
  38 #include <gtkmm/scrolledwindow.h>
  39 #include <gtkmm/label.h>
  40 #include <gtkmm/menu.h>
  41 #include <gtkmm/image.h>
  42 #include <gtkmm/adjustment.h>
  43 #include <gtkmm/togglebutton.h>
  44 #include <gtkmm/socket.h>
  45 #include <gtkmm/comboboxtext.h>
  46 #include <gtkmm/socket.h>
  47
  48 #include "ardour/types.h"
  49 #include "ardour/plugin.h"
  50 #include "ardour/variant.h"
  51
  52 #include "automation_controller.h"
  53 #include "ardour_button.h"
  54 #include "ardour_window.h"
  55
  56 namespace ARDOUR {
  57         class PluginInsert;
  58         class Plugin;
  59         class WindowsVSTPlugin;
  60         class LXVSTPlugin;
  61         class IOProcessor;
  62         class AUPlugin;
  63         class Processor;
  64 }
  65
  66 namespace PBD {
  67         class Controllable;
  68 }
  69
  70 namespace Gtkmm2ext {
  71         class HSliderController;
  72         class BarController;
  73         class ClickBox;
  74         class FastMeter;
  75         class PixmapButton;
  76 }
  77
  78 class LatencyGUI;
  79 class ArdourWindow;
  80 class PluginEqGui;
  81
  82 class PlugUIBase : public virtual sigc::trackable, public PBD::ScopedConnectionList
  83 {
  84   public:
  85         PlugUIBase (boost::shared_ptr<ARDOUR::PluginInsert>);
  86         virtual ~PlugUIBase();
  87
  88         virtual gint get_preferred_height () = 0;
  89         virtual gint get_preferred_width () = 0;
  90         virtual bool resizable () { return true; }
  91         virtual bool start_updating(GdkEventAny*) = 0;
  92         virtual bool stop_updating(GdkEventAny*) = 0;
  93
  94         virtual void activate () {}
  95         virtual void deactivate () {}
  96
  97         void update_preset_list ();
  98         void update_preset ();
  99
 100         void latency_button_clicked ();
 101
 102         virtual bool on_window_show(const std::string& /*title*/) { return true; }
 103         virtual void on_window_hide() {}
 104
 105         virtual void forward_key_event (GdkEventKey*) {}
 106         virtual bool non_gtk_gui() const { return false; }
 107
 108         sigc::signal<void,bool> KeyboardFocused;
 109
 110   protected:
 111         boost::shared_ptr<ARDOUR::PluginInsert> insert;
 112         boost::shared_ptr<ARDOUR::Plugin> plugin;
 113
 114         /* UI elements that can subclasses can add to their widgets */
 115
 116         /** a ComboBoxText which lists presets and manages their selection */
 117         Gtk::ComboBoxText _preset_combo;
 118         /** a label which has a * in if the current settings are different from the preset being shown */
 119         Gtk::Label _preset_modified;
 120         /** a button to add a preset */
 121         Gtk::Button add_button;
 122         /** a button to save the current settings as a new user preset */
 123         Gtk::Button save_button;
 124         /** a button to delete the current preset (if it is a user one) */
 125         Gtk::Button delete_button;
 126         /** a button to bypass the plugin */
 127         ArdourButton bypass_button;
 128         /** a button to acquire keyboard focus */
 129         Gtk::EventBox focus_button;
 130         /** an expander containing the plugin description */
 131         Gtk::Expander description_expander;
 132         /** an expander containing the plugin analysis graph */
 133         Gtk::Expander plugin_analysis_expander;
 134         /** a label indicating the plugin latency */
 135         Gtk::Label latency_label;
 136         /** a button which, when clicked, opens the latency GUI */
 137         Gtk::Button latency_button;
 138         /** a button which sets all controls' automation setting to Manual */
 139         Gtk::Button automation_manual_all_button;
 140         /** a button which sets all controls' automation setting to Play */
 141         Gtk::Button automation_play_all_button;
 142     /** a button which sets all controls' automation setting to Write */
 143         Gtk::Button automation_write_all_button;
 144         /** a button which sets all controls' automation setting to Touch */
 145         Gtk::Button automation_touch_all_button;
 146
 147         void set_latency_label ();
 148
 149         LatencyGUI* latency_gui;
 150         ArdourWindow* latency_dialog;
 151
 152         PluginEqGui* eqgui;
 153         Gtk::Requisition pre_eq_size;
 154
 155         Gtk::Image* focus_out_image;
 156         Gtk::Image* focus_in_image;
 157         int _no_load_preset;
 158
 159         virtual void preset_selected ();
 160         void add_plugin_setting ();
 161         void save_plugin_setting ();
 162         void delete_plugin_setting ();
 163         bool focus_toggled(GdkEventButton*);
 164         bool bypass_button_release(GdkEventButton*);
 165         void toggle_description ();
 166         void toggle_plugin_analysis ();
 167         void processor_active_changed (boost::weak_ptr<ARDOUR::Processor> p);
 168         void plugin_going_away ();
 169         virtual void parameter_changed (uint32_t, float);
 170         void preset_added_or_removed ();
 171         void update_preset_modified ();
 172
 173         PBD::ScopedConnection death_connection;
 174         PBD::ScopedConnection active_connection;
 175         PBD::ScopedConnection preset_added_connection;
 176         PBD::ScopedConnection preset_removed_connection;
 177         PBD::ScopedConnectionList control_connections;
 178 };
 179
 180 class GenericPluginUI : public PlugUIBase, public Gtk::VBox
 181 {
 182   public:
 183         GenericPluginUI (boost::shared_ptr<ARDOUR::PluginInsert> plug, bool scrollable=false);
 184         ~GenericPluginUI ();
 185
 186         gint get_preferred_height () { return prefheight; }
 187         gint get_preferred_width () { return -1; }
 188
 189         bool start_updating(GdkEventAny*);
 190         bool stop_updating(GdkEventAny*);
 191
 192   private:
 193         Gtk::VBox main_contents;
 194
 195         Gtk::HBox settings_box;
 196         Gtk::HBox hpacker;
 197
 198         Gtk::Table button_table;
 199         Gtk::Table output_table;
 200
 201         Gtk::ScrolledWindow scroller;
 202         Gtk::Adjustment hAdjustment;
 203         Gtk::Adjustment vAdjustment;
 204         Gtk::Viewport scroller_view;
 205         Gtk::Menu* automation_menu;
 206
 207         gint prefheight;
 208         bool is_scrollable;
 209
 210         struct MeterInfo {
 211                 Gtkmm2ext::FastMeter *meter;
 212
 213                 float           min;
 214                 float           max;
 215                 bool            min_unbound;
 216                 bool            max_unbound;
 217                 bool packed;
 218
 219                 MeterInfo () {
 220                         meter = 0;
 221                         packed = false;
 222                         min = 1.0e10;
 223                         max = -1.0e10;
 224                         min_unbound = false;
 225                         max_unbound = false;
 226                 }
 227         };
 228
 229         static const int32_t initial_button_rows = 12;
 230         static const int32_t initial_button_cols = 1;
 231         static const int32_t initial_output_rows = 1;
 232         static const int32_t initial_output_cols = 4;
 233
 234         /* FIXME: Unify with AutomationController */
 235         struct ControlUI : public Gtk::HBox {
 236
 237                 const Evoral::Parameter parameter() const { return param; }
 238
 239                 Evoral::Parameter                            param;
 240                 boost::shared_ptr<ARDOUR::AutomationControl> control;
 241
 242                 /* input */
 243
 244                 Gtk::ComboBoxText*                      combo;
 245                 boost::shared_ptr<ARDOUR::ScalePoints>  scale_points;
 246                 Gtk::ToggleButton*                      button;
 247                 boost::shared_ptr<AutomationController> controller;
 248                 Gtkmm2ext::ClickBox*                    clickbox;
 249                 Gtk::Label                              label;
 250                 bool                                    update_pending;
 251                 char                                    ignore_change;
 252                 Gtk::Button                             automate_button;
 253                 Gtk::FileChooserButton*                 file_button;
 254
 255                 /* output */
 256
 257                 Gtk::EventBox* display;
 258                 Gtk::Label*    display_label;
 259
 260                 Gtk::HBox*     hbox;
 261                 Gtk::VBox*     vbox;
 262                 MeterInfo*     meterinfo;
 263
 264                 ControlUI (const Evoral::Parameter& param);
 265                 ~ControlUI ();
 266         };
 267
 268         std::vector<ControlUI*>   input_controls;
 269         std::vector<ControlUI*>   output_controls;
 270         sigc::connection screen_update_connection;
 271         void output_update();
 272
 273         void build ();
 274         ControlUI* build_control_ui (const Evoral::Parameter&                     param,
 275                                      const ARDOUR::ParameterDescriptor&           desc,
 276                                      boost::shared_ptr<ARDOUR::AutomationControl> mcontrol,
 277                                      float                                        value,
 278                                      bool                                         is_input);
 279
 280         void ui_parameter_changed (ControlUI* cui);
 281         void toggle_parameter_changed (ControlUI* cui);
 282         void update_control_display (ControlUI* cui);
 283         void control_port_toggled (ControlUI* cui);
 284         void control_combo_changed (ControlUI* cui);
 285
 286         void astate_clicked (ControlUI*);
 287         void automation_state_changed (ControlUI*);
 288         void set_automation_state (ARDOUR::AutoState state, ControlUI* cui);
 289         void start_touch (ControlUI*);
 290         void stop_touch (ControlUI*);
 291         void automation_manual_all(std::vector<ControlUI*>&);
 292         void automation_play_all(std::vector<ControlUI*>&);
 293         void automation_write_all(std::vector<ControlUI*>&);
 294         void automation_touch_all(std::vector<ControlUI*>&);
 295
 296         /* XXX: remove */
 297         void print_parameter (char *buf, uint32_t len, uint32_t param);
 298         bool integer_printer (char* buf, Gtk::Adjustment &, ControlUI *);
 299         bool midinote_printer(char* buf, Gtk::Adjustment &, ControlUI *);
 300
 301         void set_property (const ARDOUR::ParameterDescriptor& desc,
 302                            Gtk::FileChooserButton*            widget);
 303         void property_changed (uint32_t key, const ARDOUR::Variant& value);
 304
 305         typedef std::map<uint32_t, Gtk::FileChooserButton*> PropertyControls;
 306         PropertyControls _property_controls;
 307 };
 308
 309 class PluginUIWindow : public ArdourWindow
 310 {
 311   public:
 312         PluginUIWindow (boost::shared_ptr<ARDOUR::PluginInsert> insert,
 313                         bool scrollable=false,
 314                         bool editor=true);
 315         ~PluginUIWindow ();
 316
 317         PlugUIBase& pluginui() { return *_pluginui; }
 318
 319         void resize_preferred();
 320         void set_parent (Gtk::Window*);
 321         void set_title(const std::string& title);
 322
 323
 324         bool on_key_press_event (GdkEventKey*);
 325         bool on_key_release_event (GdkEventKey*);
 326         void on_show ();
 327         void on_hide ();
 328
 329   private:
 330         std::string _title;
 331         PlugUIBase* _pluginui;
 332         PBD::ScopedConnection death_connection;
 333         Gtk::Window* parent;
 334         Gtk::VBox vbox;
 335         bool was_visible;
 336         bool _keyboard_focused;
 337 #ifdef AUDIOUNIT_SUPPORT
 338         int pre_deactivate_x;
 339         int pre_deactivate_y;
 340 #endif
 341
 342         void keyboard_focused (bool yn);
 343
 344         void app_activated (bool);
 345         void plugin_going_away ();
 346
 347         bool create_windows_vst_editor (boost::shared_ptr<ARDOUR::PluginInsert>);
 348         bool create_lxvst_editor(boost::shared_ptr<ARDOUR::PluginInsert>);
 349         bool create_audiounit_editor (boost::shared_ptr<ARDOUR::PluginInsert>);
 350         bool create_lv2_editor (boost::shared_ptr<ARDOUR::PluginInsert>);
 351 };
 352
 353 #ifdef AUDIOUNIT_SUPPORT
 354 /* this function has to be in a .mm file */
 355 extern PlugUIBase* create_au_gui (boost::shared_ptr<ARDOUR::PluginInsert>, Gtk::VBox**);
 356 #endif
 357
 358 #endif /* __ardour_plugin_ui_h__ */