GimpWidgetsUtils: GIMP Widgets Library Reference Manual

+ + +

GimpWidgetsUtils

GimpWidgetsUtils — A collection of helper functions.

Functions

++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+GtkWidget * +	+gimp_table_attach_aligned () +
+void +	+gimp_label_set_attributes () +
+gint +	+gimp_widget_get_monitor () +
+gint +	+gimp_get_monitor_at_pointer () +
+void +	+gimp_widget_track_monitor () +
+GimpColorProfile * +	+gimp_screen_get_color_profile () +
+GimpColorProfile * +	+gimp_widget_get_color_profile () +
+GimpColorTransform * +	+gimp_widget_get_color_transform () +

Description

A collection of helper functions.

Functions

gimp_table_attach_aligned ()

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);

Note that the label_text + can be NULL and that the widget will be +attached starting at (column + + 1) in this case, too.

Parameters

+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

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 vertical 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.

Returns

The created GtkLabel.

gimp_label_set_attributes ()

void
+gimp_label_set_attributes (GtkLabel *label,
+                           ...);

Sets Pango attributes on a GtkLabel in a more convenient way than +gtk_label_set_attributes().

This function is useful if you want to change the font attributes +of a GtkLabel. This is an alternative to using PangoMarkup which +is slow to parse and awkward to handle in an i18n-friendly way.

The attributes are set on the complete label, from start to end. If +you need to set attributes on part of the label, you will have to +use the PangoAttributes API directly.

Parameters

+++++ + + + + + + + + + + + + +

label	a GtkLabel
...	a list of PangoAttrType and value pairs terminated by -1.

Since: 2.2

gimp_widget_get_monitor ()

gint
+gimp_widget_get_monitor (GtkWidget *widget);

gimp_get_monitor_at_pointer ()

gint
+gimp_get_monitor_at_pointer (GdkScreen **screen);

gimp_widget_track_monitor ()

void
+gimp_widget_track_monitor (GtkWidget *widget,
+                           GCallback monitor_changed_callback,
+                           gpointer user_data);

This function behaves as if GtkWidget had a signal

GtkWidget::monitor_changed(GtkWidget *widget, gpointer user_data)

That is emitted whenever widget +'s toplevel window is moved from +one monitor to another. This function automatically connects to +the right toplevel GtkWindow, even across moving widget + between +toplevel windows.

Note that this function tracks the toplevel, not widget + itself, so +all a window's widgets are always considered to be on the same +monitor. This is because this function is mainly used for fetching +the new monitor's color profile, and it makes little sense to use +different profiles for the widgets of one window.

Parameters

+++++ + + + + + + + + + + + + + + + + + +

widget	a GtkWidget
monitor_changed_callback	the callback when `widget` +'s monitor changes
user_data	data passed to `monitor_changed_callback` +

Since: 2.10

gimp_screen_get_color_profile ()

GimpColorProfile *
+gimp_screen_get_color_profile (GdkScreen *screen,
+                               gint monitor);

This function returns the GimpColorProfile of monitor number monitor + +of screen +, or NULL if there is no profile configured.

Parameters

+++++ + + + + + + + + + + + + +

screen	a GdkScreen
monitor	the monitor number

Returns

the monitor's GimpColorProfile, or NULL.

Since: 2.10

gimp_widget_get_color_profile ()

GimpColorProfile *
+gimp_widget_get_color_profile (GtkWidget *widget);

gimp_widget_get_color_transform ()

GimpColorTransform *
+gimp_widget_get_color_transform (GtkWidget *widget,
+                                 GimpColorConfig *config,
+                                 GimpColorProfile *src_profile,
+                                 const Babl *src_format,
+                                 const Babl *dest_format);