add Gtkmm2ext::event_type_string()
[ardour.git] / libs / gtkmm2ext / utils.cc
index 4e45cdb8b7975646c4626d5d606279daa8181ad4..4c85f1928de5d74d203ab1a1da69752f87882db8 100644 (file)
 #include <gtk/gtkpaned.h>
 #include <gtk/gtk.h>
 
-#include <gtkmm2ext/utils.h>
 #include <gtkmm/widget.h>
 #include <gtkmm/button.h>
 #include <gtkmm/window.h>
 #include <gtkmm/paned.h>
+#include <gtkmm/label.h>
 #include <gtkmm/comboboxtext.h>
+#include <gtkmm/tooltip.h>
+
+#include "gtkmm2ext/utils.h"
 
 #include "i18n.h"
 
 using namespace std;
 
+void
+Gtkmm2ext::init (const char* localedir)
+{
+#ifdef ENABLE_NLS
+       (void) bindtextdomain(PACKAGE, localedir);
+#endif
+}
+
 void
 Gtkmm2ext::get_ink_pixel_size (Glib::RefPtr<Pango::Layout> layout,
                               int& width,
@@ -46,9 +57,9 @@ Gtkmm2ext::get_ink_pixel_size (Glib::RefPtr<Pango::Layout> layout,
 }
 
 void
-get_pixel_size (Glib::RefPtr<Pango::Layout> layout,
-                              int& width,
-                              int& height)
+Gtkmm2ext::get_pixel_size (Glib::RefPtr<Pango::Layout> layout,
+                          int& width,
+                          int& height)
 {
        layout->get_pixel_size (width, height);
 }
@@ -56,7 +67,6 @@ get_pixel_size (Glib::RefPtr<Pango::Layout> layout,
 void
 Gtkmm2ext::set_size_request_to_display_given_text (Gtk::Widget &w, const gchar *text,
                                                   gint hpadding, gint vpadding)
-       
 {
        int width, height;
        w.ensure_style ();
@@ -69,58 +79,155 @@ void
 Gtkmm2ext::set_size_request_to_display_given_text (Gtk::Widget &w, 
                                                   const std::vector<std::string>& strings,
                                                   gint hpadding, gint vpadding)
-       
 {
        int width, height;
        int width_max = 0;
        int height_max = 0;
        w.ensure_style ();
+        vector<string> copy;
+        const vector<string>* to_use;
+        vector<string>::const_iterator i;
+
+        for (i = strings.begin(); i != strings.end(); ++i) {
+                if ((*i).find_first_of ("gy") != string::npos) {
+                        /* contains a descender */
+                        break;
+                }
+        }
        
-       for (vector<string>::const_iterator i = strings.begin(); i != strings.end(); ++i) {
+        if (i == strings.end()) {
+                /* make a copy of the strings then add one that has a descender */
+                copy = strings;
+                copy.push_back ("g");
+                to_use = &copy;
+        } else {
+                to_use = &strings;
+        }
+       
+       for (vector<string>::const_iterator i = to_use->begin(); i != to_use->end(); ++i) {
                get_pixel_size (w.create_pango_layout (*i), width, height);
                width_max = max(width_max,width);
                height_max = max(height_max, height);
        }
+
        w.set_size_request(width_max + hpadding, height_max + vpadding);
 }
 
-void
-Gtkmm2ext::init ()
+static inline guint8
+demultiply_alpha (guint8 src,
+                  guint8 alpha)
 {
-       // Necessary for gettext
-       (void) bindtextdomain(PACKAGE, LOCALEDIR);
+        /* cairo pixel buffer data contains RGB values with the alpha
+           values premultiplied.
+
+           GdkPixbuf pixel buffer data contains RGB values without the
+           alpha value applied.
+
+           this removes the alpha component from the cairo version and
+           returns the GdkPixbuf version.
+        */
+       return alpha ? ((guint (src) << 8) - src) / alpha : 0;
 }
 
 void
-Gtkmm2ext::set_popdown_strings (Gtk::ComboBoxText& cr, const vector<string>& strings, bool set_size, gint hpadding, gint vpadding)
+Gtkmm2ext::convert_bgra_to_rgba (guint8 const* src,
+                                guint8*       dst,
+                                int           width,
+                                int           height)
 {
-       vector<string>::const_iterator i;
-
-       cr.clear ();
-
-       if (set_size) {
-               vector<string> copy;
+       guint8 const* src_pixel = src;
+       guint8*       dst_pixel = dst;
+       
+        /* cairo pixel data is endian-dependent ARGB with A in the most significant 8 bits,
+           with premultipled alpha values (see preceding function)
+
+           GdkPixbuf pixel data is non-endian-dependent RGBA with R in the lowest addressable
+           8 bits, and non-premultiplied alpha values.
+
+           convert from the cairo values to the GdkPixbuf ones.
+        */
+
+       for (int y = 0; y < height; y++) {
+                for (int x = 0; x < width; x++) {
+#if G_BYTE_ORDER == G_LITTLE_ENDIAN
+                        /* Cairo [ B G R A ] is actually  [ B G R A ] in memory SOURCE
+                                                            0 1 2 3
+                           Pixbuf [ R G B A ] is actually [ R G B A ] in memory DEST
+                        */
+                        dst_pixel[0] = demultiply_alpha (src_pixel[2],
+                                                         src_pixel[3]); // R [0] <= [ 2 ]
+                        dst_pixel[1] = demultiply_alpha (src_pixel[1],
+                                                         src_pixel[3]); // G [1] <= [ 1 ]
+                        dst_pixel[2] = demultiply_alpha (src_pixel[0],  
+                                                         src_pixel[3]); // B [2] <= [ 0 ]
+                        dst_pixel[3] = src_pixel[3]; // alpha
+                        
+#elif G_BYTE_ORDER == G_BIG_ENDIAN
+                        /* Cairo [ B G R A ] is actually  [ A R G B ] in memory SOURCE
+                                                            0 1 2 3
+                           Pixbuf [ R G B A ] is actually [ R G B A ] in memory DEST
+                        */
+                        dst_pixel[0] = demultiply_alpha (src_pixel[1],
+                                                         src_pixel[0]); // R [0] <= [ 1 ]
+                        dst_pixel[1] = demultiply_alpha (src_pixel[2],
+                                                         src_pixel[0]); // G [1] <= [ 2 ]
+                        dst_pixel[2] = demultiply_alpha (src_pixel[3],
+                                                         src_pixel[0]); // B [2] <= [ 3 ]
+                        dst_pixel[3] = src_pixel[0]; // alpha
+                        
+#else
+#error ardour does not currently support PDP-endianess
+#endif                 
+                        
+                        dst_pixel += 4;
+                        src_pixel += 4;
+                }
+       }
+}
 
-               for (i = strings.begin(); i != strings.end(); ++i) {
-                       if ((*i).find_first_of ("gy") != string::npos) {
-                               /* contains a descender */
-                               break;
-                       }
-               }
-               
-               if (i == strings.end()) {
-                       
-                       /* make a copy of the strings then add one that has a descener */
-                       
-                       copy = strings;
-                       copy.push_back ("g");
-                       set_size_request_to_display_given_text (cr, copy, COMBO_FUDGE+10+hpadding, 15+vpadding); 
+Glib::RefPtr<Gdk::Pixbuf>
+Gtkmm2ext::pixbuf_from_string(const string& name, const Pango::FontDescription& font, int clip_width, int clip_height, Gdk::Color fg)
+{
+       static Glib::RefPtr<Gdk::Pixbuf>* empty_pixbuf = 0;
 
-               } else {
-                       set_size_request_to_display_given_text (cr, strings, COMBO_FUDGE+10+hpadding, 15+vpadding); 
+       if (name.empty()) {
+               if (empty_pixbuf == 0) {
+                       empty_pixbuf = new Glib::RefPtr<Gdk::Pixbuf>;
+                       *empty_pixbuf = Gdk::Pixbuf::create(Gdk::COLORSPACE_RGB, true, 8, clip_width, clip_height);
                }
+               return *empty_pixbuf;
        }
 
+       Glib::RefPtr<Gdk::Pixbuf> buf = Gdk::Pixbuf::create(Gdk::COLORSPACE_RGB, true, 8, clip_width, clip_height);
+
+       cairo_surface_t* surface = cairo_image_surface_create(CAIRO_FORMAT_ARGB32, clip_width, clip_height);
+       cairo_t* cr = cairo_create (surface);
+       cairo_text_extents_t te;
+       
+       cairo_set_source_rgba (cr, fg.get_red_p(), fg.get_green_p(), fg.get_blue_p(), 1.0);
+       cairo_select_font_face (cr, font.get_family().c_str(),
+                               CAIRO_FONT_SLANT_NORMAL, CAIRO_FONT_WEIGHT_NORMAL);
+       cairo_set_font_size (cr,  font.get_size() / Pango::SCALE);
+       cairo_text_extents (cr, name.c_str(), &te);
+       
+       cairo_move_to (cr, 0.5, int (0.5 - te.height / 2 - te.y_bearing + clip_height / 2));
+       cairo_show_text (cr, name.c_str());
+       
+       convert_bgra_to_rgba(cairo_image_surface_get_data (surface), buf->get_pixels(), clip_width, clip_height);
+
+       cairo_destroy(cr);
+       cairo_surface_destroy(surface);
+
+       return buf;
+}
+
+void
+Gtkmm2ext::set_popdown_strings (Gtk::ComboBoxText& cr, const vector<string>& strings)
+{
+       vector<string>::const_iterator i;
+
+       cr.clear ();
+
        for (i = strings.begin(); i != strings.end(); ++i) {
                cr.append_text (*i);
        }
@@ -239,3 +346,422 @@ Gtkmm2ext::possibly_translate_legal_accelerator_to_real_key (uint32_t keyval)
        return keyval;
 }
 
+int
+Gtkmm2ext::physical_screen_height (Glib::RefPtr<Gdk::Window> win)
+{
+        GdkScreen* scr = gdk_screen_get_default();
+
+        if (win) {
+                GdkRectangle r;
+                gint monitor = gdk_screen_get_monitor_at_window (scr, win->gobj());
+                gdk_screen_get_monitor_geometry (scr, monitor, &r);
+                return r.height;
+        } else {
+                return gdk_screen_get_height (scr);
+        }
+}
+
+int
+Gtkmm2ext::physical_screen_width (Glib::RefPtr<Gdk::Window> win)
+{
+        GdkScreen* scr = gdk_screen_get_default();
+        
+        if (win) {
+                GdkRectangle r;
+                gint monitor = gdk_screen_get_monitor_at_window (scr, win->gobj());
+                gdk_screen_get_monitor_geometry (scr, monitor, &r);
+                return r.width;
+        } else {
+                return gdk_screen_get_width (scr);
+        }
+}
+
+void
+Gtkmm2ext::container_clear (Gtk::Container& c)
+{
+        list<Gtk::Widget*> children = c.get_children();
+        for (list<Gtk::Widget*>::iterator child = children.begin(); child != children.end(); ++child) {
+                c.remove (**child);
+        }
+}
+
+void
+Gtkmm2ext::rounded_rectangle (Cairo::RefPtr<Cairo::Context> context, double x, double y, double w, double h, double r)
+{
+       rounded_rectangle (context->cobj(), x, y, w, h, r);
+}
+void
+Gtkmm2ext::rounded_top_rectangle (Cairo::RefPtr<Cairo::Context> context, double x, double y, double w, double h, double r)
+{
+       rounded_top_rectangle (context->cobj(), x, y, w, h, r);
+}
+void
+Gtkmm2ext::rounded_top_left_rectangle (Cairo::RefPtr<Cairo::Context> context, double x, double y, double w, double h, double r)
+{
+       rounded_top_left_rectangle (context->cobj(), x, y, w, h, r);
+}
+void
+Gtkmm2ext::rounded_top_right_rectangle (Cairo::RefPtr<Cairo::Context> context, double x, double y, double w, double h, double r)
+{
+       rounded_top_right_rectangle (context->cobj(), x, y, w, h, r);
+}
+void
+Gtkmm2ext::rounded_top_half_rectangle (Cairo::RefPtr<Cairo::Context> context, double x, double y, double w, double h, double r)
+{
+       rounded_top_half_rectangle (context->cobj(), x, y, w, h, r);
+}
+void
+Gtkmm2ext::rounded_bottom_half_rectangle (Cairo::RefPtr<Cairo::Context> context, double x, double y, double w, double h, double r)
+{
+       rounded_bottom_half_rectangle (context->cobj(), x, y, w, h, r);
+}
+
+void
+Gtkmm2ext::rounded_left_half_rectangle (Cairo::RefPtr<Cairo::Context> context, double x, double y, double w, double h, double r)
+{
+       rounded_left_half_rectangle (context->cobj(), x, y, w, h, r);
+}
+
+void
+Gtkmm2ext::rounded_right_half_rectangle (Cairo::RefPtr<Cairo::Context> context, double x, double y, double w, double h, double r)
+{
+       rounded_right_half_rectangle (context->cobj(), x, y, w, h, r);
+}
+
+void
+Gtkmm2ext::rounded_rectangle (cairo_t* cr, double x, double y, double w, double h, double r)
+{
+       double degrees = M_PI / 180.0;
+
+       cairo_new_sub_path (cr);
+       cairo_arc (cr, x + w - r, y + r, r, -90 * degrees, 0 * degrees);  //tr
+       cairo_arc (cr, x + w - r, y + h - r, r, 0 * degrees, 90 * degrees);  //br
+       cairo_arc (cr, x + r, y + h - r, r, 90 * degrees, 180 * degrees);  //bl
+       cairo_arc (cr, x + r, y + r, r, 180 * degrees, 270 * degrees);  //tl
+       cairo_close_path (cr);
+}
+
+void
+Gtkmm2ext::rounded_left_half_rectangle (cairo_t* cr, double x, double y, double w, double h, double r)
+{
+       double degrees = M_PI / 180.0;
+
+       cairo_new_sub_path (cr);
+       cairo_line_to (cr, x+w, y); // tr
+       cairo_line_to (cr, x+w, y + h); // br
+       cairo_arc (cr, x + r, y + h - r, r, 90 * degrees, 180 * degrees);  //bl
+       cairo_arc (cr, x + r, y + r, r, 180 * degrees, 270 * degrees);  //tl
+       cairo_close_path (cr);
+}
+
+void
+Gtkmm2ext::rounded_right_half_rectangle (cairo_t* cr, double x, double y, double w, double h, double r)
+{
+       double degrees = M_PI / 180.0;
+
+       cairo_new_sub_path (cr);
+       cairo_arc (cr, x + w - r, y + r, r, -90 * degrees, 0 * degrees);  //tr
+       cairo_arc (cr, x + w - r, y + h - r, r, 0 * degrees, 90 * degrees);  //br
+       cairo_line_to (cr, x, y + h); // bl
+       cairo_line_to (cr, x, y); // tl
+       cairo_close_path (cr);
+}
+
+void
+Gtkmm2ext::rounded_top_half_rectangle (cairo_t* cr, double x, double y, double w, double h, double r)
+{
+       double degrees = M_PI / 180.0;
+
+       cairo_new_sub_path (cr);
+       cairo_move_to (cr, x+w, y+h);
+       cairo_line_to (cr, x, y+h);
+       cairo_arc (cr, x + r, y + r, r, 180 * degrees, 270 * degrees);  //tl
+       cairo_arc (cr, x + w - r, y + r, r, -90 * degrees, 0 * degrees);  //tr
+       cairo_close_path (cr);
+}
+
+void
+Gtkmm2ext::rounded_bottom_half_rectangle (cairo_t* cr, double x, double y, double w, double h, double r)
+{
+       double degrees = M_PI / 180.0;
+
+       cairo_new_sub_path (cr);
+       cairo_move_to (cr, x, y);
+       cairo_line_to (cr, x+w, y);
+       cairo_arc (cr, x + w - r, y + h - r, r, 0 * degrees, 90 * degrees);  //br
+       cairo_arc (cr, x + r, y + h - r, r, 90 * degrees, 180 * degrees);  //bl
+       cairo_close_path (cr);
+}
+
+
+void
+Gtkmm2ext::rounded_top_rectangle (cairo_t* cr, double x, double y, double w, double h, double r)
+{
+       double degrees = M_PI / 180.0;
+
+       cairo_new_sub_path (cr);
+       cairo_move_to (cr, x+w, y+h);
+       cairo_line_to (cr, x, y+h);
+       cairo_arc (cr, x + r, y + r, r, 180 * degrees, 270 * degrees);  //tl
+       cairo_arc (cr, x + w - r, y + r, r, -90 * degrees, 0 * degrees);  //tr
+       cairo_close_path (cr);
+}
+
+void
+Gtkmm2ext::rounded_top_left_rectangle (cairo_t* cr, double x, double y, double w, double h, double r)
+{
+/*    A****B
+      H    *
+      *    *
+      *    *
+      F****E
+*/
+       cairo_move_to (cr, x+r,y); // Move to A
+       cairo_line_to (cr, x+w,y); // Straight line to B
+       cairo_line_to (cr, x+w,y+h); // Move to E
+       cairo_line_to (cr, x,y+h); // Line to F
+       cairo_line_to (cr, x,y+r); // Line to H
+       cairo_curve_to (cr, x,y,x,y,x+r,y); // Curve to A
+}
+
+void
+Gtkmm2ext::rounded_top_right_rectangle (cairo_t* cr, double x, double y, double w, double h, double r)
+{
+/*    A****BQ
+      *    C
+      *    *
+      *    *
+      F****E
+*/
+       cairo_move_to (cr, x,y); // Move to A
+       cairo_line_to (cr, x+w-r,y); // Straight line to B
+       cairo_curve_to (cr, x+w,y,x+w,y,x+w,y+r); // Curve to C, Control points are both at Q
+       cairo_line_to (cr, x+w,y+h); // Move to E
+       cairo_line_to (cr, x,y+h); // Line to F
+       cairo_line_to (cr, x,y); // Line to A
+}
+
+Glib::RefPtr<Gdk::Window>
+Gtkmm2ext::window_to_draw_on (Gtk::Widget& w, Gtk::Widget** parent)
+{
+       if (w.get_has_window()) {
+               return w.get_window();
+       }
+
+       (*parent) = w.get_parent();
+
+       while (*parent) {
+               if ((*parent)->get_has_window()) {
+                       return (*parent)->get_window ();
+               }
+               (*parent) = (*parent)->get_parent ();
+       }
+
+       return Glib::RefPtr<Gdk::Window> ();
+}
+
+int
+Gtkmm2ext::pixel_width (const string& str, Pango::FontDescription& font)
+{
+       Gtk::Label foo;
+       Glib::RefPtr<Pango::Layout> layout = foo.create_pango_layout ("");
+
+       layout->set_font_description (font);
+       layout->set_text (str);
+
+       int width, height;
+       Gtkmm2ext::get_ink_pixel_size (layout, width, height);
+       return width;
+}
+
+#if 0
+string
+Gtkmm2ext::fit_to_pixels (const string& str, int pixel_width, Pango::FontDescription& font, int& actual_width, bool with_ellipses)
+{
+       /* DECEMBER 2011: THIS PROTOTYPE OF fit_to_pixels() IS NOT USED
+          ANYWHERE AND HAS NOT BEEN TESTED.
+       */
+       Gtk::Label foo;
+       Glib::RefPtr<Pango::Layout> layout = foo.create_pango_layout (str);
+       Glib::RefPtr<const Pango::LayoutLine> line;
+
+       layout->set_font_description (font);
+       layout->set_width (pixel_width * PANGO_SCALE);
+
+       if (with_ellipses) {
+               layout->set_ellipsize (Pango::ELLIPSIZE_END);
+       } else {
+               layout->set_wrap (Pango::WRAP_CHAR);
+       }
+
+       line = layout->get_line (0);
+
+       /* XXX: might need special care to get the ellipsis character, not sure
+           how that works 
+       */      
+
+       string s = string (layout->get_text ().substr(line->get_start_index(), line->get_length()));
+       
+       cerr << "fit to pixels of " << str << " returns " << s << endl;
+
+       return s;
+}
+#endif
+
+/** Try to fit a string into a given horizontal space by ellipsizing it.
+ *  @param cr Cairo context in which the text will be plotted.
+ *  @param name Text.
+ *  @param avail Available horizontal space.
+ *  @return (Text, possibly ellipsized) and (horizontal size of text)
+ */
+
+std::pair<std::string, double>
+Gtkmm2ext::fit_to_pixels (cairo_t* cr, std::string name, double avail)
+{
+       /* XXX hopefully there exists a more efficient way of doing this */
+
+       bool abbreviated = false;
+       uint32_t width = 0;
+
+       while (1) {
+               cairo_text_extents_t ext;
+               cairo_text_extents (cr, name.c_str(), &ext);
+
+               if (ext.width < avail || name.length() <= 4) {
+                       width = ext.width;
+                       break;
+               }
+
+               if (abbreviated) {
+                       name = name.substr (0, name.length() - 4) + "...";
+               } else {
+                       name = name.substr (0, name.length() - 3) + "...";
+                       abbreviated = true;
+               }
+       }
+
+       return std::make_pair (name, width);
+}
+
+Gtk::Label *
+Gtkmm2ext::left_aligned_label (string const & t)
+{
+       Gtk::Label* l = new Gtk::Label (t);
+       l->set_alignment (0, 0.5);
+       return l;
+}
+
+static bool
+make_null_tooltip (int, int, bool, const Glib::RefPtr<Gtk::Tooltip>& t)
+{
+       t->set_tip_area (Gdk::Rectangle (0, 0, 0, 0));
+       return true;
+}
+
+/** Hackily arrange for the provided widget to have no tooltip,
+ *  and also to stop any other widget from providing one while
+ * the mouse is over w.
+ */
+void
+Gtkmm2ext::set_no_tooltip_whatsoever (Gtk::Widget& w)
+{
+       w.property_has_tooltip() = true;
+       w.signal_query_tooltip().connect (sigc::ptr_fun (make_null_tooltip));
+}
+
+void
+Gtkmm2ext::enable_tooltips ()
+{
+       gtk_rc_parse_string ("gtk-enable-tooltips = 1");
+}
+
+void
+Gtkmm2ext::disable_tooltips ()
+{
+       gtk_rc_parse_string ("gtk-enable-tooltips = 0");
+}
+
+const char*
+Gtkmm2ext::event_type_string (int event_type)
+{
+       switch (event_type) {
+       case GDK_NOTHING:
+               return "nothing";
+       case GDK_DELETE:
+               return "delete";
+       case GDK_DESTROY:
+               return "destroy";
+       case GDK_EXPOSE:
+               return "expose";
+       case GDK_MOTION_NOTIFY:
+               return "motion_notify";
+       case GDK_BUTTON_PRESS:
+               return "button_press";
+       case GDK_2BUTTON_PRESS:
+               return "2button_press";
+       case GDK_3BUTTON_PRESS:
+               return "3button_press";
+       case GDK_BUTTON_RELEASE:
+               return "button_release";
+       case GDK_KEY_PRESS:
+               return "key_press";
+       case GDK_KEY_RELEASE:
+               return "key_release";
+       case GDK_ENTER_NOTIFY:
+               return "enter_notify";
+       case GDK_LEAVE_NOTIFY:
+               return "leave_notify";
+       case GDK_FOCUS_CHANGE:
+               return "focus_change";
+       case GDK_CONFIGURE:
+               return "configure";
+       case GDK_MAP:
+               return "map";
+       case GDK_UNMAP:
+               return "unmap";
+       case GDK_PROPERTY_NOTIFY:
+               return "property_notify";
+       case GDK_SELECTION_CLEAR:
+               return "selection_clear";
+       case GDK_SELECTION_REQUEST:
+               return "selection_request";
+       case GDK_SELECTION_NOTIFY:
+               return "selection_notify";
+       case GDK_PROXIMITY_IN:
+               return "proximity_in";
+       case GDK_PROXIMITY_OUT:
+               return "proximity_out";
+       case GDK_DRAG_ENTER:
+               return "drag_enter";
+       case GDK_DRAG_LEAVE:
+               return "drag_leave";
+       case GDK_DRAG_MOTION:
+               return "drag_motion";
+       case GDK_DRAG_STATUS:
+               return "drag_status";
+       case GDK_DROP_START:
+               return "drop_start";
+       case GDK_DROP_FINISHED:
+               return "drop_finished";
+       case GDK_CLIENT_EVENT:
+               return "client_event";
+       case GDK_VISIBILITY_NOTIFY:
+               return "visibility_notify";
+       case GDK_NO_EXPOSE:
+               return "no_expose";
+       case GDK_SCROLL:
+               return "scroll";
+       case GDK_WINDOW_STATE:
+               return "window_state";
+       case GDK_SETTING:
+               return "setting";
+       case GDK_OWNER_CHANGE:
+               return "owner_change";
+       case GDK_GRAB_BROKEN:
+               return "grab_broken";
+       case GDK_DAMAGE:
+               return "damage";
+       }
+
+       return "unknown";
+}