/**

 * $Id$

 *

 * User configuration support

 *

 * Copyright (c) 2005 Nathan Keynes.

 *

 * This program is free software; you can redistribute it and/or modify

 * it under the terms of the GNU General Public License as published by

 * the Free Software Foundation; either version 2 of the License, or

 * (at your option) any later version.

 *

 * This program is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

 * GNU General Public License for more details.

 */

#ifndef lxdream_config_H

#define lxdream_config_H 1

#include <glib/gtypes.h>

#include <glib/glist.h>

#include "lxdream.h"

#include "gettext.h"

#ifdef __cplusplus

extern "C" {

#endif

#define CONFIG_MAX_KEYS 24

#define CONFIG_TYPE_NONE 0

#define CONFIG_TYPE_FILE 1

#define CONFIG_TYPE_PATH 2

#define CONFIG_TYPE_KEY 3

#define CONFIG_TYPE_FILELIST 4

#define CONFIG_TYPE_INTEGER 5

#define CONFIG_TYPE_BOOLEAN 6

#define DEFAULT_CONFIG_FILENAME "lxdreamrc"

typedef struct lxdream_config_entry {

    const gchar *key;

    const gchar *label; // i18n 

    int type;

    const gchar *default_value;

    uint32_t tag;

    gchar *value;

} *lxdream_config_entry_t;

struct lxdream_config_group;

/**

 * Callback invoked for key presses (key-up/key-down).

 */

typedef void (*key_binding_t)( void *data, uint32_t value, uint32_t pressure, gboolean isKeyDown );

/**

 * Callback invoked immediately before updating a configuration item.

 * @return FALSE to abort the change (ie invalid value), or TRUE to proceed normally. 

 */

typedef gboolean (*config_change_callback_t)( void *data, struct lxdream_config_group *group, unsigned item,

                                   const gchar *oldval, const gchar *newval );

typedef struct lxdream_config_group {

    const gchar *key;

    config_change_callback_t on_change;

    key_binding_t key_binding;

    void *data;

    struct lxdream_config_entry params[CONFIG_MAX_KEYS];

} *lxdream_config_group_t;

#define CONFIG_BIOS_PATH 0

#define CONFIG_FLASH_PATH 1

#define CONFIG_DEFAULT_PATH 2

#define CONFIG_SAVE_PATH 3

#define CONFIG_VMU_PATH 4

#define CONFIG_BOOTSTRAP 5

#define CONFIG_GDROM 6

#define CONFIG_RECENT 7

#define CONFIG_VMU 8

#define CONFIG_QUICK_STATE 9

#define CONFIG_KEY_MAX CONFIG_QUICK_STATE

#define CONFIG_GROUP_GLOBAL 0

#define CONFIG_GROUP_HOTKEYS 2

#define CONFIG_GROUP_SERIAL 3

/* Global config values */

const gchar *lxdream_get_global_config_value( int key );

struct lxdream_config_group * lxdream_get_config_group( int group );

void lxdream_set_global_config_value( int key, const gchar *value );

void lxdream_register_config_group( const gchar *key, lxdream_config_group_t group ); 

gboolean lxdream_set_config_value( lxdream_config_group_t group, int key, const gchar *value );

void lxdream_copy_config_group( lxdream_config_group_t dest, lxdream_config_group_t src );

void lxdream_clone_config_group( lxdream_config_group_t dest, lxdream_config_group_t src );

gboolean lxdream_get_config_boolean_value( lxdream_config_group_t group, int key );

gboolean lxdream_set_config_boolean_value( lxdream_config_group_t group, int key, gboolean value );

/**

 * Return a fully expanded path value for a key - this performs substitutions

 * for ~ and simple shell variables ($VAR and ${VAR})

 * 

 * The returned string is newly allocated and must be freed by the caller

 */

gchar *lxdream_get_global_config_path_value( int key );

/**

 * Set a path value for a key, escaping if necessary to protect against 

 * shell-substitution on the round trip.

 * 

 * @return the resultant config value.

 */

const gchar *lxdream_set_global_config_path_value( int key, const gchar *value );

/**

 * Construct a list of strings for the given config key - The caller is 

 * responsible for freeing the list and its values.

 */

GList *lxdream_get_global_config_list_value( int key );

/**

 * Set a config key based on a list of strings. 

 */

void lxdream_set_global_config_list_value( int key, const GList *list );

/**

 * Search the standard locations for the configuration file:

 *   $HOME/.lxdreamrc

 *   $CWD/lxdreamrc

 *   $SYSCONF_DIR/lxdreamrc

 * @return TRUE if the file was found, otherwise FALSE.

 */

gboolean lxdream_find_config( );

/**

 * Set the configuration file filename to the supplied string.

 * The string is copied internally (ie can be released by the

 * caller).

 */

void lxdream_set_config_filename( const gchar *filename );

/**

 * Load the configuration from the previously determined filename.

 */

gboolean lxdream_load_config( );

/**

 * Update the configuration

 */

gboolean lxdream_save_config( );

/**

 * Make the user configuration directories if they don't already exist.

 */ 

void lxdream_make_config_dir( );

#ifdef __cplusplus

}

#endif

#endif /* !lxdream_config_H */