## 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