GimpWidgets

GimpWidgets — A collection of convenient widget constructors, standard callbacks and helper functions.

Functions

Types and Values

Description

A collection of convenient widget constructors, standard callbacks and helper functions.

Functions

gimp_int_radio_group_new ()

GtkWidget *
gimp_int_radio_group_new (gboolean in_frame,
                          const gchar *frame_title,
                          GCallback radio_button_callback,
                          gpointer radio_button_callback_data,
                          GDestroyNotify radio_button_callback_destroy,
                          gint initial,
                          ...);

Convenience function to create a group of radio buttons embedded into a GtkFrame or GtkBox. This function does the same thing as gimp_radio_group_new2(), but it takes integers as item_data instead of pointers, since that is a very common case (mapping an enum to a radio group).

[skip]

Parameters

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.

[nullable]

radio_button_callback

The callback each button's "toggled" signal will be connected with.

[scope notified]

radio_button_callback_data

The data which will be passed to g_signal_connect().

[closure radio_button_callback]

radio_button_callback_destroy

.

[destroy radio_button_callback_data]

initial

The item_data of the initially pressed radio button.

 

...

A NULL-terminated va_list describing the radio buttons.

 

Returns

A GtkFrame or GtkBox (depending on in_frame ).

[transfer full]


gimp_int_radio_group_set_active ()

void
gimp_int_radio_group_set_active (GtkRadioButton *radio_button,
                                 gint item_data);

Calls gtk_toggle_button_set_active() with the radio button that was created with a matching item_data . This function does the same thing as gimp_radio_group_set_active(), but takes integers as item_data instead of pointers.

Parameters

radio_button

Pointer to a GtkRadioButton.

 

item_data

The item_data of the radio button you want to select.

 

gimp_spin_button_new ()

GtkWidget *
gimp_spin_button_new (GtkAdjustment *adjustment,
                      gdouble climb_rate,
                      guint digits);

Creates a new GimpSpinButton.

Parameters

adjustment

the GtkAdjustment object that this spin button should use, or NULL.

[allow-none]

climb_rate

specifies by how much the rate of change in the value will accelerate if you continue to hold down an up/down button or arrow key

 

digits

the number of decimal places to display

 

Returns

The new spin button as a GtkWidget

Since: 2.10.10


gimp_scale_entry_new ()

GtkWidget *
gimp_scale_entry_new (const gchar *text,
                      gdouble value,
                      gdouble lower,
                      gdouble upper,
                      guint digits);

This function creates a GtkLabel, a GtkHScale and a GtkSpinButton and attaches them to a 3-column GtkGrid.

Parameters

text

The text for the GtkLabel which will appear left of the GtkHScale.

 

value

The initial value.

 

lower

The lower boundary.

 

upper

The upper boundary.

 

digits

The number of decimal digits.

 

Returns

The new GimpScaleEntry.

[transfer full]


gimp_scale_entry_set_logarithmic ()

void
gimp_scale_entry_set_logarithmic (GimpScaleEntry *entry,
                                  gboolean logarithmic);

Sets whether entry 's scale widget will behave in a linear or logarithmic fashion. Useful when an entry has to attend large ranges, but smaller selections on that range require a finer adjustment.

Parameters

entry

a GimpScaleEntry as returned by gimp_scale_entry_new()

 

logarithmic

a boolean value to set or reset logarithmic behaviour of the scale widget

 

Since: 2.2


gimp_scale_entry_get_logarithmic ()

gboolean
gimp_scale_entry_get_logarithmic (GimpScaleEntry *entry);

Parameters

entry

a GimpScaleEntry as returned by gimp_scale_entry_new()

 

Returns

TRUE if entry 's scale widget will behave in logarithmic fashion, FALSE for linear behaviour.

Since: 2.2


gimp_color_scale_entry_new ()

GtkWidget *
gimp_color_scale_entry_new (const gchar *text,
                            gdouble value,
                            gdouble lower,
                            gdouble upper,
                            guint digits);

Parameters

text

The text for the GtkLabel.

 

value

The initial value.

 

lower

The lower boundary.

 

upper

The upper boundary.

 

digits

The number of decimal digits.

 

Returns

The new GimpColorScale widget.

[transfer full]


GIMP_RANDOM_SEED_SPINBUTTON()

#define             GIMP_RANDOM_SEED_SPINBUTTON(hbox)

Parameters

hbox

The GtkBox returned by gimp_random_seed_new().

 

Returns

the random_seed's GtkSpinButton.


GIMP_RANDOM_SEED_SPINBUTTON_ADJ()

#define             GIMP_RANDOM_SEED_SPINBUTTON_ADJ(hbox)

Parameters

hbox

The GtkBox returned by gimp_random_seed_new().

 

Returns

the GtkAdjustment of the random_seed's GtkSpinButton.


GIMP_RANDOM_SEED_TOGGLE()

#define             GIMP_RANDOM_SEED_TOGGLE(hbox)

Parameters

hbox

The GtkBox returned by gimp_random_seed_new().

 

Returns

the random_seed's GtkToggleButton.


gimp_random_seed_new ()

GtkWidget *
gimp_random_seed_new (guint32 *seed,
                      gboolean *random_seed);

Creates a widget that allows the user to control how the random number generator is initialized.

Parameters

seed

A pointer to the variable which stores the random seed.

 

random_seed

A pointer to a boolean indicating whether seed should be initialised randomly or not.

 

Returns

A GtkBox containing a GtkSpinButton for the seed and a GtkButton for setting a random seed.

[transfer full]


GIMP_COORDINATES_CHAINBUTTON()

#define             GIMP_COORDINATES_CHAINBUTTON(sizeentry)

Parameters

sizeentry

The GimpSizeEntry returned by gimp_coordinates_new().

 

Returns

the GimpChainButton which is attached to the GimpSizeEntry.


gimp_coordinates_new ()

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

Convenience function that creates 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.

Parameters

unit

The initial unit of the GimpUnitMenu.

 

unit_format

A printf-like unit-format string as is used with gimp_unit_menu_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

The new GimpSizeEntry.

[transfer full]


gimp_toggle_button_update ()

void
gimp_toggle_button_update (GtkWidget *widget,
                           gpointer data);

Parameters

widget

A GtkToggleButton.

 

data

A pointer to a gint variable which will store the value of gtk_toggle_button_get_active().

 

gimp_radio_button_update ()

void
gimp_radio_button_update (GtkWidget *widget,
                          gpointer data);

Parameters

widget

A GtkRadioButton.

 

data

A pointer to a gint variable which will store the value of GPOINTER_TO_INT (g_object_get_data (widget , "gimp-item-data")).

 

gimp_int_adjustment_update ()

void
gimp_int_adjustment_update (GtkAdjustment *adjustment,
                            gpointer data);

Note that the GtkAdjustment's value (which is a gdouble) will be rounded with RINT().

Parameters

adjustment

A GtkAdjustment.

 

data

A pointer to a gint variable which will store the adjustment 's value.

 

gimp_uint_adjustment_update ()

void
gimp_uint_adjustment_update (GtkAdjustment *adjustment,
                             gpointer data);

Note that the GtkAdjustment's value (which is a gdouble) will be rounded with (guint) (value + 0.5).

Parameters

adjustment

A GtkAdjustment.

 

data

A pointer to a guint variable which will store the adjustment 's value.

 

gimp_float_adjustment_update ()

void
gimp_float_adjustment_update (GtkAdjustment *adjustment,
                              gpointer data);

Parameters

adjustment

A GtkAdjustment.

 

data

A pointer to a gfloat variable which will store the adjustment 's value.

 

gimp_double_adjustment_update ()

void
gimp_double_adjustment_update (GtkAdjustment *adjustment,
                               gpointer data);

Parameters

adjustment

A GtkAdjustment.

 

data

A pointer to a gdouble variable which will store the adjustment 's value.

 

gimp_widgets_error_quark ()

GQuark
gimp_widgets_error_quark (void);

This function is never called directly. Use GIMP_WIDGETS_ERROR() instead.

Returns

the GQuark that defines the GIMP widgets error domain.

Types and Values

enum GimpWidgetsError

Types of errors returned by libgimpwidgets functions

Members

GIMP_WIDGETS_PARSE_ERROR

A parse error has occurred

 

GIMP_WIDGETS_ERROR

#define GIMP_WIDGETS_ERROR (gimp_widgets_error_quark ())

The GIMP widgets error domain.

Since: 2.8