dnrops
/
gimp
mirror of https://github.com/GNOME/gimp.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
gimp/libgimpwidgets/gimplabelspin.h

75 lines
2.7 KiB
C
Raw Normal View History

libgimpwidgets: new GimpLabeled class and GimpLabelSpin subclass. There is currently no property widget which just creates a GimpSpinButton with a label. Just as the GimpScaleEntry was needed, this one is as well. I am creating a GimpLabeled abstract class which will represent various widgets with a label. While this may seem a bit over-engineered for such a basic feature, this will actually bring some consistency and a common parent. In particular this can be used to get the GtkLabel with a common interface to add them all in a common GtkSizeGroup when generating dialogs automatically, hence make dialogs with properly aligned labels and edition widgets.
2020-11-05 08:13:49 +08:00
/* LIBGIMP - The GIMP Library
* Copyright (C) 1995-1997 Peter Mattis and Spencer Kimball
*
* gimpcolorscaleentry.h
* Copyright (C) 2020 Jehan
*
* 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 3 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
* Lesser 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, see
* <https://www.gnu.org/licenses/>.
*/
#if !defined (__GIMP_WIDGETS_H_INSIDE__) && !defined (GIMP_WIDGETS_COMPILATION)
#error "Only <libgimpwidgets/gimpwidgets.h> can be included directly."
#endif
#ifndef __GIMP_LABEL_SPIN_H__
#define __GIMP_LABEL_SPIN_H__
#include <libgimpwidgets/gimplabeled.h>
G_BEGIN_DECLS
#define GIMP_TYPE_LABEL_SPIN (gimp_label_spin_get_type ())
G_DECLARE_DERIVABLE_TYPE (GimpLabelSpin, gimp_label_spin, GIMP, LABEL_SPIN, GimpLabeled)
struct _GimpLabelSpinClass
{
GimpLabeledClass parent_class;
/* Signals */
void (* value_changed) (GimpLabelSpin *spin);
/* Padding for future expansion */
void (* _gimp_reserved1) (void);
void (* _gimp_reserved2) (void);
void (* _gimp_reserved3) (void);
void (* _gimp_reserved4) (void);
void (* _gimp_reserved5) (void);
void (* _gimp_reserved6) (void);
void (* _gimp_reserved7) (void);
void (* _gimp_reserved8) (void);
};
GtkWidget * gimp_label_spin_new (const gchar *text,
gdouble value,
gdouble lower,
gdouble upper,
libgimp, libgimpbase, libgimpwidgets: new gimp_range_estimate_settings() Similar code was used in 2 places basically (GimpLabelSpin and GimpProcedureDialog) so just make it an utils function. It's good anyway to have a generic function to estimate suitable increments and decimal places depending on a range. As a consequence also gimp_label_spin_new() now takes a gint digits (instead of guint), with -1 meaning we want digits computed from the range. Similarly gimp_prop_scale_entry_new() docs adds the -1 meaning too.
2020-11-25 08:16:34 +08:00
gint digits);
libgimpwidgets: new GimpLabeled class and GimpLabelSpin subclass. There is currently no property widget which just creates a GimpSpinButton with a label. Just as the GimpScaleEntry was needed, this one is as well. I am creating a GimpLabeled abstract class which will represent various widgets with a label. While this may seem a bit over-engineered for such a basic feature, this will actually bring some consistency and a common parent. In particular this can be used to get the GtkLabel with a common interface to add them all in a common GtkSizeGroup when generating dialogs automatically, hence make dialogs with properly aligned labels and edition widgets.
2020-11-05 08:13:49 +08:00
void gimp_label_spin_set_value (GimpLabelSpin *spin,
gdouble value);
gdouble gimp_label_spin_get_value (GimpLabelSpin *spin);
void gimp_label_spin_set_increments (GimpLabelSpin *spin,
gdouble step,
gdouble page);
libgimpwidgets: improved gimp_prop_scale_entry_new(), new function… … gimp_label_spin_set_digits() and deleted gimp_prop_opacity_entry_new() - The "digits" argument for the number of decimal places in gimp_prop_scale_entry_new() is now mostly useless since GimpLabelSpin (hence GimpScaleEntry too) got a nice estimation algorithm of sensible values. - Add gimp_label_spin_set_digits() function to manually set the digits property when we don't like the estimated value. - Also add a new "factor" argument to gimp_prop_scale_entry_new(). Its role is to allow a GimpScaleEntry showing a factored range, typically a [0, 100] range for some types of [0, 1] properties. - Remove gimp_prop_opacity_entry_new() which was basically a special-case of gimp_prop_scale_entry_new() and which can now be easily reproduced by simply set factor=100.0. - Update all usage of gimp_prop_scale_entry_new() in app/ and plug-ins/ with updated arguments. It is interesting to note that all existing usage were either integers (digits=1) or when double, the estimated decimal places are the same as the ones which were manually set (hence showing the generic estimation is not too bad). So the new function gimp_label_spin_set_digits() was not even needed once in current code.
2020-11-25 09:19:39 +08:00
void gimp_label_spin_set_digits (GimpLabelSpin *spin,
gint digits);
libgimpwidgets: new GimpLabeled class and GimpLabelSpin subclass. There is currently no property widget which just creates a GimpSpinButton with a label. Just as the GimpScaleEntry was needed, this one is as well. I am creating a GimpLabeled abstract class which will represent various widgets with a label. While this may seem a bit over-engineered for such a basic feature, this will actually bring some consistency and a common parent. In particular this can be used to get the GtkLabel with a common interface to add them all in a common GtkSizeGroup when generating dialogs automatically, hence make dialogs with properly aligned labels and edition widgets.
2020-11-05 08:13:49 +08:00
GtkWidget * gimp_label_spin_get_spin_button (GimpLabelSpin *spin);
G_END_DECLS
#endif /* __GIMP_LABEL_SPIN_H__ */