2003-10-01 07:19:48 +08:00
|
|
|
/* LIBGIMP - The GIMP Library
|
|
|
|
* Copyright (C) 1995-1997 Peter Mattis and Spencer Kimball
|
2000-02-26 11:41:06 +08:00
|
|
|
*
|
|
|
|
* gimpsizeentry.h
|
|
|
|
* Copyright (C) 1999-2000 Sven Neumann <sven@gimp.org>
|
2003-10-01 07:19:48 +08:00
|
|
|
* Michael Natterer <mitch@gimp.org>
|
1998-12-05 11:38:13 +08:00
|
|
|
*
|
2009-01-18 06:28:01 +08:00
|
|
|
* This library is free software: you can redistribute it and/or
|
1999-11-18 05:13:50 +08:00
|
|
|
* modify it under the terms of the GNU Lesser General Public
|
1998-12-05 11:38:13 +08:00
|
|
|
* License as published by the Free Software Foundation; either
|
2009-01-18 06:28:01 +08:00
|
|
|
* version 3 of the License, or (at your option) any later version.
|
2000-02-26 11:41:06 +08:00
|
|
|
*
|
|
|
|
* 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
|
1999-12-26 15:54:39 +08:00
|
|
|
* Lesser General Public License for more details.
|
1998-12-05 11:38:13 +08:00
|
|
|
*
|
1999-11-18 05:13:50 +08:00
|
|
|
* You should have received a copy of the GNU Lesser General Public
|
2009-01-18 06:28:01 +08:00
|
|
|
* License along with this library. If not, see
|
2018-07-12 05:27:07 +08:00
|
|
|
* <https://www.gnu.org/licenses/>.
|
1999-02-25 02:30:58 +08:00
|
|
|
*/
|
2000-05-31 07:38:46 +08:00
|
|
|
|
2011-04-28 20:30:41 +08:00
|
|
|
#if !defined (__GIMP_WIDGETS_H_INSIDE__) && !defined (GIMP_WIDGETS_COMPILATION)
|
|
|
|
#error "Only <libgimpwidgets/gimpwidgets.h> can be included directly."
|
|
|
|
#endif
|
|
|
|
|
1999-02-25 02:30:58 +08:00
|
|
|
#ifndef __GIMP_SIZE_ENTRY_H__
|
|
|
|
#define __GIMP_SIZE_ENTRY_H__
|
1998-12-05 11:38:13 +08:00
|
|
|
|
2001-11-23 07:46:13 +08:00
|
|
|
G_BEGIN_DECLS
|
1998-12-05 11:38:13 +08:00
|
|
|
|
2000-05-31 07:38:46 +08:00
|
|
|
/* For information look into the C source or the html documentation */
|
|
|
|
|
|
|
|
|
2024-08-01 11:55:31 +08:00
|
|
|
#define GIMP_TYPE_SIZE_ENTRY (gimp_size_entry_get_type ())
|
|
|
|
G_DECLARE_DERIVABLE_TYPE (GimpSizeEntry, gimp_size_entry, GIMP, SIZE_ENTRY, GtkGrid)
|
1998-12-05 11:38:13 +08:00
|
|
|
|
|
|
|
struct _GimpSizeEntryClass
|
|
|
|
{
|
2018-05-03 02:23:05 +08:00
|
|
|
GtkGridClass parent_class;
|
1998-12-05 11:38:13 +08:00
|
|
|
|
1999-06-18 03:13:08 +08:00
|
|
|
void (* value_changed) (GimpSizeEntry *gse);
|
|
|
|
void (* refval_changed) (GimpSizeEntry *gse);
|
|
|
|
void (* unit_changed) (GimpSizeEntry *gse);
|
2004-01-29 08:21:33 +08:00
|
|
|
|
|
|
|
/* Padding for future expansion */
|
|
|
|
void (* _gimp_reserved1) (void);
|
|
|
|
void (* _gimp_reserved2) (void);
|
|
|
|
void (* _gimp_reserved3) (void);
|
|
|
|
void (* _gimp_reserved4) (void);
|
2018-05-03 18:51:36 +08:00
|
|
|
void (* _gimp_reserved5) (void);
|
|
|
|
void (* _gimp_reserved6) (void);
|
|
|
|
void (* _gimp_reserved7) (void);
|
|
|
|
void (* _gimp_reserved8) (void);
|
1998-12-05 11:38:13 +08:00
|
|
|
};
|
|
|
|
|
2001-08-04 03:52:08 +08:00
|
|
|
|
2000-02-08 04:35:13 +08:00
|
|
|
/* For information look into the C source or the html documentation */
|
|
|
|
|
|
|
|
GtkWidget * gimp_size_entry_new (gint number_of_fields,
|
Issue #8900 and #9923: reimplementing GimpUnit as a proper class.
This fixes all our GObject Introspection issues with GimpUnit which was
both an enum and an int-derived type of user-defined units *completing*
the enum values. GIR clearly didn't like this!
Now GimpUnit is a proper class and units are unique objects, allowing to
compare them with an identity test (i.e. `unit == gimp_unit_pixel ()`
tells us if unit is the pixel unit or not), which makes it easy to use,
just like with int, yet adding also methods, making for nicer
introspected API.
As an aside, this also fixes #10738, by having all the built-in units
retrievable even if libgimpbase had not been properly initialized with
gimp_base_init().
I haven't checked in details how GIR works to introspect, but it looks
like it loads the library to inspect and runs functions, hence
triggering some CRITICALS because virtual methods (supposed to be
initialized with gimp_base_init() run by libgimp) are not set. This new
code won't trigger any critical because the vtable method are now not
necessary, at least for all built-in units.
Note that GimpUnit is still in libgimpbase. It could have been moved to
libgimp in order to avoid any virtual method table (since we need to
keep core and libgimp side's units in sync, PDB is required), but too
many libgimpwidgets widgets were already using GimpUnit. And technically
most of GimpUnit logic doesn't require PDB (only the creation/sync
part). This is one of the reasons why user-created GimpUnit list is
handled and stored differently from other types of objects.
Globally this simplifies the code a lot too and we don't need separate
implementations of various utils for core and libgimp, which means less
prone to errors.
2024-07-26 02:55:21 +08:00
|
|
|
GimpUnit *unit,
|
2006-04-12 18:53:28 +08:00
|
|
|
const gchar *unit_format,
|
|
|
|
gboolean menu_show_pixels,
|
|
|
|
gboolean menu_show_percent,
|
|
|
|
gboolean show_refval,
|
|
|
|
gint spinbutton_width,
|
|
|
|
GimpSizeEntryUpdatePolicy update_policy);
|
2000-02-08 04:35:13 +08:00
|
|
|
|
1999-04-03 03:46:59 +08:00
|
|
|
void gimp_size_entry_add_field (GimpSizeEntry *gse,
|
2006-04-12 18:53:28 +08:00
|
|
|
GtkSpinButton *value_spinbutton,
|
|
|
|
GtkSpinButton *refval_spinbutton);
|
1999-04-03 03:46:59 +08:00
|
|
|
|
2018-05-25 10:08:59 +08:00
|
|
|
GimpSizeEntryUpdatePolicy
|
|
|
|
gimp_size_entry_get_update_policy (GimpSizeEntry *gse);
|
|
|
|
gint gimp_size_entry_get_n_fields (GimpSizeEntry *gse);
|
|
|
|
GtkWidget * gimp_size_entry_get_unit_combo (GimpSizeEntry *gse);
|
|
|
|
|
2004-05-19 01:06:06 +08:00
|
|
|
GtkWidget * gimp_size_entry_attach_label (GimpSizeEntry *gse,
|
2006-04-12 18:53:28 +08:00
|
|
|
const gchar *text,
|
|
|
|
gint row,
|
|
|
|
gint column,
|
|
|
|
gfloat alignment);
|
1999-02-25 02:30:58 +08:00
|
|
|
|
|
|
|
void gimp_size_entry_set_resolution (GimpSizeEntry *gse,
|
2006-04-12 18:53:28 +08:00
|
|
|
gint field,
|
|
|
|
gdouble resolution,
|
|
|
|
gboolean keep_size);
|
1999-02-25 02:30:58 +08:00
|
|
|
|
1999-04-06 20:13:54 +08:00
|
|
|
void gimp_size_entry_set_size (GimpSizeEntry *gse,
|
2006-04-12 18:53:28 +08:00
|
|
|
gint field,
|
|
|
|
gdouble lower,
|
|
|
|
gdouble upper);
|
1999-04-06 20:13:54 +08:00
|
|
|
|
1999-02-25 02:30:58 +08:00
|
|
|
void gimp_size_entry_set_value_boundaries (GimpSizeEntry *gse,
|
2006-04-12 18:53:28 +08:00
|
|
|
gint field,
|
|
|
|
gdouble lower,
|
|
|
|
gdouble upper);
|
2000-02-08 04:35:13 +08:00
|
|
|
|
1999-05-23 01:56:35 +08:00
|
|
|
gdouble gimp_size_entry_get_value (GimpSizeEntry *gse,
|
2006-04-12 18:53:28 +08:00
|
|
|
gint field);
|
1999-02-25 02:30:58 +08:00
|
|
|
void gimp_size_entry_set_value (GimpSizeEntry *gse,
|
2006-04-12 18:53:28 +08:00
|
|
|
gint field,
|
|
|
|
gdouble value);
|
1999-02-25 02:30:58 +08:00
|
|
|
|
|
|
|
void gimp_size_entry_set_refval_boundaries (GimpSizeEntry *gse,
|
2006-04-12 18:53:28 +08:00
|
|
|
gint field,
|
|
|
|
gdouble lower,
|
|
|
|
gdouble upper);
|
1999-03-12 11:44:59 +08:00
|
|
|
void gimp_size_entry_set_refval_digits (GimpSizeEntry *gse,
|
2006-04-12 18:53:28 +08:00
|
|
|
gint field,
|
|
|
|
gint digits);
|
2000-02-08 04:35:13 +08:00
|
|
|
|
1999-05-23 01:56:35 +08:00
|
|
|
gdouble gimp_size_entry_get_refval (GimpSizeEntry *gse,
|
2006-04-12 18:53:28 +08:00
|
|
|
gint field);
|
1999-02-25 02:30:58 +08:00
|
|
|
void gimp_size_entry_set_refval (GimpSizeEntry *gse,
|
2006-04-12 18:53:28 +08:00
|
|
|
gint field,
|
|
|
|
gdouble refval);
|
1999-02-25 02:30:58 +08:00
|
|
|
|
Issue #8900 and #9923: reimplementing GimpUnit as a proper class.
This fixes all our GObject Introspection issues with GimpUnit which was
both an enum and an int-derived type of user-defined units *completing*
the enum values. GIR clearly didn't like this!
Now GimpUnit is a proper class and units are unique objects, allowing to
compare them with an identity test (i.e. `unit == gimp_unit_pixel ()`
tells us if unit is the pixel unit or not), which makes it easy to use,
just like with int, yet adding also methods, making for nicer
introspected API.
As an aside, this also fixes #10738, by having all the built-in units
retrievable even if libgimpbase had not been properly initialized with
gimp_base_init().
I haven't checked in details how GIR works to introspect, but it looks
like it loads the library to inspect and runs functions, hence
triggering some CRITICALS because virtual methods (supposed to be
initialized with gimp_base_init() run by libgimp) are not set. This new
code won't trigger any critical because the vtable method are now not
necessary, at least for all built-in units.
Note that GimpUnit is still in libgimpbase. It could have been moved to
libgimp in order to avoid any virtual method table (since we need to
keep core and libgimp side's units in sync, PDB is required), but too
many libgimpwidgets widgets were already using GimpUnit. And technically
most of GimpUnit logic doesn't require PDB (only the creation/sync
part). This is one of the reasons why user-created GimpUnit list is
handled and stored differently from other types of objects.
Globally this simplifies the code a lot too and we don't need separate
implementations of various utils for core and libgimp, which means less
prone to errors.
2024-07-26 02:55:21 +08:00
|
|
|
GimpUnit * gimp_size_entry_get_unit (GimpSizeEntry *gse);
|
2003-10-01 07:19:48 +08:00
|
|
|
void gimp_size_entry_set_unit (GimpSizeEntry *gse,
|
Issue #8900 and #9923: reimplementing GimpUnit as a proper class.
This fixes all our GObject Introspection issues with GimpUnit which was
both an enum and an int-derived type of user-defined units *completing*
the enum values. GIR clearly didn't like this!
Now GimpUnit is a proper class and units are unique objects, allowing to
compare them with an identity test (i.e. `unit == gimp_unit_pixel ()`
tells us if unit is the pixel unit or not), which makes it easy to use,
just like with int, yet adding also methods, making for nicer
introspected API.
As an aside, this also fixes #10738, by having all the built-in units
retrievable even if libgimpbase had not been properly initialized with
gimp_base_init().
I haven't checked in details how GIR works to introspect, but it looks
like it loads the library to inspect and runs functions, hence
triggering some CRITICALS because virtual methods (supposed to be
initialized with gimp_base_init() run by libgimp) are not set. This new
code won't trigger any critical because the vtable method are now not
necessary, at least for all built-in units.
Note that GimpUnit is still in libgimpbase. It could have been moved to
libgimp in order to avoid any virtual method table (since we need to
keep core and libgimp side's units in sync, PDB is required), but too
many libgimpwidgets widgets were already using GimpUnit. And technically
most of GimpUnit logic doesn't require PDB (only the creation/sync
part). This is one of the reasons why user-created GimpUnit list is
handled and stored differently from other types of objects.
Globally this simplifies the code a lot too and we don't need separate
implementations of various utils for core and libgimp, which means less
prone to errors.
2024-07-26 02:55:21 +08:00
|
|
|
GimpUnit *unit);
|
2005-03-10 06:22:38 +08:00
|
|
|
void gimp_size_entry_show_unit_menu (GimpSizeEntry *gse,
|
|
|
|
gboolean show);
|
1999-02-22 05:45:50 +08:00
|
|
|
|
2003-10-01 07:19:48 +08:00
|
|
|
void gimp_size_entry_set_pixel_digits (GimpSizeEntry *gse,
|
|
|
|
gint digits);
|
|
|
|
|
1999-03-15 02:03:58 +08:00
|
|
|
void gimp_size_entry_grab_focus (GimpSizeEntry *gse);
|
2005-02-10 00:57:18 +08:00
|
|
|
void gimp_size_entry_set_activates_default (GimpSizeEntry *gse,
|
|
|
|
gboolean setting);
|
2003-10-15 19:57:36 +08:00
|
|
|
GtkWidget * gimp_size_entry_get_help_widget (GimpSizeEntry *gse,
|
|
|
|
gint field);
|
1999-03-15 02:03:58 +08:00
|
|
|
|
2000-05-31 07:38:46 +08:00
|
|
|
|
2001-11-23 07:46:13 +08:00
|
|
|
G_END_DECLS
|
1998-12-05 11:38:13 +08:00
|
|
|
|
1999-02-25 02:30:58 +08:00
|
|
|
#endif /* __GIMP_SIZE_ENTRY_H__ */
|