Prepare central engine check and user notification
[ardour.git] / gtk2_ardour / utils.h
1 /*
2     Copyright (C) 2002 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_gtk_utils_h__
21 #define __ardour_gtk_utils_h__
22
23 #include <string>
24 #include <cmath>
25 #include <vector>
26 #include <map>
27
28 #include "ardour/types.h"
29
30 #include <gdkmm/types.h>
31 #include <gtkmm/menushell.h>
32
33 #include "canvas/types.h"
34
35 namespace PBD {
36         class Controllable;
37         class ScopedConnectionList;
38 }
39
40 namespace Gtk {
41         class Window;
42         class ComboBoxText;
43         class Adjustment;
44 }
45
46 namespace ArdourCanvas {
47         class Item;
48 }
49
50 namespace ARDOUR_UI_UTILS {
51
52 gint   just_hide_it (GdkEventAny*, Gtk::Window*);
53 void add_item_with_sensitivity (Gtk::Menu_Helpers::MenuList &, Gtk::Menu_Helpers::MenuElem, bool);
54
55 /* return 0 (false) if there is no error (engine runs).
56  * otherwise queue an idle user-notificaion and return true.
57  */
58 bool no_engine_notify ();
59
60 unsigned char* xpm2rgb  (const char** xpm, uint32_t& w, uint32_t& h);
61 unsigned char* xpm2rgba (const char** xpm, uint32_t& w, uint32_t& h);
62
63 ArdourCanvas::Points* get_canvas_points (std::string who, uint32_t npoints);
64
65 Pango::FontDescription sanitized_font (std::string const&);
66 Pango::FontDescription get_font_for_style (std::string widgetname);
67
68 void decorate (Gtk::Window& w, Gdk::WMDecoration d);
69
70 Gdk::Color gdk_color_from_rgb (uint32_t);
71 Gdk::Color gdk_color_from_rgba (uint32_t);
72 uint32_t gdk_color_to_rgba (Gdk::Color const&);
73
74 void set_color_from_rgb (Gdk::Color&, uint32_t);
75 void set_color_from_rgba (Gdk::Color&, uint32_t);
76
77 bool relay_key_press (GdkEventKey* ev, Gtk::Window* win);
78 bool key_press_focus_accelerator_handler (Gtk::Window& window, GdkEventKey* ev);
79 bool emulate_key_event (unsigned int);
80
81 Glib::RefPtr<Gdk::Pixbuf> get_xpm (std::string);
82 std::vector<std::string> get_icon_sets ();
83 void get_color_themes (std::map<std::string,std::string>&);
84 std::string get_icon_path (const char*, std::string icon_set = std::string(), bool is_image = true);
85 Glib::RefPtr<Gdk::Pixbuf> get_icon (const char*, std::string icon_set = std::string());
86 static std::map<std::string, Glib::RefPtr<Gdk::Pixbuf> > xpm_map;
87 const char* const *get_xpm_data (std::string path);
88 std::string longest (std::vector<std::string>&);
89 bool key_is_legal_for_numeric_entry (guint keyval);
90
91 void resize_window_to_proportion_of_monitor (Gtk::Window*, int, int);
92
93 std::string escape_underscores (std::string const &);
94
95 Gdk::Color unique_random_color (std::list<Gdk::Color> &);
96
97 std::string rate_as_string (float r);
98
99 bool windows_overlap (Gtk::Window *a, Gtk::Window *b);
100
101 bool overwrite_file_dialog (Gtk::Window& parent, std::string title, std::string text);
102 bool running_from_source_tree ();
103
104 } // namespace
105 #endif /* __ardour_gtk_utils_h__ */