/* LIBGIMP - The GIMP Library * Copyright (C) 1995-1997 Peter Mattis and Spencer Kimball * * gimpwidgets.c * Copyright (C) 2000 Michael Natterer * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2 of the License, or (at your option) any later version. * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Library General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, write to the * Free Software Foundation, Inc., 59 Temple Place - Suite 330, * Boston, MA 02111-1307, USA. */ #include "config.h" #include #include #include "libgimpmath/gimpmath.h" #include "libgimpbase/gimpbase.h" #include "gimpwidgetstypes.h" #include "gimpchainbutton.h" #include "gimphelpui.h" #include "gimppixmap.h" #include "gimpsizeentry.h" #include "gimpunitmenu.h" #include "gimpwidgets.h" #include "themes/Default/images/gimp-wilber-pixbufs.h" #include "libgimp/libgimp-intl.h" void gimp_widgets_init (void) { GdkPixbuf *pixbuf; GList *icon_list = NULL; gint i; const guint8 *inline_pixbufs[] = { stock_wilber_16_16, stock_wilber_32_32, stock_wilber_48_48, stock_wilber_64_64 }; gimp_stock_init (); for (i = 0; i < G_N_ELEMENTS (inline_pixbufs); i++) { pixbuf = gdk_pixbuf_new_from_inline (-1, inline_pixbufs[i], FALSE, NULL); icon_list = g_list_prepend (icon_list, pixbuf); } gtk_window_set_default_icon_list (icon_list); g_list_foreach (icon_list, (GFunc) g_object_unref, NULL); g_list_free (icon_list); } /* * Widget Constructors */ /** * gimp_option_menu_new: * @menu_only: #TRUE if the function should return a #GtkMenu only. * @...: A #NULL terminated @va_list describing the menu items. * * Returns: A #GtkOptionMenu or a #GtkMenu (depending on @menu_only). **/ GtkWidget * gimp_option_menu_new (gboolean menu_only, /* specify menu items as va_list: * const gchar *label, * GCallback callback, * gpointer callback_data, * gpointer item_data, * GtkWidget **widget_ptr, * gboolean active */ ...) { GtkWidget *menu; GtkWidget *menuitem; /* menu item variables */ const gchar *label; GCallback callback; gpointer callback_data; gpointer item_data; GtkWidget **widget_ptr; gboolean active; va_list args; gint i; gint initial_index; menu = gtk_menu_new (); /* create the menu items */ initial_index = 0; va_start (args, menu_only); label = va_arg (args, const gchar *); for (i = 0; label; i++) { callback = va_arg (args, GCallback); callback_data = va_arg (args, gpointer); item_data = va_arg (args, gpointer); widget_ptr = va_arg (args, GtkWidget **); active = va_arg (args, gboolean); if (strcmp (label, "---")) { menuitem = gtk_menu_item_new_with_label (label); g_signal_connect (G_OBJECT (menuitem), "activate", callback, callback_data); if (item_data) { g_object_set_data (G_OBJECT (menuitem), "gimp-item-data", item_data); /* backward compat */ g_object_set_data (G_OBJECT (menuitem), "user_data", item_data); } } else { menuitem = gtk_menu_item_new (); gtk_widget_set_sensitive (menuitem, FALSE); } gtk_menu_shell_append (GTK_MENU_SHELL (menu), menuitem); if (widget_ptr) *widget_ptr = menuitem; gtk_widget_show (menuitem); /* remember the initial menu item */ if (active) initial_index = i; label = va_arg (args, const gchar *); } va_end (args); if (! menu_only) { GtkWidget *optionmenu; optionmenu = gtk_option_menu_new (); gtk_option_menu_set_menu (GTK_OPTION_MENU (optionmenu), menu); /* select the initial menu item */ gtk_option_menu_set_history (GTK_OPTION_MENU (optionmenu), initial_index); return optionmenu; } return menu; } /** * gimp_option_menu_new2: * @menu_only: #TRUE if the function should return a #GtkMenu only. * @menu_item_callback: The callback each menu item's "activate" signal will * be connected with. * @callback_data: The data which will be passed to g_signal_connect(). * @initial: The @item_data of the initially selected menu item. * @...: A #NULL terminated @va_list describing the menu items. * * Returns: A #GtkOptionMenu or a #GtkMenu (depending on @menu_only). **/ GtkWidget * gimp_option_menu_new2 (gboolean menu_only, GCallback menu_item_callback, gpointer callback_data, gpointer initial, /* item_data */ /* specify menu items as va_list: * const gchar *label, * gpointer item_data, * GtkWidget **widget_ptr, */ ...) { GtkWidget *menu; GtkWidget *menuitem; /* menu item variables */ const gchar *label; gpointer item_data; GtkWidget **widget_ptr; va_list args; gint i; gint initial_index; menu = gtk_menu_new (); /* create the menu items */ initial_index = 0; va_start (args, initial); label = va_arg (args, const gchar *); for (i = 0; label; i++) { item_data = va_arg (args, gpointer); widget_ptr = va_arg (args, GtkWidget **); if (strcmp (label, "---")) { menuitem = gtk_menu_item_new_with_label (label); g_signal_connect (G_OBJECT (menuitem), "activate", menu_item_callback, callback_data); if (item_data) { g_object_set_data (G_OBJECT (menuitem), "gimp-item-data", item_data); /* backward compat */ g_object_set_data (G_OBJECT (menuitem), "user_data", item_data); } } else { menuitem = gtk_menu_item_new (); gtk_widget_set_sensitive (menuitem, FALSE); } gtk_menu_shell_append (GTK_MENU_SHELL (menu), menuitem); if (widget_ptr) *widget_ptr = menuitem; gtk_widget_show (menuitem); /* remember the initial menu item */ if (item_data == initial) initial_index = i; label = va_arg (args, const gchar *); } va_end (args); if (! menu_only) { GtkWidget *optionmenu; optionmenu = gtk_option_menu_new (); gtk_option_menu_set_menu (GTK_OPTION_MENU (optionmenu), menu); /* select the initial menu item */ gtk_option_menu_set_history (GTK_OPTION_MENU (optionmenu), initial_index); return optionmenu; } return menu; } /** * gimp_option_menu_set_history: * @option_menu: A #GtkOptionMenu as returned by gimp_option_menu_new() or * gimp_option_menu_new2(). * @item_data: The @item_data of the menu item you want to select. **/ void gimp_option_menu_set_history (GtkOptionMenu *option_menu, gpointer item_data) { GtkWidget *menu_item; GList *list; gint history = 0; g_return_if_fail (GTK_IS_OPTION_MENU (option_menu)); for (list = GTK_MENU_SHELL (option_menu->menu)->children; list; list = g_list_next (list)) { menu_item = GTK_WIDGET (list->data); if (GTK_IS_LABEL (GTK_BIN (menu_item)->child) && g_object_get_data (G_OBJECT (menu_item), "gimp-item-data") == item_data) { break; } history++; } if (list) gtk_option_menu_set_history (option_menu, history); } /** * gimp_option_menu_set_sensitive: * @option_menu: a #GtkOptionMenu as returned by gimp_option_menu_new() or * gimp_option_menu_new2(). * @callback: a function called for each item in the menu to determine the * the sensitivity state. * @callback_data: data to pass to the @callback function. * * Calls the given @callback for each item in the menu and passes it the * item_data and the @callback_data. The menu item's sensitivity is set * according to the return value of this function. **/ void gimp_option_menu_set_sensitive (GtkOptionMenu *option_menu, GimpOptionMenuSensitivityCallback callback, gpointer callback_data) { GtkWidget *menu_item; GList *list; gpointer item_data; gboolean sensitive; g_return_if_fail (GTK_IS_OPTION_MENU (option_menu)); g_return_if_fail (callback != NULL); for (list = GTK_MENU_SHELL (option_menu->menu)->children; list; list = g_list_next (list)) { menu_item = GTK_WIDGET (list->data); if (GTK_IS_LABEL (GTK_BIN (menu_item)->child)) { item_data = g_object_get_data (G_OBJECT (menu_item), "gimp-item-data"); sensitive = callback (item_data, callback_data); gtk_widget_set_sensitive (menu_item, sensitive); } } } /** * gimp_radio_group_new: * @in_frame: #TRUE if you want a #GtkFrame around the radio button group. * @frame_title: The title of the Frame or #NULL if you don't want a title. * @...: A #NULL terminated @va_list describing the radio buttons. * * Returns: A #GtkFrame or #GtkVbox (depending on @in_frame). **/ GtkWidget * gimp_radio_group_new (gboolean in_frame, const gchar *frame_title, /* specify radio buttons as va_list: * const gchar *label, * GCallback callback, * gpointer callback_data, * gpointer item_data, * GtkWidget **widget_ptr, * gboolean active, */ ...) { GtkWidget *vbox; GtkWidget *button; GSList *group; /* radio button variables */ const gchar *label; GCallback callback; gpointer callback_data; gpointer item_data; GtkWidget **widget_ptr; gboolean active; va_list args; vbox = gtk_vbox_new (FALSE, 1); group = NULL; /* create the radio buttons */ va_start (args, frame_title); label = va_arg (args, const gchar *); while (label) { callback = va_arg (args, GCallback); callback_data = va_arg (args, gpointer); item_data = va_arg (args, gpointer); widget_ptr = va_arg (args, GtkWidget **); active = va_arg (args, gboolean); if (label != (gpointer) 1) button = gtk_radio_button_new_with_label (group, label); else button = gtk_radio_button_new (group); group = gtk_radio_button_get_group (GTK_RADIO_BUTTON (button)); gtk_box_pack_start (GTK_BOX (vbox), button, FALSE, FALSE, 0); if (item_data) { g_object_set_data (G_OBJECT (button), "gimp-item-data", item_data); /* backward compatibility */ g_object_set_data (G_OBJECT (button), "user_data", item_data); } if (widget_ptr) *widget_ptr = button; if (active) gtk_toggle_button_set_active (GTK_TOGGLE_BUTTON (button), TRUE); g_signal_connect (G_OBJECT (button), "toggled", callback, callback_data); gtk_widget_show (button); label = va_arg (args, const gchar *); } va_end (args); if (in_frame) { GtkWidget *frame; gtk_container_set_border_width (GTK_CONTAINER (vbox), 2); frame = gtk_frame_new (frame_title); gtk_container_add (GTK_CONTAINER (frame), vbox); gtk_widget_show (vbox); return frame; } return vbox; } /** * gimp_radio_group_new2: * @in_frame: #TRUE if you want a #GtkFrame around the * radio button group. * @frame_title: The title of the Frame or #NULL if you don't want * a title. * @radio_button_callback: The callback each button's "toggled" signal will * be connected with. * @callback_data: The data which will be passed to * g_signal_connect(). * @initial: The @item_data of the initially pressed radio button. * @...: A #NULL terminated @va_list describing * the radio buttons. * * Returns: A #GtkFrame or #GtkVbox (depending on @in_frame). **/ GtkWidget * gimp_radio_group_new2 (gboolean in_frame, const gchar *frame_title, GCallback radio_button_callback, gpointer callback_data, gpointer initial, /* item_data */ /* specify radio buttons as va_list: * const gchar *label, * gpointer item_data, * GtkWidget **widget_ptr, */ ...) { GtkWidget *vbox; GtkWidget *button; GSList *group; /* radio button variables */ const gchar *label; gpointer item_data; GtkWidget **widget_ptr; va_list args; vbox = gtk_vbox_new (FALSE, 1); group = NULL; /* create the radio buttons */ va_start (args, initial); label = va_arg (args, const gchar *); while (label) { item_data = va_arg (args, gpointer); widget_ptr = va_arg (args, GtkWidget **); if (label != (gpointer) 1) button = gtk_radio_button_new_with_label (group, label); else button = gtk_radio_button_new (group); group = gtk_radio_button_get_group (GTK_RADIO_BUTTON (button)); gtk_box_pack_start (GTK_BOX (vbox), button, FALSE, FALSE, 0); if (item_data) { g_object_set_data (G_OBJECT (button), "gimp-item-data", item_data); /* backward compatibility */ g_object_set_data (G_OBJECT (button), "user_data", item_data); } if (widget_ptr) *widget_ptr = button; if (initial == item_data) gtk_toggle_button_set_active (GTK_TOGGLE_BUTTON (button), TRUE); g_signal_connect (G_OBJECT (button), "toggled", radio_button_callback, callback_data); gtk_widget_show (button); label = va_arg (args, const gchar *); } va_end (args); if (in_frame) { GtkWidget *frame; gtk_container_set_border_width (GTK_CONTAINER (vbox), 2); frame = gtk_frame_new (frame_title); gtk_container_add (GTK_CONTAINER (frame), vbox); gtk_widget_show (vbox); return frame; } return vbox; } void gimp_radio_group_set_active (GtkRadioButton *radio_button, gpointer item_data) { GtkWidget *button; GSList *group; g_return_if_fail (GTK_IS_RADIO_BUTTON (radio_button)); for (group = gtk_radio_button_get_group (radio_button); group; group = g_slist_next (group)) { button = GTK_WIDGET (group->data); if (g_object_get_data (G_OBJECT (button), "gimp-item-data") == item_data) { gtk_toggle_button_set_active (GTK_TOGGLE_BUTTON (button), TRUE); return; } } } /** * gimp_spin_button_new: * @adjustment: Returns the spinbutton's #GtkAdjustment. * @value: The initial value of the spinbutton. * @lower: The lower boundary. * @upper: The uppper boundary. * @step_increment: The spinbutton's step increment. * @page_increment: The spinbutton's page increment (mouse button 2). * @page_size: The spinbutton's page size. * @climb_rate: The spinbutton's climb rate. * @digits: The spinbutton's number of decimal digits. * * This function is a shortcut for gtk_adjustment_new() and a subsequent * gtk_spin_button_new() and does some more initialisation stuff like * setting a standard minimun horizontal size. * * Returns: A #GtkSpinbutton and it's #GtkAdjustment. **/ GtkWidget * gimp_spin_button_new (GtkObject **adjustment, /* return value */ gfloat value, gfloat lower, gfloat upper, gfloat step_increment, gfloat page_increment, gfloat page_size, gfloat climb_rate, guint digits) { GtkWidget *spinbutton; *adjustment = gtk_adjustment_new (value, lower, upper, step_increment, page_increment, page_size); spinbutton = gtk_spin_button_new (GTK_ADJUSTMENT (*adjustment), climb_rate, digits); gtk_spin_button_set_numeric (GTK_SPIN_BUTTON (spinbutton), TRUE); gtk_widget_set_size_request (spinbutton, 75, -1); return spinbutton; } static void gimp_scale_entry_unconstrained_adjustment_callback (GtkAdjustment *adjustment, GtkAdjustment *other_adj) { g_signal_handlers_block_by_func (G_OBJECT (other_adj), gimp_scale_entry_unconstrained_adjustment_callback, adjustment); gtk_adjustment_set_value (other_adj, adjustment->value); g_signal_handlers_unblock_by_func (G_OBJECT (other_adj), gimp_scale_entry_unconstrained_adjustment_callback, adjustment); } /** * gimp_scale_entry_new: * @table: The #GtkTable the widgets will be attached to. * @column: The column to start with. * @row: The row to attach the widgets. * @text: The text for the #GtkLabel which will appear * left of the #GtkHScale. * @scale_width: The minimum horizontal size of the #GtkHScale. * @spinbutton_width: The minimum horizontal size of the #GtkSpinButton. * @value: The initial value. * @lower: The lower boundary. * @upper: The upper boundary. * @step_increment: The step increment. * @page_increment: The page increment. * @digits: The number of decimal digits. * @constrain: #TRUE if the range of possible values of the * #GtkSpinButton should be the same as of the #GtkHScale. * @unconstrained_lower: The spinbutton's lower boundary * if @constrain == #FALSE. * @unconstrained_upper: The spinbutton's upper boundary * if @constrain == #FALSE. * @tooltip: A tooltip message for the scale and the spinbutton. * @help_data: The widgets' help_data (see gimp_help_set_help_data()). * * This function creates a #GtkLabel, a #GtkHScale and a #GtkSpinButton and * attaches them to a 3-column #GtkTable. * * Note that if you pass a @tooltip or @help_data to this function you'll * have to initialize GIMP's help system with gimp_help_init() before using it. * * Returns: The #GtkSpinButton's #GtkAdjustment. **/ GtkObject * gimp_scale_entry_new (GtkTable *table, gint column, gint row, const gchar *text, gint scale_width, gint spinbutton_width, gfloat value, gfloat lower, gfloat upper, gfloat step_increment, gfloat page_increment, guint digits, gboolean constrain, gfloat unconstrained_lower, gfloat unconstrained_upper, const gchar *tooltip, const gchar *help_data) { GtkWidget *label; GtkWidget *scale; GtkWidget *spinbutton; GtkObject *adjustment; GtkObject *return_adj; label = gtk_label_new_with_mnemonic (text); gtk_misc_set_alignment (GTK_MISC (label), 1.0, 0.5); gtk_table_attach (GTK_TABLE (table), label, column, column + 1, row, row + 1, GTK_FILL, GTK_FILL, 0, 0); gtk_widget_show (label); if (! constrain && unconstrained_lower <= lower && unconstrained_upper >= upper) { GtkObject *constrained_adj; constrained_adj = gtk_adjustment_new (value, lower, upper, step_increment, page_increment, 0.0); spinbutton = gimp_spin_button_new (&adjustment, value, unconstrained_lower, unconstrained_upper, step_increment, page_increment, 0.0, 1.0, digits); g_signal_connect (G_OBJECT (constrained_adj), "value_changed", G_CALLBACK (gimp_scale_entry_unconstrained_adjustment_callback), adjustment); g_signal_connect (G_OBJECT (adjustment), "value_changed", G_CALLBACK (gimp_scale_entry_unconstrained_adjustment_callback), constrained_adj); return_adj = adjustment; adjustment = constrained_adj; } else { spinbutton = gimp_spin_button_new (&adjustment, value, lower, upper, step_increment, page_increment, 0.0, 1.0, digits); return_adj = adjustment; } gtk_label_set_mnemonic_widget (GTK_LABEL (label), spinbutton); if (spinbutton_width > 0) gtk_widget_set_size_request (spinbutton, spinbutton_width, -1); scale = gtk_hscale_new (GTK_ADJUSTMENT (adjustment)); if (scale_width > 0) gtk_widget_set_size_request (scale, scale_width, -1); gtk_scale_set_digits (GTK_SCALE (scale), digits); gtk_scale_set_draw_value (GTK_SCALE (scale), FALSE); gtk_table_attach (GTK_TABLE (table), scale, column + 1, column + 2, row, row + 1, GTK_FILL | GTK_EXPAND, GTK_FILL, 0, 0); gtk_widget_show (scale); gtk_table_attach (GTK_TABLE (table), spinbutton, column + 2, column + 3, row, row + 1, GTK_SHRINK, GTK_SHRINK, 0, 0); gtk_widget_show (spinbutton); if (tooltip || help_data) { gimp_help_set_help_data (scale, tooltip, help_data); gimp_help_set_help_data (spinbutton, tooltip, help_data); } g_object_set_data (G_OBJECT (return_adj), "label", label); g_object_set_data (G_OBJECT (return_adj), "scale", scale); g_object_set_data (G_OBJECT (return_adj), "spinbutton", spinbutton); return return_adj; } static void gimp_random_seed_toggle_update (GtkWidget *widget, gpointer data) { gint *toggle_val; toggle_val = (gint *) data; if (gtk_toggle_button_get_active (GTK_TOGGLE_BUTTON (widget))) *toggle_val = GPOINTER_TO_INT (g_object_get_data (G_OBJECT (widget), "time_true")); else *toggle_val = GPOINTER_TO_INT (g_object_get_data (G_OBJECT (widget), "time_false")); gimp_toggle_button_sensitive_update (GTK_TOGGLE_BUTTON (widget)); } /** * gimp_random_seed_new: * @seed: A pointer to the variable which stores the random seed. * @use_time: A pointer to the variable which stores the @use_time * toggle boolean. * @time_true: The value to write to @use_time if the toggle button is checked. * @time_false: The value to write to @use_time if the toggle button is * unchecked. * * Note that this widget automatically sets tooltips with * gimp_help_set_help_data(), so you'll have to initialize GIMP's help * system with gimp_help_init() before using it. * * Returns: A #GtkHBox containing a #GtkSpinButton for the random seed and * a #GtkToggleButton for toggling the @use_time behaviour. **/ GtkWidget * gimp_random_seed_new (gint *seed, gint *use_time, gint time_true, gint time_false) { GtkWidget *hbox; GtkWidget *spinbutton; GtkObject *adj; GtkWidget *button; hbox = gtk_hbox_new (FALSE, 4); spinbutton = gimp_spin_button_new (&adj, *seed, 0, G_MAXRAND, 1, 10, 0, 1, 0); gtk_box_pack_start (GTK_BOX (hbox), spinbutton, FALSE, FALSE, 0); g_signal_connect (G_OBJECT (adj), "value_changed", G_CALLBACK (gimp_int_adjustment_update), seed); gtk_widget_show (spinbutton); gimp_help_set_help_data (spinbutton, _("If the \"Time\" button is not pressed, " "use this value for random number generator " "seed - this allows you to repeat a " "given \"random\" operation"), NULL); button = gtk_toggle_button_new_with_label (_("Time")); gtk_misc_set_padding (GTK_MISC (GTK_BIN (button)->child), 2, 0); g_signal_connect (G_OBJECT (button), "toggled", G_CALLBACK (gimp_random_seed_toggle_update), use_time); gtk_box_pack_end (GTK_BOX (hbox), button, FALSE, FALSE, 0); gtk_widget_show (button); gimp_help_set_help_data (button, _("Seed random number generator from the current " "time - this guarantees a reasonable " "randomization"), NULL); g_object_set_data (G_OBJECT (button), "time_true", GINT_TO_POINTER (time_true)); g_object_set_data (G_OBJECT (button), "time_false", GINT_TO_POINTER (time_false)); g_object_set_data (G_OBJECT (button), "inverse_sensitive", spinbutton); gtk_toggle_button_set_active (GTK_TOGGLE_BUTTON (button), *use_time == time_true); g_object_set_data (G_OBJECT (hbox), "spinbutton", spinbutton); g_object_set_data (G_OBJECT (hbox), "togglebutton", button); return hbox; } typedef struct { GimpChainButton *chainbutton; gboolean chain_constrains_ratio; gdouble orig_x; gdouble orig_y; gdouble last_x; gdouble last_y; } GimpCoordinatesData; static void gimp_coordinates_callback (GtkWidget *widget, gpointer data) { GimpCoordinatesData *gcd; gdouble new_x; gdouble new_y; gcd = (GimpCoordinatesData *) data; new_x = gimp_size_entry_get_refval (GIMP_SIZE_ENTRY (widget), 0); new_y = gimp_size_entry_get_refval (GIMP_SIZE_ENTRY (widget), 1); if (gimp_chain_button_get_active (gcd->chainbutton)) { g_signal_stop_emission_by_name (G_OBJECT (widget), "value_changed"); if (gcd->chain_constrains_ratio) { if ((gcd->orig_x != 0) && (gcd->orig_y != 0)) { if (new_x != gcd->last_x) { gcd->last_x = new_x; gcd->last_y = new_y = (new_x * gcd->orig_y) / gcd->orig_x; gimp_size_entry_set_refval (GIMP_SIZE_ENTRY (widget), 1, new_y); } else if (new_y != gcd->last_y) { gcd->last_y = new_y; gcd->last_x = new_x = (new_y * gcd->orig_x) / gcd->orig_y; gimp_size_entry_set_refval (GIMP_SIZE_ENTRY (widget), 0, new_x); } } } else { if (new_x != gcd->last_x) { gcd->last_y = new_y = gcd->last_x = new_x; gimp_size_entry_set_refval (GIMP_SIZE_ENTRY (widget), 1, new_x); } else if (new_y != gcd->last_y) { gcd->last_x = new_x = gcd->last_y = new_y; gimp_size_entry_set_refval (GIMP_SIZE_ENTRY (widget), 0, new_y); } } } else { if (new_x != gcd->last_x) gcd->last_x = new_x; if (new_y != gcd->last_y) gcd->last_y = new_y; } } /** * gimp_coordinates_new: * @unit: The initial unit of the #GimpUnitMenu. * @unit_format: The unit format string as passed to * gimp_size_entry_new(). * @menu_show_pixels: #TRUE if the #GimpUnitMenu should contain an item for * GIMP_UNIT_PIXEL. * @menu_show_percent: #TRUE if the #GimpUnitMenu should contain an item for * GIMP_UNIT_PERCENT. * @spinbutton_width: The horizontal size of the #GimpSizeEntry's * #GtkSpinButton's. * @update_policy: The update policy for the #GimpSizeEntry. * @chainbutton_active: #TRUE if the attached #GimpChainButton should be * active. * @chain_constrains_ratio: #TRUE if the chainbutton should constrain the * fields' aspect ratio. If #FALSE, the values will * be constrained. * @xlabel: The label for the X coordinate. * @x: The initial value of the X coordinate. * @xres: The horizontal resolution in DPI. * @lower_boundary_x: The lower boundary of the X coordinate. * @upper_boundary_x: The upper boundary of the X coordinate. * @xsize_0: The X value which will be treated as 0%. * @xsize_100: The X value which will be treated as 100%. * @ylabel: The label for the Y coordinate. * @y: The initial value of the Y coordinate. * @yres: The vertical resolution in DPI. * @lower_boundary_y: The lower boundary of the Y coordinate. * @upper_boundary_y: The upper boundary of the Y coordinate. * @ysize_0: The Y value which will be treated as 0%. * @ysize_100: The Y value which will be treated as 100%. * * Returns: A #GimpSizeEntry with two fields for x/y coordinates/sizes with * a #GimpChainButton attached to constrain either the two fields' * values or the ratio between them. **/ GtkWidget * gimp_coordinates_new (GimpUnit unit, const gchar *unit_format, gboolean menu_show_pixels, gboolean menu_show_percent, gint spinbutton_width, GimpSizeEntryUpdatePolicy update_policy, gboolean chainbutton_active, gboolean chain_constrains_ratio, const gchar *xlabel, gdouble x, gdouble xres, gdouble lower_boundary_x, gdouble upper_boundary_x, gdouble xsize_0, /* % */ gdouble xsize_100, /* % */ const gchar *ylabel, gdouble y, gdouble yres, gdouble lower_boundary_y, gdouble upper_boundary_y, gdouble ysize_0, /* % */ gdouble ysize_100 /* % */) { GimpCoordinatesData *gcd; GtkObject *adjustment; GtkWidget *spinbutton; GtkWidget *sizeentry; GtkWidget *chainbutton; spinbutton = gimp_spin_button_new (&adjustment, 1, 0, 1, 1, 10, 1, 1, 2); sizeentry = gimp_size_entry_new (1, unit, unit_format, menu_show_pixels, menu_show_percent, FALSE, spinbutton_width, update_policy); gtk_table_set_col_spacing (GTK_TABLE (sizeentry), 0, 4); gtk_table_set_col_spacing (GTK_TABLE (sizeentry), 2, 4); gimp_size_entry_add_field (GIMP_SIZE_ENTRY (sizeentry), GTK_SPIN_BUTTON (spinbutton), NULL); gtk_table_attach_defaults (GTK_TABLE (sizeentry), spinbutton, 1, 2, 0, 1); gtk_widget_show (spinbutton); gimp_size_entry_set_unit (GIMP_SIZE_ENTRY (sizeentry), (update_policy == GIMP_SIZE_ENTRY_UPDATE_RESOLUTION) || (menu_show_pixels == FALSE) ? GIMP_UNIT_INCH : GIMP_UNIT_PIXEL); gimp_size_entry_set_resolution (GIMP_SIZE_ENTRY (sizeentry), 0, xres, TRUE); gimp_size_entry_set_resolution (GIMP_SIZE_ENTRY (sizeentry), 1, yres, TRUE); gimp_size_entry_set_refval_boundaries (GIMP_SIZE_ENTRY (sizeentry), 0, lower_boundary_x, upper_boundary_x); gimp_size_entry_set_refval_boundaries (GIMP_SIZE_ENTRY (sizeentry), 1, lower_boundary_y, upper_boundary_y); if (menu_show_percent) { gimp_size_entry_set_size (GIMP_SIZE_ENTRY (sizeentry), 0, xsize_0, xsize_100); gimp_size_entry_set_size (GIMP_SIZE_ENTRY (sizeentry), 1, ysize_0, ysize_100); } gimp_size_entry_set_refval (GIMP_SIZE_ENTRY (sizeentry), 0, x); gimp_size_entry_set_refval (GIMP_SIZE_ENTRY (sizeentry), 1, y); gimp_size_entry_attach_label (GIMP_SIZE_ENTRY (sizeentry), xlabel, 0, 0, 1.0); gimp_size_entry_attach_label (GIMP_SIZE_ENTRY (sizeentry), ylabel, 1, 0, 1.0); chainbutton = gimp_chain_button_new (GIMP_CHAIN_RIGHT); if (chainbutton_active) gimp_chain_button_set_active (GIMP_CHAIN_BUTTON (chainbutton), TRUE); gtk_table_attach (GTK_TABLE (sizeentry), chainbutton, 2, 3, 0, 2, GTK_SHRINK | GTK_FILL, GTK_EXPAND | GTK_FILL, 0, 0); gtk_widget_show (chainbutton); gcd = g_new (GimpCoordinatesData, 1); gcd->chainbutton = GIMP_CHAIN_BUTTON (chainbutton); gcd->chain_constrains_ratio = chain_constrains_ratio; gcd->orig_x = x; gcd->orig_y = y; gcd->last_x = x; gcd->last_y = y; g_signal_connect_swapped (G_OBJECT (sizeentry), "destroy", G_CALLBACK (g_free), gcd); g_signal_connect (G_OBJECT (sizeentry), "value_changed", G_CALLBACK (gimp_coordinates_callback), gcd); g_object_set_data (G_OBJECT (sizeentry), "chainbutton", chainbutton); return sizeentry; } typedef struct { GtkAdjustment *adjustment; GtkAdjustment *divided_adj; guint mem_size_unit; } GimpMemSizeEntryData; static void gimp_mem_size_entry_callback (GtkAdjustment *adj, gpointer data) { GimpMemSizeEntryData *gmsed; guint new_value; gmsed = (GimpMemSizeEntryData *)data; new_value = adj->value * gmsed->mem_size_unit; gtk_adjustment_set_value (gmsed->adjustment, new_value); } static void gimp_mem_size_unit_callback (GtkWidget *widget, gpointer data) { GimpMemSizeEntryData *gmsed; guint divided_mem_size; guint new_unit; gmsed = (GimpMemSizeEntryData *)data; new_unit = GPOINTER_TO_UINT (g_object_get_data (G_OBJECT (widget), "gimp-item-data")); if (new_unit && new_unit != gmsed->mem_size_unit) { divided_mem_size = gmsed->adjustment->value / new_unit; gmsed->mem_size_unit = new_unit; gtk_adjustment_set_value (GTK_ADJUSTMENT (gmsed->divided_adj), divided_mem_size); } } /** * gimp_mem_size_entry_new: * @adjustment: The adjustment containing the memsize and it's limits. * * Returns: A #GtkHBox with a #GtkSpinButton and a #GtkOptionMenu. **/ GtkWidget * gimp_mem_size_entry_new (GtkAdjustment *adjustment) { GtkWidget *hbox; GtkObject *divided_adj; GtkWidget *spinbutton; GtkWidget *optionmenu; GimpMemSizeEntryData *gmsed; guint mem_size_unit = 1; guint divided_mem_size; gint i; gmsed = g_new (GimpMemSizeEntryData, 1); for (i = 0; i < 2; i++) { if ( (gint) adjustment->value % (mem_size_unit * 1024) != 0 ) break; mem_size_unit *= 1024; } divided_mem_size = adjustment->value / mem_size_unit; hbox = gtk_hbox_new (FALSE, 2); spinbutton = gimp_spin_button_new (÷d_adj, divided_mem_size, 0.0, (4096.0 * 1024 * 1024 - 1), 1.0, 16.0, 0.0, 1.0, 0.0); g_signal_connect (G_OBJECT (divided_adj), "value_changed", G_CALLBACK (gimp_mem_size_entry_callback), gmsed); gtk_box_pack_start (GTK_BOX (hbox), spinbutton, FALSE, FALSE, 0); gtk_widget_show (spinbutton); optionmenu = gimp_option_menu_new2 (FALSE, G_CALLBACK (gimp_mem_size_unit_callback), gmsed, (gpointer) mem_size_unit, _("Bytes"), (gpointer) 1, NULL, _("KiloBytes"), (gpointer) 1024, NULL, _("MegaBytes"), (gpointer) (1024 * 1024), NULL, NULL); gtk_box_pack_start (GTK_BOX (hbox), optionmenu, FALSE, FALSE, 0); gtk_widget_show (optionmenu); g_object_ref (adjustment); gtk_object_sink (GTK_OBJECT (adjustment)); g_signal_connect_swapped (G_OBJECT (hbox), "destroy", G_CALLBACK (g_object_unref), adjustment); g_signal_connect_swapped (G_OBJECT (hbox), "destroy", G_CALLBACK (g_free), gmsed); gmsed->adjustment = adjustment; gmsed->divided_adj = GTK_ADJUSTMENT (divided_adj); gmsed->mem_size_unit = mem_size_unit; g_object_set_data (G_OBJECT (hbox), "spinbutton", spinbutton); g_object_set_data (G_OBJECT (hbox), "optionmenu", optionmenu); return hbox; } /** * gimp_pixmap_button_new: * @xpm_data: The XPM data which will be passed to gimp_pixmap_new(). * @text: An optional text which will appear right of the pixmap. * * Returns: A #GtkButton with a #GimpPixmap and an optional #GtkLabel. **/ GtkWidget * gimp_pixmap_button_new (gchar **xpm_data, const gchar *text) { GtkWidget *button; GtkWidget *pixmap; button = gtk_button_new (); pixmap = gimp_pixmap_new (xpm_data); if (text) { GtkWidget *abox; GtkWidget *hbox; GtkWidget *label; abox = gtk_alignment_new (0.5, 0.5, 0.0, 0.0); gtk_container_add (GTK_CONTAINER (button), abox); gtk_widget_show (abox); hbox = gtk_hbox_new (FALSE, 0); gtk_container_add (GTK_CONTAINER (abox), hbox); gtk_widget_show (hbox); gtk_box_pack_start (GTK_BOX (hbox), pixmap, FALSE, FALSE, 4); gtk_widget_show (pixmap); label = gtk_label_new (text); gtk_box_pack_start (GTK_BOX (hbox), label, FALSE, FALSE, 4); gtk_widget_show (label); } else { gtk_container_add (GTK_CONTAINER (button), pixmap); gtk_widget_show (pixmap); } return button; } /* * Standard Callbacks */ /** * gimp_toggle_button_sensitive_update: * @toggle_button: The #GtkToggleButton the "set_sensitive" and * "inverse_sensitive" lists are attached to. * * If you attached a pointer to a #GtkWidget with g_object_set_data() and * the "set_sensitive" key to the #GtkToggleButton, the sensitive state of * the attached widget will be set according to the toggle button's * "active" state. * * You can attach an arbitrary list of widgets by attaching another * "set_sensitive" data pointer to the first widget (and so on...). * * This function can also set the sensitive state according to the toggle * button's inverse "active" state by attaching widgets with the * "inverse_sensitive" key. **/ void gimp_toggle_button_sensitive_update (GtkToggleButton *toggle_button) { GtkWidget *set_sensitive; gboolean active; active = gtk_toggle_button_get_active (toggle_button); set_sensitive = g_object_get_data (G_OBJECT (toggle_button), "set_sensitive"); while (set_sensitive) { gtk_widget_set_sensitive (set_sensitive, active); set_sensitive = g_object_get_data (G_OBJECT (set_sensitive), "set_sensitive"); } set_sensitive = g_object_get_data (G_OBJECT (toggle_button), "inverse_sensitive"); while (set_sensitive) { gtk_widget_set_sensitive (set_sensitive, ! active); set_sensitive = g_object_get_data (G_OBJECT (set_sensitive), "inverse_sensitive"); } } /** * gimp_toggle_button_update: * @widget: A #GtkToggleButton. * @data: A pointer to a #gint variable which will store the value of * gtk_toggle_button_get_active(). * * Note that this function calls gimp_toggle_button_sensitive_update(). **/ void gimp_toggle_button_update (GtkWidget *widget, gpointer data) { gint *toggle_val; toggle_val = (gint *) data; if (gtk_toggle_button_get_active (GTK_TOGGLE_BUTTON (widget))) *toggle_val = TRUE; else *toggle_val = FALSE; gimp_toggle_button_sensitive_update (GTK_TOGGLE_BUTTON (widget)); } /** * gimp_radio_button_update: * @widget: A #GtkRadioButton. * @data: A pointer to a #gint variable which will store the value of * GPOINTER_TO_INT (g_object_get_user_data(@widget, "gimp-item-data")). * * Note that this function calls gimp_toggle_button_sensitive_update(). **/ void gimp_radio_button_update (GtkWidget *widget, gpointer data) { gint *toggle_val; if (gtk_toggle_button_get_active (GTK_TOGGLE_BUTTON (widget))) { toggle_val = (gint *) data; *toggle_val = GPOINTER_TO_INT (g_object_get_data (G_OBJECT (widget), "gimp-item-data")); } gimp_toggle_button_sensitive_update (GTK_TOGGLE_BUTTON (widget)); } /** * gimp_menu_item_update: * @widget: A #GtkMenuItem. * @data: A pointer to a #gint variable which will store the value of * GPOINTER_TO_INT (g_object_get_data(@widget, "gimp-item-data")). **/ void gimp_menu_item_update (GtkWidget *widget, gpointer data) { gint *item_val; item_val = (gint *) data; *item_val = GPOINTER_TO_INT (g_object_get_data (G_OBJECT (widget), "gimp-item-data")); } /** * gimp_int_adjustment_update: * @adjustment: A #GtkAdjustment. * @data: A pointer to a #gint variable which will store the * @adjustment's value. * * Note that the #GtkAdjustment's value (which is a #gfloat) will be rounded * with RINT(). **/ void gimp_int_adjustment_update (GtkAdjustment *adjustment, gpointer data) { gint *val; val = (gint *) data; *val = RINT (adjustment->value); } /** * gimp_uint_adjustment_update: * @adjustment: A #GtkAdjustment. * @data: A pointer to a #guint variable which will store the * @adjustment's value. * * Note that the #GtkAdjustment's value (which is a #gfloat) will be rounded * with (#guint) (value + 0.5). **/ void gimp_uint_adjustment_update (GtkAdjustment *adjustment, gpointer data) { guint *val; val = (guint *) data; *val = (guint) (adjustment->value + 0.5); } /** * gimp_float_adjustment_update: * @adjustment: A #GtkAdjustment. * @data: A pointer to a #gfloat varaiable which willl store the * @adjustment's value. **/ void gimp_float_adjustment_update (GtkAdjustment *adjustment, gpointer data) { gfloat *val; val = (gfloat *) data; *val = adjustment->value; } /** * gimp_double_adjustment_update: * @adjustment: A #GtkAdjustment. * @data: A pointer to a #gdouble variable which will store the * @adjustment's value. **/ void gimp_double_adjustment_update (GtkAdjustment *adjustment, gpointer data) { gdouble *val; val = (gdouble *) data; *val = adjustment->value; } /** * gimp_unit_menu_update: * @widget: A #GimpUnitMenu. * @data: A pointer to a #GimpUnit variable which will store the unit menu's * value. * * This callback can set the number of decimal digits of an arbitrary number * of #GtkSpinButton's. To use this functionality, attach the spinbuttons * as list of data pointers attached with g_object_set_data() with the * "set_digits" key. * * See gimp_toggle_button_sensitive_update() for a description of how * to set up the list. **/ void gimp_unit_menu_update (GtkWidget *widget, gpointer data) { GimpUnit *val; GtkWidget *spinbutton; gint digits; val = (GimpUnit *) data; *val = gimp_unit_menu_get_unit (GIMP_UNIT_MENU (widget)); digits = ((*val == GIMP_UNIT_PIXEL) ? 0 : ((*val == GIMP_UNIT_PERCENT) ? 2 : (MIN (6, MAX (3, gimp_unit_get_digits (*val)))))); spinbutton = g_object_get_data (G_OBJECT (widget), "set_digits"); while (spinbutton) { gtk_spin_button_set_digits (GTK_SPIN_BUTTON (spinbutton), digits); spinbutton = g_object_get_data (G_OBJECT (spinbutton), "set_digits"); } } /* * Helper Functions */ /** * gimp_table_attach_aligned: * @table: The #GtkTable the widgets will be attached to. * @column: The column to start with. * @row: The row to attach the widgets. * @label_text: The text for the #GtkLabel which will be attached left of the * widget. * @xalign: The horizontal alignment of the #GtkLabel. * @yalign: The vertival alignment of the #GtkLabel. * @widget: The #GtkWidget to attach right of the label. * @colspan: The number of columns the widget will use. * @left_align: #TRUE if the widget should be left-aligned. * * Note that the @label_text can be #NULL and that the widget will be attached * starting at (@column + 1) in this case, too. * * Returns: The created #GtkLabel. **/ GtkWidget * gimp_table_attach_aligned (GtkTable *table, gint column, gint row, const gchar *label_text, gfloat xalign, gfloat yalign, GtkWidget *widget, gint colspan, gboolean left_align) { GtkWidget *label = NULL; if (label_text) { label = gtk_label_new_with_mnemonic (label_text); gtk_misc_set_alignment (GTK_MISC (label), xalign, yalign); gtk_label_set_justify (GTK_LABEL (label), GTK_JUSTIFY_RIGHT); gtk_table_attach (table, label, column, column + 1, row, row + 1, GTK_FILL, GTK_FILL, 0, 0); gtk_widget_show (label); gtk_label_set_mnemonic_widget (GTK_LABEL (label), widget); } if (left_align) { GtkWidget *alignment; alignment = gtk_alignment_new (0.0, 0.5, 0.0, 0.0); gtk_container_add (GTK_CONTAINER (alignment), widget); gtk_widget_show (widget); widget = alignment; } gtk_table_attach (table, widget, column + 1, column + 1 + colspan, row, row + 1, GTK_EXPAND | GTK_FILL, GTK_EXPAND | GTK_FILL, 0, 0); gtk_widget_show (widget); return label; }