| Top |
gimpunitgimpunit — Provides a collection of predefined units and functions for creating user-defined units. |
| gint | gimp_unit_get_number_of_units () |
| gint | gimp_unit_get_number_of_built_in_units () |
| GimpUnit | gimp_unit_new () |
| gboolean | gimp_unit_get_deletion_flag () |
| void | gimp_unit_set_deletion_flag () |
| gdouble | gimp_unit_get_factor () |
| gint | gimp_unit_get_digits () |
| const gchar * | gimp_unit_get_identifier () |
| const gchar * | gimp_unit_get_symbol () |
| const gchar * | gimp_unit_get_abbreviation () |
| const gchar * | gimp_unit_get_singular () |
| const gchar * | gimp_unit_get_plural () |
| gchar * | gimp_unit_format_string () |
| gdouble | gimp_pixels_to_units () |
| gdouble | gimp_units_to_pixels () |
| gdouble | gimp_units_to_points () |
| #define | GIMP_TYPE_UNIT |
| #define | GIMP_TYPE_PARAM_UNIT |
| #define | GIMP_IS_PARAM_SPEC_UNIT() |
| GParamSpec * | gimp_param_spec_unit () |
| #define | GIMP_VALUE_HOLDS_UNIT() |
Provides a collection of predefined units and functions for creating user-defined units.
gint
gimp_unit_get_number_of_units (void);
Returns the number of units which are known to the GimpUnit system.
gint
gimp_unit_get_number_of_built_in_units
(void);
Returns the number of GimpUnit's which are hardcoded in the unit system (UNIT_INCH, UNIT_MM, UNIT_POINT, UNIT_PICA and the two "pseudo unit" UNIT_PIXEL).
GimpUnit gimp_unit_new (gchar *identifier,gdouble factor,gint digits,gchar *symbol,gchar *abbreviation,gchar *singular,gchar *plural);
Returns the integer ID of the new GimpUnit.
Note that a new unit is always created with it's deletion flag
set to TRUE. You will have to set it to FALSE with
gimp_unit_set_deletion_flag() to make the unit definition persistent.
identifier |
The unit's identifier string. |
|
factor |
The unit's factor (how many units are in one inch). |
|
digits |
The unit's suggested number of digits (see |
|
symbol |
The symbol of the unit (e.g. "''" for inch). |
|
abbreviation |
The abbreviation of the unit. |
|
singular |
The singular form of the unit. |
|
plural |
The plural form of the unit. |
void gimp_unit_set_deletion_flag (GimpUnit unit,gboolean deletion_flag);
Sets a GimpUnit's deletion_flag
. If the deletion_flag
of a unit is
TRUE when GIMP exits, this unit will not be saved in the users's
"unitrc" file.
Trying to change the deletion_flag
of a built-in unit will be silently
ignored.
gdouble
gimp_unit_get_factor (GimpUnit unit);
A GimpUnit's factor
is defined to be:
distance_in_units == (factor
* distance_in_inches)
Returns 0 for unit
== GIMP_UNIT_PIXEL.
gint
gimp_unit_get_digits (GimpUnit unit);
Returns the number of digits an entry field should provide to get approximately the same accuracy as an inch input field with two digits.
Returns 0 for unit
== GIMP_UNIT_PIXEL.
const gchar *
gimp_unit_get_identifier (GimpUnit unit);
This is an unstranslated string and must not be changed or freed.
const gchar *
gimp_unit_get_symbol (GimpUnit unit);
This is e.g. "''" for UNIT_INCH.
NOTE: This string must not be changed or freed.
const gchar *
gimp_unit_get_abbreviation (GimpUnit unit);
For built-in units, this function returns the translated abbreviation of the unit.
NOTE: This string must not be changed or freed.
const gchar *
gimp_unit_get_singular (GimpUnit unit);
For built-in units, this function returns the translated singular form of the unit's name.
NOTE: This string must not be changed or freed.
const gchar *
gimp_unit_get_plural (GimpUnit unit);
For built-in units, this function returns the translated plural form of the unit's name.
NOTE: This string must not be changed or freed.
gchar * gimp_unit_format_string (const gchar *format,GimpUnit unit);
The format
string supports the following percent expansions:
| % f | Factor (how many units make up an inch) |
| % y | Symbol (e.g. "''" for GIMP_UNIT_INCH) |
| % a | Abbreviation |
| % s | Singular |
| % p | Plural |
| %% | Literal percent |
A newly allocated string with above percent expressions
replaced with the resp. strings for unit
.
Since: GIMP 2.8
gdouble gimp_pixels_to_units (gdouble pixels,GimpUnit unit,gdouble resolution);
Converts a value
specified in pixels to unit
.
Since: GIMP 2.8
gdouble gimp_units_to_pixels (gdouble value,GimpUnit unit,gdouble resolution);
Converts a value
specified in unit
to pixels.
Since: GIMP 2.8
gdouble gimp_units_to_points (gdouble value,GimpUnit unit,gdouble resolution);
Converts a value
specified in unit
to points.
Since: GIMP 2.8
#define GIMP_TYPE_UNIT (gimp_unit_get_type ())
GIMP_TYPE_UNIT is a GType derived from G_TYPE_INT.
#define GIMP_IS_PARAM_SPEC_UNIT(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), GIMP_TYPE_PARAM_UNIT))
GParamSpec * gimp_param_spec_unit (const gchar *name,const gchar *nick,const gchar *blurb,gboolean allow_pixels,gboolean allow_percent,GimpUnit default_value,GParamFlags flags);
Creates a param spec to hold a units param.
See g_param_spec_internal() for more information.
name |
Canonical name of the param |
|
nick |
Nickname of the param |
|
blurb |
Brief desciption of param. |
|
allow_pixels |
Whether "pixels" is an allowed unit. |
|
allow_percent |
Whether "perecent" is an allowed unit. |
|
default_value |
Unit to use if none is assigned. |
|
flags |
a combination of GParamFlags |
Since: GIMP 2.4