merge with master.
[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
27 #include "ardour/types.h"
28
29 #include <gdkmm/types.h>
30 #include <gtkmm/menushell.h>
31
32 #include "canvas/types.h"
33
34 namespace PBD {
35         class Controllable;
36         class ScopedConnectionList;
37 }
38
39 namespace Gtk {
40         class Window;
41         class ComboBoxText;
42         class Paned;
43         class Adjustment;
44 }
45
46 namespace ArdourCanvas {
47         class Item;
48 }
49
50 namespace ARDOUR_UI_UTILS {
51
52 extern sigc::signal<void>  DPIReset;
53
54 gint   just_hide_it (GdkEventAny*, Gtk::Window*);
55 void add_item_with_sensitivity (Gtk::Menu_Helpers::MenuList &, Gtk::Menu_Helpers::MenuElem, bool);
56
57 unsigned char* xpm2rgb  (const char** xpm, uint32_t& w, uint32_t& h);
58 unsigned char* xpm2rgba (const char** xpm, uint32_t& w, uint32_t& h);
59
60 ArdourCanvas::Points* get_canvas_points (std::string who, uint32_t npoints);
61
62 Pango::FontDescription sanitized_font (std::string const&);
63 Pango::FontDescription get_font_for_style (std::string widgetname);
64
65 uint32_t rgba_from_style (std::string, uint32_t, uint32_t, uint32_t, uint32_t, std::string = "fg", int = Gtk::STATE_NORMAL, bool = true);
66
67 bool rgba_p_from_style (std::string, float*, float*, float*, std::string = "fg", int = Gtk::STATE_NORMAL);
68
69 void decorate (Gtk::Window& w, Gdk::WMDecoration d);
70
71 void set_color_from_rgb (Gdk::Color&, uint32_t);
72 void set_color_from_rgba (Gdk::Color&, uint32_t);
73 uint32_t gdk_color_to_rgba (Gdk::Color const&);
74 uint32_t contrasting_text_color (uint32_t c);
75
76 bool relay_key_press (GdkEventKey* ev, Gtk::Window* win);
77 bool forward_key_press (GdkEventKey* ev);
78 bool key_press_focus_accelerator_handler (Gtk::Window& window, GdkEventKey* ev);
79 bool emulate_key_event (Gtk::Widget*, unsigned int);
80
81 Glib::RefPtr<Gdk::Pixbuf> get_xpm (std::string);
82 std::vector<std::string> get_icon_sets ();
83 std::string get_icon_path (const char*, std::string icon_set = std::string());
84 Glib::RefPtr<Gdk::Pixbuf> get_icon (const char*, std::string icon_set = std::string());
85 static std::map<std::string, Glib::RefPtr<Gdk::Pixbuf> > xpm_map;
86 const char* const *get_xpm_data (std::string path);
87 std::string longest (std::vector<std::string>&);
88 bool key_is_legal_for_numeric_entry (guint keyval);
89 void reset_dpi ();
90 void set_pango_fontsize ();
91
92 void resize_window_to_proportion_of_monitor (Gtk::Window*, int, int);
93
94 std::string escape_underscores (std::string const &);
95 std::string escape_angled_brackets (std::string const &);
96
97 Gdk::Color unique_random_color (std::list<Gdk::Color> &);
98
99 std::string rate_as_string (float r);
100
101 std::string track_number_to_string (int64_t tracknumber, std::string sep = "", std::string postfix = "");
102
103 } // namespace
104 #endif /* __ardour_gtk_utils_h__ */