2 Copyright (C) 2010 Paul Davis
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.
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.
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.
24 #include <pangomm/layout.h>
26 #include "pbd/compose.h"
27 #include "pbd/error.h"
28 #include "pbd/stacktrace.h"
30 #include "gtkmm2ext/utils.h"
31 #include "gtkmm2ext/rgb_macros.h"
32 #include "gtkmm2ext/gui_thread.h"
34 #include "ardour/rc_configuration.h" // for widget prelight preference
36 #include "canvas/utils.h"
38 #include "ardour_button.h"
39 #include "ardour_ui.h"
40 #include "global_signals.h"
44 #define REFLECTION_HEIGHT 2
54 ArdourButton::Element ArdourButton::default_elements = ArdourButton::Element (ArdourButton::Edge|ArdourButton::Body|ArdourButton::Text);
55 ArdourButton::Element ArdourButton::led_default_elements = ArdourButton::Element (ArdourButton::default_elements|ArdourButton::Indicator);
56 ArdourButton::Element ArdourButton::just_led_default_elements = ArdourButton::Element (ArdourButton::Edge|ArdourButton::Body|ArdourButton::Indicator);
58 ArdourButton::ArdourButton (Element e)
60 , _tweaks (Tweaks (0))
64 , _corner_radius (4.0)
69 , fill_inactive_color (0)
70 , fill_active_color (0)
71 , text_active_color(0)
72 , text_inactive_color(0)
74 , led_inactive_color(0)
77 , led_inset_pattern (0)
79 , _act_on_release (true)
81 , _fixed_diameter (true)
82 , _distinct_led_click (false)
85 , _fixed_colors_set (false)
86 , _fallthrough_to_parent (false)
88 ARDOUR_UI_UTILS::ColorsChanged.connect (sigc::mem_fun (*this, &ArdourButton::color_handler));
91 ArdourButton::ArdourButton (const std::string& str, Element e)
93 , _tweaks (Tweaks (0))
97 , _corner_radius (4.0)
102 , fill_inactive_color (0)
103 , fill_active_color (0)
104 , text_active_color(0)
105 , text_inactive_color(0)
106 , led_active_color(0)
107 , led_inactive_color(0)
109 , concave_pattern (0)
110 , led_inset_pattern (0)
112 , _act_on_release (true)
114 , _fixed_diameter (true)
115 , _distinct_led_click (false)
118 , _fixed_colors_set (false)
123 ArdourButton::~ArdourButton()
127 if (convex_pattern) {
128 cairo_pattern_destroy (convex_pattern);
131 if (concave_pattern) {
132 cairo_pattern_destroy (concave_pattern);
135 if (led_inset_pattern) {
136 cairo_pattern_destroy (led_inset_pattern);
142 ArdourButton::set_text (const std::string& str)
146 if (!_layout && !_text.empty()) {
147 _layout = Pango::Layout::create (get_pango_context());
151 _layout->set_text (str);
158 ArdourButton::set_markup (const std::string& str)
163 _layout = Pango::Layout::create (get_pango_context());
166 _layout->set_markup (str);
171 ArdourButton::set_angle (const double angle)
177 ArdourButton::set_alignment (const float xa, const float ya)
184 ArdourButton::render (cairo_t* cr, cairo_rectangle_t *)
188 if ( active_state() == Gtkmm2ext::ExplicitActive ) {
189 text_color = text_active_color;
190 led_color = led_active_color;
192 text_color = text_inactive_color;
193 led_color = led_inactive_color;
196 void (*rounded_function)(cairo_t*, double, double, double, double, double);
198 switch (_corner_mask) {
199 case 0x1: /* upper left only */
200 rounded_function = Gtkmm2ext::rounded_top_left_rectangle;
202 case 0x2: /* upper right only */
203 rounded_function = Gtkmm2ext::rounded_top_right_rectangle;
205 case 0x3: /* upper only */
206 rounded_function = Gtkmm2ext::rounded_top_rectangle;
208 /* should really have functions for lower right, lower left,
209 lower only, but for now, we don't
212 rounded_function = Gtkmm2ext::rounded_rectangle;
215 if (!_fixed_diameter) {
216 _diameter = std::min (get_width(), get_height());
219 //border and background fill
220 if ((_elements & Body)==Body) {
221 if (_elements & Edge) {
223 cairo_set_source_rgba (cr, 0, 0, 0, 1);
224 rounded_function(cr, 0, 0, get_width(), get_height(), _corner_radius);
227 rounded_function (cr, 1, 1, get_width()-2, get_height()-2, _corner_radius - 1.5);
229 rounded_function (cr, 0, 0, get_width(), get_height(), _corner_radius);
232 if (active_state() == Gtkmm2ext::ImplicitActive && !((_elements & Indicator)==Indicator)) {
234 ArdourCanvas::set_source_rgba (cr, fill_inactive_color);
238 cairo_set_line_width (cr, 2.0);
239 rounded_function (cr, 2, 2, get_width()-4, get_height()-4, _corner_radius - 1.5);
240 ArdourCanvas::set_source_rgba (cr, fill_active_color);
243 } else if ( (active_state() == Gtkmm2ext::ExplicitActive) && !((_elements & Indicator)==Indicator) ) {
246 ArdourCanvas::set_source_rgba (cr, fill_active_color);
249 } else { //inactive, or it has an indicator
252 ArdourCanvas::set_source_rgba (cr, fill_inactive_color);
258 //show the "convex" or "concave" gradient
259 if (!_flat_buttons) {
260 if ( active_state() == Gtkmm2ext::ExplicitActive && !((_elements & Indicator)==Indicator) ) {
262 float width = get_width(); float height = get_height();
263 cairo_set_source (cr, concave_pattern);
264 Gtkmm2ext::rounded_rectangle (cr, 1, 1, width-2, height-2, _corner_radius - 1.5);
267 float width = get_width(); float height = get_height();
268 cairo_set_source (cr, convex_pattern);
269 Gtkmm2ext::rounded_rectangle (cr, 1, 1, width-2, height-2, _corner_radius - 1.5);
278 x = (get_width() - _pixbuf->get_width())/2.0;
279 y = (get_height() - _pixbuf->get_height())/2.0;
281 //if this is a DropDown with an icon, then we need to
282 //move the icon left slightly to accomomodate the arrow
283 if (((_elements & Menu)==Menu)) {
285 cairo_translate (cr, -8,0 );
289 cairo_rectangle (cr, x+1, y+1, _pixbuf->get_width(), _pixbuf->get_height());
290 gdk_cairo_set_source_pixbuf (cr, _pixbuf->gobj(), x+1, y+1);
293 cairo_rectangle (cr, x, y, _pixbuf->get_width(), _pixbuf->get_height());
294 gdk_cairo_set_source_pixbuf (cr, _pixbuf->gobj(), x, y);
298 //..and then return to our previous drawing position
299 if (((_elements & Menu)==Menu)) {
305 if (get_width() < 75) {
312 if ( !_pixbuf && ((_elements & Text)==Text) && !_text.empty()) {
315 cairo_rectangle (cr, 2, 1, get_width()-4, get_height()-2);
319 ArdourCanvas::set_source_rgba (cr, text_color);
321 if ( (_elements & Menu) == Menu) {
322 cairo_move_to (cr, text_margin, get_height()/2.0 - _text_height/2.0);
323 pango_cairo_show_layout (cr, _layout->gobj());
324 } else if ( (_elements & Indicator) == Indicator) {
326 cairo_move_to (cr, text_margin + _diameter + 4, get_height()/2.0 - _text_height/2.0);
328 cairo_move_to (cr, text_margin, get_height()/2.0 - _text_height/2.0);
330 pango_cairo_show_layout (cr, _layout->gobj());
338 cairo_save (cr); // TODO retain rotataion.. adj. LED,...
339 cairo_rotate(cr, _angle * M_PI / 180.0);
340 cairo_device_to_user(cr, &ww, &wh);
341 xa = (ww - _text_width) * _xalign;
342 ya = (wh - _text_height) * _yalign;
344 /* quick hack for left/bottom alignment at -90deg
345 * TODO this should be generalized incl rotation.
346 * currently only 'user' of this API is meter_strip.cc
348 if (_xalign < 0) xa = (ww * fabs(_xalign) + text_margin);
350 // TODO honor left/right text_margin with min/max()
352 cairo_move_to (cr, xa, ya);
353 pango_cairo_update_layout(cr, _layout->gobj());
354 pango_cairo_show_layout (cr, _layout->gobj());
357 /* use old center'ed layout for follow up items - until rotation/aligment code is completed */
358 cairo_move_to (cr, (get_width() - _text_width)/2.0, get_height()/2.0 - _text_height/2.0);
364 if (((_elements & Menu)==Menu)) {
369 cairo_set_source_rgba (cr, 1, 1, 1, 0.4);
370 cairo_move_to(cr, get_width() - ((_diameter/2.0) + 6.0), get_height()/2.0 +_diameter/4);
371 cairo_rel_line_to(cr, -_diameter/2, -_diameter/2);
372 cairo_rel_line_to(cr, _diameter, 0);
373 cairo_close_path(cr);
374 cairo_set_source_rgba (cr, 1, 1, 1, 0.4);
375 cairo_fill_preserve(cr);
376 cairo_set_source_rgba (cr, 0, 0, 0, 0.8);
377 cairo_set_line_width(cr, 0.5);
384 if (((_elements & Indicator)==Indicator)) {
386 /* move to the center of the indicator/led */
390 if (_elements & Text) {
392 cairo_translate (cr, text_margin + (_diameter/2.0), get_height()/2.0);
394 cairo_translate (cr, get_width() - ((_diameter/2.0) + 4.0), get_height()/2.0);
397 cairo_translate (cr, get_width()/2.0, get_height()/2.0);
401 if (!_flat_buttons) {
402 cairo_arc (cr, 0, 0, _diameter/2, 0, 2 * M_PI);
403 cairo_set_source (cr, led_inset_pattern);
408 cairo_set_source_rgb (cr, 0, 0, 0);
409 cairo_arc (cr, 0, 0, _diameter/2-1, 0, 2 * M_PI);
413 ArdourCanvas::set_source_rgba (cr, led_color);
414 cairo_arc (cr, 0, 0, _diameter/2-3, 0, 2 * M_PI);
421 // a transparent gray layer to indicate insensitivity
422 if ((visual_state() & Gtkmm2ext::Insensitive)) {
423 rounded_function (cr, 1, 1, get_width()-2, get_height()-2, _corner_radius);
424 cairo_set_source_rgba (cr, 0.505, 0.517, 0.525, 0.6);
428 // if requested, show hovering
429 if (ARDOUR::Config->get_widget_prelight()
430 && !((visual_state() & Gtkmm2ext::Insensitive))) {
432 rounded_function (cr, 0, 0, get_width(), get_height(), _corner_radius);
433 cairo_set_source_rgba (cr, 0.905, 0.917, 0.925, 0.2);
438 //user is currently pressing the button. black outline helps to indicate this
439 if ( _grabbed && !((_elements & Menu)==Menu) ) {
440 cairo_set_line_width(cr,1);
441 rounded_function (cr, 1, 1, get_width()-2, get_height()-2, _corner_radius - 1);
442 cairo_set_source_rgba (cr, 0, 0, 0, 1.0);
446 //some buttons (like processor boxes) can be selected (so they can be deleted). Draw a white box around them
447 if (visual_state() & Gtkmm2ext::Selected) {
448 cairo_set_line_width(cr,2);
449 rounded_function (cr, 0, 0, get_width(), get_height(), _corner_radius);
450 cairo_set_source_rgba (cr, 1, 1, 1, 0.75);
454 //I guess this means we have keyboard focus. I don't think this works currently
456 rounded_function (cr, 1.5, 1.5, get_width() - 3, get_height() - 3, _corner_radius);
457 cairo_set_source_rgba (cr, 0.905, 0.917, 0.925, 0.8);
459 cairo_set_dash (cr, &dashes, 1, 0);
460 cairo_set_line_cap (cr, CAIRO_LINE_CAP_BUTT);
461 cairo_set_line_width (cr, 1.0);
463 cairo_set_dash (cr, 0, 0, 0);
468 ArdourButton::set_diameter (float d)
470 _diameter = (d*2) + 5.0;
472 if (_diameter != 0.0) {
473 _fixed_diameter = true;
481 ArdourButton::set_corner_radius (float r)
488 ArdourButton::on_size_request (Gtk::Requisition* req)
493 CairoWidget::on_size_request (req);
495 if ((_elements & Text) && !_text.empty()) {
497 //calc our real width for our string (but ignore the height, because that results in inconsistent button heights)
499 _layout->get_pixel_size (_text_width, ignored);
501 //calc the height using some text with both ascenders and descenders
502 std::string t = _layout->get_text();
503 _layout->set_text ("WjgO"); //what we put here probably doesn't matter, as long as its the same for everyone
504 _layout->get_pixel_size (ignored, _text_height);
505 _layout->set_text (t);
507 if (_text_width + _diameter < 75) {
521 if ((_elements & Indicator) && _fixed_diameter) {
523 req->width = _pixbuf->get_width() + lrint (_diameter) + xpad;
524 req->height = max (_pixbuf->get_height(), (int) lrint (_diameter)) + ypad;
526 req->width = _text_width + lrint (_diameter) + xpad * 2; // margin left+right * 2
527 req->height = max (_text_height, (int) lrint (_diameter)) + ypad;
531 req->width = _pixbuf->get_width() + xpad;
532 req->height = _pixbuf->get_height() + ypad;
534 req->width = _text_width + xpad;
535 req->height = _text_height + ypad;
538 req->width += _corner_radius;
542 * This sets the colors used for rendering based on the name of the button, and
543 * thus uses information from the GUI config data.
546 ArdourButton::set_colors ()
548 if (_fixed_colors_set) {
551 std::string name = get_name();
553 fill_active_color = ARDOUR_UI::config()->color_by_name (string_compose ("%1: fill active", name));
554 fill_inactive_color = ARDOUR_UI::config()->color_by_name (string_compose ("%1: fill", name));
556 text_active_color = ARDOUR_UI::config()->color_by_name (string_compose ("%1: text active", name));
557 text_inactive_color = ARDOUR_UI::config()->color_by_name (string_compose ("%1: text", name));
559 led_active_color = ARDOUR_UI::config()->color_by_name (string_compose ("%1: led active", name));
560 led_inactive_color = ARDOUR_UI::config()->color_by_name (string_compose ("%1: led", name));
563 * This sets the colors used for rendering based on two fixed values, rather
564 * than basing them on the button name, and thus information in the GUI config
567 void ArdourButton::set_fixed_colors (const uint32_t color_active, const uint32_t color_inactive)
569 _fixed_colors_set = true;
571 fill_active_color = color_active;
572 fill_inactive_color = color_inactive;
574 unsigned char r, g, b, a;
575 UINT_TO_RGBA(color_active, &r, &g, &b, &a);
577 double white_contrast = (max (double(r), 255.) - min (double(r), 255.)) +
578 (max (double(g), 255.) - min (double(g), 255.)) +
579 (max (double(b), 255.) - min (double(b), 255.));
581 double black_contrast = (max (double(r), 0.) - min (double(r), 0.)) +
582 (max (double(g), 0.) - min (double(g), 0.)) +
583 (max (double(b), 0.) - min (double(b), 0.));
585 text_active_color = (white_contrast > black_contrast) ?
586 RGBA_TO_UINT(255, 255, 255, 255) : /* use white */
587 RGBA_TO_UINT( 0, 0, 0, 255); /* use black */
590 UINT_TO_RGBA(color_inactive, &r, &g, &b, &a);
592 white_contrast = (max (double(r), 255.) - min (double(r), 255.)) +
593 (max (double(g), 255.) - min (double(g), 255.)) +
594 (max (double(b), 255.) - min (double(b), 255.));
596 black_contrast = (max (double(r), 0.) - min (double(r), 0.)) +
597 (max (double(g), 0.) - min (double(g), 0.)) +
598 (max (double(b), 0.) - min (double(b), 0.));
600 text_inactive_color = (white_contrast > black_contrast) ?
601 RGBA_TO_UINT(255, 255, 255, 255) : /* use white */
602 RGBA_TO_UINT( 0, 0, 0, 255); /* use black */
604 /* XXX what about led colors ? */
607 set_name (""); /* this will trigger a "style-changed" message and then set_colors() */
611 ArdourButton::build_patterns ()
613 if (convex_pattern) {
614 cairo_pattern_destroy (convex_pattern);
618 if (concave_pattern) {
619 cairo_pattern_destroy (concave_pattern);
623 if (led_inset_pattern) {
624 cairo_pattern_destroy (led_inset_pattern);
627 float width = get_width(); float height = get_height();
630 convex_pattern = cairo_pattern_create_linear (0.0, 0, 0.0, height);
631 cairo_pattern_add_color_stop_rgba (convex_pattern, 0.0, 0,0,0, 0.0);
632 cairo_pattern_add_color_stop_rgba (convex_pattern, 1.0, 0,0,0, 0.35);
635 concave_pattern = cairo_pattern_create_linear (0.0, 0, 0.0, height);
636 cairo_pattern_add_color_stop_rgba (concave_pattern, 0.0, 0,0,0, 0.5);
637 cairo_pattern_add_color_stop_rgba (concave_pattern, 0.7, 0,0,0, 0.0);
639 if (_elements & Indicator) {
640 led_inset_pattern = cairo_pattern_create_linear (0.0, 0.0, 0.0, _diameter);
641 cairo_pattern_add_color_stop_rgba (led_inset_pattern, 0, 0,0,0, 0.4);
642 cairo_pattern_add_color_stop_rgba (led_inset_pattern, 1, 1,1,1, 0.7);
649 ArdourButton::set_led_left (bool yn)
655 ArdourButton::on_button_press_event (GdkEventButton *ev)
657 if ((_elements & Indicator) && _led_rect && _distinct_led_click) {
658 if (ev->x >= _led_rect->x && ev->x < _led_rect->x + _led_rect->width &&
659 ev->y >= _led_rect->y && ev->y < _led_rect->y + _led_rect->height) {
664 if (binding_proxy.button_press_handler (ev)) {
671 if (!_act_on_release) {
673 _action->activate ();
678 if (_fallthrough_to_parent)
685 ArdourButton::on_button_release_event (GdkEventButton *ev)
687 if (_hovering && (_elements & Indicator) && _led_rect && _distinct_led_click) {
688 if (ev->x >= _led_rect->x && ev->x < _led_rect->x + _led_rect->width &&
689 ev->y >= _led_rect->y && ev->y < _led_rect->y + _led_rect->height) {
690 signal_led_clicked(); /* EMIT SIGNAL */
700 if (_act_on_release) {
702 _action->activate ();
708 if (_fallthrough_to_parent)
715 ArdourButton::set_distinct_led_click (bool yn)
717 _distinct_led_click = yn;
722 ArdourButton::color_handler ()
730 ArdourButton::on_size_allocate (Allocation& alloc)
732 CairoWidget::on_size_allocate (alloc);
738 ArdourButton::set_controllable (boost::shared_ptr<Controllable> c)
740 watch_connection.disconnect ();
741 binding_proxy.set_controllable (c);
745 ArdourButton::watch ()
747 boost::shared_ptr<Controllable> c (binding_proxy.get_controllable ());
750 warning << _("button cannot watch state of non-existing Controllable\n") << endmsg;
754 c->Changed.connect (watch_connection, invalidator(*this), boost::bind (&ArdourButton::controllable_changed, this), gui_context());
758 ArdourButton::controllable_changed ()
760 float val = binding_proxy.get_controllable()->get_value();
762 if (fabs (val) >= 0.5f) {
763 set_active_state (Gtkmm2ext::ExplicitActive);
765 unset_active_state ();
770 ArdourButton::set_related_action (RefPtr<Action> act)
772 Gtkmm2ext::Activatable::set_related_action (act);
776 action_tooltip_changed ();
778 Glib::RefPtr<ToggleAction> tact = Glib::RefPtr<ToggleAction>::cast_dynamic (_action);
781 tact->signal_toggled().connect (sigc::mem_fun (*this, &ArdourButton::action_toggled));
784 _action->connect_property_changed ("sensitive", sigc::mem_fun (*this, &ArdourButton::action_sensitivity_changed));
785 _action->connect_property_changed ("visible", sigc::mem_fun (*this, &ArdourButton::action_visibility_changed));
786 _action->connect_property_changed ("tooltip", sigc::mem_fun (*this, &ArdourButton::action_tooltip_changed));
791 ArdourButton::action_toggled ()
793 Glib::RefPtr<ToggleAction> tact = Glib::RefPtr<ToggleAction>::cast_dynamic (_action);
796 if (tact->get_active()) {
797 set_active_state (Gtkmm2ext::ExplicitActive);
799 unset_active_state ();
805 ArdourButton::on_style_changed (const RefPtr<Gtk::Style>&)
812 ArdourButton::on_name_changed ()
819 ArdourButton::setup_led_rect ()
823 if (get_width() < 75) {
829 if (_elements & Indicator) {
830 _led_rect = new cairo_rectangle_t;
832 if (_elements & Text) {
834 _led_rect->x = text_margin;
836 _led_rect->x = get_width() - text_margin - _diameter/2.0;
840 _led_rect->x = get_width()/2.0 - _diameter/2.0;
843 _led_rect->y = get_height()/2.0 - _diameter/2.0;
844 _led_rect->width = _diameter;
845 _led_rect->height = _diameter;
854 ArdourButton::set_image (const RefPtr<Gdk::Pixbuf>& img)
861 ArdourButton::set_active_state (Gtkmm2ext::ActiveState s)
863 bool changed = (_active_state != s);
864 CairoWidget::set_active_state (s);
872 ArdourButton::set_visual_state (Gtkmm2ext::VisualState s)
874 bool changed = (_visual_state != s);
875 CairoWidget::set_visual_state (s);
884 ArdourButton::on_focus_in_event (GdkEventFocus* ev)
888 return CairoWidget::on_focus_in_event (ev);
892 ArdourButton::on_focus_out_event (GdkEventFocus* ev)
896 return CairoWidget::on_focus_out_event (ev);
900 ArdourButton::on_key_release_event (GdkEventKey *ev) {
902 (ev->keyval == GDK_KEY_space || ev->keyval == GDK_Return))
906 _action->activate ();
910 return CairoWidget::on_key_release_event (ev);
914 ArdourButton::on_enter_notify_event (GdkEventCrossing* ev)
918 if (ARDOUR::Config->get_widget_prelight()) {
922 return CairoWidget::on_enter_notify_event (ev);
926 ArdourButton::on_leave_notify_event (GdkEventCrossing* ev)
930 if (ARDOUR::Config->get_widget_prelight()) {
934 return CairoWidget::on_leave_notify_event (ev);
938 ArdourButton::set_tweaks (Tweaks t)
947 ArdourButton::action_sensitivity_changed ()
949 if (_action->property_sensitive ()) {
950 set_visual_state (Gtkmm2ext::VisualState (visual_state() & ~Gtkmm2ext::Insensitive));
952 set_visual_state (Gtkmm2ext::VisualState (visual_state() | Gtkmm2ext::Insensitive));
959 ArdourButton::action_visibility_changed ()
961 if (_action->property_visible ()) {
969 ArdourButton::action_tooltip_changed ()
971 string str = _action->property_tooltip().get_value();
972 ARDOUR_UI::instance()->set_tip (*this, str);
976 ArdourButton::set_elements (Element e)
982 ArdourButton::add_elements (Element e)
984 _elements = (ArdourButton::Element) (_elements | e);