gimp_number_pair_entry_new ()

GtkWidget *
gimp_number_pair_entry_new (const gchar *separators,
                            gboolean allow_simplification,
                            gdouble min_valid_value,
                            gdouble max_valid_value);

Creates a new GimpNumberPairEntry widget, which is a GtkEntry that accepts two numbers separated by a separator. Typical input example with a 'x' separator: "377x233".

The widget supports simplification of the entered ratio when the input ends in '=', if "allow-simplification" is TRUE.

The "separators" property contains a string of characters valid as separators when parsing input. The first separator is used when displaying the current values.

It is possible to specify what range of values that shall be considered as valid when parsing user input, by changing "min-valid-value" and "max-valid-value".

The first separator of separators is used to display the current value.

Since: GIMP 2.4

gimp_number_pair_entry_set_default_values ()

void
gimp_number_pair_entry_set_default_values
                               (GimpNumberPairEntry *entry,
                                gdouble left,
                                gdouble right);

Since: GIMP 2.4

gimp_number_pair_entry_get_default_values ()

void
gimp_number_pair_entry_get_default_values
                               (GimpNumberPairEntry *entry,
                                gdouble *left,
                                gdouble *right);

Since: GIMP 2.4

gimp_number_pair_entry_set_values ()

void
gimp_number_pair_entry_set_values (GimpNumberPairEntry *entry,
                                   gdouble left,
                                   gdouble right);

Forces setting the numbers displayed by a GimpNumberPairEntry, ignoring if the user has set his/her own value. The state of user-override will not be changed.

Since: GIMP 2.4

gimp_number_pair_entry_get_values ()

void
gimp_number_pair_entry_get_values (GimpNumberPairEntry *entry,
                                   gdouble *left,
                                   gdouble *right);

Gets the numbers displayed by a GimpNumberPairEntry.

Since: GIMP 2.4

gimp_number_pair_entry_get_aspect ()

GimpAspectType
gimp_number_pair_entry_get_aspect (GimpNumberPairEntry *entry);

Gets the aspect of the ratio displayed by a GimpNumberPairEntry.

Since: GIMP 2.4

gimp_number_pair_entry_set_aspect ()

void
gimp_number_pair_entry_set_aspect (GimpNumberPairEntry *entry,
                                   GimpAspectType aspect);

Sets the aspect of the ratio by swapping the left_number and right_number if necessary (or setting them to 1.0 in case that aspect is GIMP_ASPECT_SQUARE).

Since: GIMP 2.4

gimp_number_pair_entry_get_ratio ()

gdouble
gimp_number_pair_entry_get_ratio (GimpNumberPairEntry *entry);

Retrieves the ratio of the numbers displayed by a GimpNumberPairEntry.

Since: GIMP 2.4

gimp_number_pair_entry_set_ratio ()

void
gimp_number_pair_entry_set_ratio (GimpNumberPairEntry *entry,
                                  gdouble ratio);

Sets the numbers of the GimpNumberPairEntry to have the desired ratio. If the new ratio is different than the previous ratio, the "ratio-changed" signal is emitted.

An attempt is made to convert the decimal number into a fraction with left_number and right_number < 1000.

Since: GIMP 2.4

gimp_number_pair_entry_get_user_override ()

gboolean
gimp_number_pair_entry_get_user_override
                               (GimpNumberPairEntry *entry);

Since: GIMP 2.4

gimp_number_pair_entry_set_user_override ()

void
gimp_number_pair_entry_set_user_override
                               (GimpNumberPairEntry *entry,
                                gboolean user_override);

When the entry is not in user overridden mode, the values will change when the default values are changed. When in user overridden mode, setting default values will not affect the active values.

Since: GIMP 2.4

gimp_number_pair_entry_get_default_text ()

const gchar *
gimp_number_pair_entry_get_default_text
                               (GimpNumberPairEntry *entry);

Since: GIMP 2.4

gimp_number_pair_entry_set_default_text ()

void
gimp_number_pair_entry_set_default_text
                               (GimpNumberPairEntry *entry,
                                const gchar *string);

Causes the entry to show a given string when in automatic mode, instead of the default numbers. The only thing this does is making the GimpNumberPairEntry showing this string, the internal state and API calls are not affected.

Set the default string to NULL to display default values as normal.

Since: GIMP 2.4

GimpNumberPairEntry

typedef struct _GimpNumberPairEntry GimpNumberPairEntry;

enum GimpAspectType

Aspect ratios.

The “allow-simplification” property

  “allow-simplification”     gboolean

Whether to allow simplification.

Flags: Read / Write

Default value: FALSE

The “aspect” property

  “aspect”                   GimpAspectType

Flags: Read / Write

Default value: GIMP_ASPECT_SQUARE

The “default-left-number” property

  “default-left-number”      gdouble

Flags: Read / Write

Allowed values: >= G_MINDOUBLE

Default value: 100

The “default-right-number” property

  “default-right-number”     gdouble

Flags: Read / Write

Allowed values: >= G_MINDOUBLE

Default value: 100

The “default-text” property

  “default-text”             gchar *

String to show when in automatic mode.

Flags: Read / Write

Default value: NULL

The “left-number” property

  “left-number”              gdouble

Flags: Read / Write

Allowed values: >= G_MINDOUBLE

Default value: 100

The “max-valid-value” property

  “max-valid-value”          gdouble

Maximum value valid when parsing input.

Flags: Read / Write

Allowed values: >= G_MINDOUBLE

Default value: 1.79769e+308

The “min-valid-value” property

  “min-valid-value”          gdouble

Minimum value valid when parsing input.

Flags: Read / Write

Allowed values: >= G_MINDOUBLE

Default value: 2.22507e-308

The “ratio” property

  “ratio”                    gdouble

Flags: Read / Write

Allowed values: >= G_MINDOUBLE

Default value: 1

The “right-number” property

  “right-number”             gdouble

Flags: Read / Write

Allowed values: >= G_MINDOUBLE

Default value: 100

The “separators” property

  “separators”               gchar *

A string of valid separators.

Flags: Read / Write / Construct Only

Default value: NULL

The “user-override” property

  “user-override”            gboolean

Whether the widget is in 'user override' mode.

Flags: Read / Write

Default value: FALSE

The “numbers-changed” signal

void
user_function (GimpNumberPairEntry *gimpnumberpairentry,
               gpointer             user_data)

Flags: Run First

The “ratio-changed” signal

void
user_function (GimpNumberPairEntry *gimpnumberpairentry,
               gpointer             user_data)

Flags: Run First