gimpconfig-iface

## gimpconfig-iface gimpconfig-iface — High-level API for libgimpconfig. |

## Synopsis

                GimpConfig;
                GimpConfigInterface;
    gboolean    gimp_config_serialize_to_file   (GimpConfig *config,
                                                 const gchar *filename,
                                                 const gchar *header,
                                                 const gchar *footer,
                                                 gpointer data,
                                                 GError **error);
    gboolean    gimp_config_serialize_to_fd     (GimpConfig *config,
                                                 gint fd,
                                                 gpointer data);
    gchar*      gimp_config_serialize_to_string (GimpConfig *config,
                                                 gpointer data);
    gboolean    gimp_config_deserialize_file    (GimpConfig *config,
                                                 const gchar *filename,
                                                 gpointer data,
                                                 GError **error);
    gboolean    gimp_config_deserialize_string  (GimpConfig *config,
                                                 const gchar *text,
                                                 gint text_len,
                                                 gpointer data,
                                                 GError **error);
    gboolean    gimp_config_deserialize_return  (GScanner *scanner,
                                                 GTokenType expected_token,
                                                 gint nest_level);
    gpointer    gimp_config_duplicate           (GimpConfig *config);
    gboolean    gimp_config_is_equal_to         (GimpConfig *a,
                                                 GimpConfig *b);
    void        gimp_config_reset               (GimpConfig *config);

## Object Hierarchy

      GInterface
       +----GimpConfigInterface

## Prerequisites

GimpConfigInterface requires GObject.

## Known Implementations

GimpConfigInterface is implemented by GimpColorConfig.

## Description

High-level API functions for libgimpconfig.

## Details

### GimpConfig

    typedef struct _GimpConfig GimpConfig;

### GimpConfigInterface

    typedef struct _GimpConfigInterface GimpConfigInterface;

### gimp_config_serialize_to_file ()

    gboolean    gimp_config_serialize_to_file   (GimpConfig *config,
                                                 const gchar *filename,
                                                 const gchar *header,
                                                 const gchar *footer,
                                                 gpointer data,
                                                 GError **error);

Serializes the object properties of `config` to the file specified by `filename`. If a file with that name already exists, it is overwritten. Basically this function opens `filename` for you and calls the serialize function of the `config`'s GimpConfigInterface.

`config` : | a GObject that implements the GimpConfigInterface.
`filename` : | the name of the file to write the configuration to.
`header` : | optional file header (must be ASCII only)
`footer` : | optional file footer (must be ASCII only)
`data` : | user data passed to the serialize implementation.
`error` : |
Returns : | `TRUE` if serialization succeeded, `FALSE` otherwise.

Since GIMP 2.4

### gimp_config_serialize_to_fd ()

    gboolean    gimp_config_serialize_to_fd     (GimpConfig *config,
                                                 gint fd,
                                                 gpointer data);

Serializes the object properties of `config` to the given file descriptor.

`config` : | a GObject that implements the GimpConfigInterface.
`fd` : | a file descriptor, opened for writing
`data` : | user data passed to the serialize implementation.
Returns : | `TRUE` if serialization succeeded, `FALSE` otherwise.

Since GIMP 2.4

### gimp_config_serialize_to_string ()

    gchar*      gimp_config_serialize_to_string (GimpConfig *config,
                                                 gpointer data);

Serializes the object properties of `config` to a string.

`config` : | a GObject that implements the GimpConfigInterface.
`data` : | user data passed to the serialize implementation.
Returns : | a newly allocated `NUL`-terminated string.

Since GIMP 2.4

### gimp_config_deserialize_file ()

    gboolean    gimp_config_deserialize_file    (GimpConfig *config,
                                                 const gchar *filename,
                                                 gpointer data,
                                                 GError **error);

`config` : |
`filename` : |
`data` : |
`error` : |
Returns : |

### gimp_config_deserialize_string ()

    gboolean    gimp_config_deserialize_string  (GimpConfig *config,
                                                 const gchar *text,
                                                 gint text_len,
                                                 gpointer data,
                                                 GError **error);

Configures `config` from `text`. Basically this function creates a properly configured GScanner for you and calls the deserialize function of the `config`'s GimpConfigInterface.

`config` : | a GObject that implements the GimpConfigInterface.
`text` : | string to deserialize (in UTF-8 encoding)
`text_len` : | length of `text` in bytes or -1
`data` : |
`error` : |
Returns : | `TRUE` if deserialization succeeded, `FALSE` otherwise.

Since GIMP 2.4

### gimp_config_deserialize_return ()

    gboolean    gimp_config_deserialize_return  (GScanner *scanner,
                                                 GTokenType expected_token,
                                                 gint nest_level);

`scanner` : |
`expected_token` : |
`nest_level` : |
Returns : |

Since GIMP 2.4

### gimp_config_duplicate ()

    gpointer    gimp_config_duplicate           (GimpConfig *config);

Creates a copy of the passed object by copying all object properties. The default implementation of the GimpConfigInterface only works for objects that are completely defined by their properties.

`config` : | a GObject that implements the GimpConfigInterface.
Returns : | the duplicated GimpConfig object

Since GIMP 2.4

### gimp_config_is_equal_to ()

    gboolean    gimp_config_is_equal_to         (GimpConfig *a,
                                                 GimpConfig *b);

Compares the two objects. The default implementation of the GimpConfigInterface compares the object properties and thus only works for objects that are completely defined by their properties.

`a` : | a GObject that implements the GimpConfigInterface.
`b` : | another GObject of the same type as `a`.
Returns : | `TRUE` if the two objects are equal.

Since GIMP 2.4

### gimp_config_reset ()

    void        gimp_config_reset               (GimpConfig *config);

Resets the object to its default state. The default implementation of the GimpConfigInterface only works for objects that are completely defined by their properties.

`config` : | a GObject that implements the GimpConfigInterface.

Since GIMP 2.4