gimpbasetypes

## gimpbasetypes gimpbasetypes — Translation between gettext translation domain identifier and GType. |

## Synopsis

                        GimpEnumDesc;
                        GimpFlagsDesc;
    void                gimp_type_set_translation_domain    (GType type,
                                                             const gchar *domain);
    const gchar*        gimp_type_get_translation_domain    (GType type);
    void                gimp_enum_set_value_descriptions    (GType enum_type,
                                                             const GimpEnumDesc *descriptions);
    const GimpEnumDesc* gimp_enum_get_value_descriptions    (GType enum_type);
    const GimpFlagsDesc* gimp_flags_get_value_descriptions  (GType flags_type);
    void                gimp_flags_set_value_descriptions   (GType flags_type,
                                                             const GimpFlagsDesc *descriptions);

## Description

Translation between gettext translation domain identifier and GType.

## Details

### GimpEnumDesc

    typedef struct {
      gint   value;
      gchar *value_desc;
      gchar *value_help;
    } GimpEnumDesc;

### GimpFlagsDesc

    typedef struct {
      guint  value;
      gchar *value_desc;
      gchar *value_help;
    } GimpFlagsDesc;

### gimp_type_set_translation_domain ()

    void                gimp_type_set_translation_domain    (GType type,
                                                             const gchar *domain);

This function attaches a constant string as a gettext translation domain identifier to a GType. The only purpose of this function is to use it when registering a GTypeEnum with translatable value names.

`type` : | a GType
`domain` : | a constant string that identifies a translation domain or `NULL`

Since GIMP 2.2

### gimp_type_get_translation_domain ()

    const gchar*        gimp_type_get_translation_domain    (GType type);

Retrieves the gettext translation domain identifier that has been previously set using `gimp_type_set_translation_domain()`. You should not need to use this function directly, use `gimp_enum_get_value()` or `gimp_enum_value_get_name()` instead.

`type` : | a GType
Returns : | the translation domain associated with `type` or `NULL` if no domain was set

Since GIMP 2.2

### gimp_enum_set_value_descriptions ()

    void                gimp_enum_set_value_descriptions    (GType enum_type,
                                                             const GimpEnumDesc *descriptions);

Sets the array of human readable and translatable descriptions and help texts for enum values.

`enum_type` : | a GType
`descriptions` : | a `NULL` terminated constant static array of GimpEnumDesc

Since GIMP 2.2

### gimp_enum_get_value_descriptions ()

    const GimpEnumDesc* gimp_enum_get_value_descriptions    (GType enum_type);

Retreives the array of human readable and translatable descriptions and help texts for enum values.

`enum_type` : | a GType
Returns : | a `NULL` terminated constant array of GimpEnumDesc

Since GIMP 2.2

### gimp_flags_get_value_descriptions ()

    const GimpFlagsDesc* gimp_flags_get_value_descriptions  (GType flags_type);

Retreives the array of human readable and translatable descriptions and help texts for flags values.

`flags_type` : | a GType
Returns : | a `NULL` terminated constant array of GimpFlagsDesc

Since GIMP 2.2

### gimp_flags_set_value_descriptions ()

    void                gimp_flags_set_value_descriptions   (GType flags_type,
                                                             const GimpFlagsDesc *descriptions);

Sets the array of human readable and translatable descriptions and help texts for flags values.

`flags_type` : | a GType
`descriptions` : | a `NULL` terminated constant static array of GimpFlagsDesc

Since GIMP 2.2