Constructor
GimpUnitnew
Declaration [src]
GimpUnit
gimp_unit_new (
gchar* identifier,
gdouble factor,
gint digits,
gchar* symbol,
gchar* abbreviation,
gchar* singular,
gchar* plural
)
Description [src]
Returns the integer ID of the new GimpUnit.
Note that a new unit is always created with its 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.
Parameters
identifier-
Type:
gchar*The unit’s identifier string.
The data is owned by the caller of the function. The value is a NUL terminated UTF-8 string. factor-
Type:
gdoubleThe unit’s factor (how many units are in one inch).
digits-
Type:
gintThe unit’s suggested number of digits (see gimp_unit_get_digits()).
symbol-
Type:
gchar*The symbol of the unit (e.g. “”” for inch).
The data is owned by the caller of the function. The value is a NUL terminated UTF-8 string. abbreviation-
Type:
gchar*The abbreviation of the unit.
The data is owned by the caller of the function. The value is a NUL terminated UTF-8 string. singular-
Type:
gchar*The singular form of the unit.
The data is owned by the caller of the function. The value is a NUL terminated UTF-8 string. plural-
Type:
gchar*The plural form of the unit.
The data is owned by the caller of the function. The value is a NUL terminated UTF-8 string.
Return value
Type: GimpUnit
The ID of the new unit.