forked from enlightenment/efl
196 lines
7.3 KiB
C
196 lines
7.3 KiB
C
#ifndef _ECORE_CONFIG_H
|
|
# define _ECORE_CONFIG_H
|
|
|
|
/**
|
|
* @file
|
|
* @brief Provides the Enlightened Property Library.
|
|
*
|
|
* The Enlightened Property Library (Ecore_Config) is an adbstraction from the
|
|
* complexities of writing your own configuration. It provides many features
|
|
* using the Enlightenment 17 development libraries.
|
|
*
|
|
* This file provies all headers and structs for use with Ecore_Config.
|
|
* Using individual header files should not be necessary.
|
|
*/
|
|
|
|
# define DIR_DELIMITER '/'
|
|
# define ECORE_CONFIG_FLOAT_PRECISION 1000
|
|
|
|
# ifndef TRUE
|
|
# define FALSE (0)
|
|
# define TRUE (!FALSE)
|
|
# endif
|
|
|
|
# include <Ecore_Ipc.h>
|
|
/* this should only be included if evas is present */
|
|
# include <Evas.h>
|
|
|
|
/* debug */
|
|
# define DEBUG 1
|
|
# undef ECORE_CONFIG_DEBUG
|
|
|
|
# ifdef ECORE_CONFIG_DEBUG
|
|
# define D(fmt,args...) do { if(DEBUG>=0) fprintf(stderr,fmt,## args); } while(0);
|
|
# define E(lvl,args...) do { if(DEBUG>=(lvl)) fprintf(stderr,## args); } while(0)
|
|
# else
|
|
# define D(msg,args...)
|
|
# define E(lvl,args...) do { } while(0)
|
|
# endif
|
|
|
|
# define ECORE_CONFIG_GLOBAL_ID "_system"
|
|
|
|
/* structures */
|
|
|
|
typedef enum Ecore_Config_Type {
|
|
PT_NIL=0,
|
|
PT_INT=1,
|
|
PT_FLT=2,
|
|
PT_STR=3,
|
|
PT_RGB=4,
|
|
PT_THM=5
|
|
} Ecore_Config_Type;
|
|
|
|
|
|
|
|
typedef enum Ecore_Config_Flag {
|
|
PF_NONE=0,
|
|
PF_BOUNDS=1,
|
|
PF_MODIFIED=2,
|
|
PF_SYSTEM=4
|
|
} Ecore_Config_Flag;
|
|
|
|
|
|
|
|
typedef int (*Ecore_Config_Listener)(const char *key,const Ecore_Config_Type type,const int tag,void *data,void *bundle);
|
|
|
|
|
|
typedef struct Ecore_Config_Listener_List {
|
|
Ecore_Config_Listener listener;
|
|
const char *name;
|
|
void *data;
|
|
int tag;
|
|
struct Ecore_Config_Listener_List *next; } Ecore_Config_Listener_List;
|
|
|
|
/**
|
|
* The actual property for storing a key-value pair.
|
|
*/
|
|
typedef struct Ecore_Config_Prop {
|
|
char *key;
|
|
char *description;
|
|
char *ptr;
|
|
Ecore_Config_Type type;
|
|
long val,lo,hi,step;
|
|
Ecore_Config_Flag flags;
|
|
Ecore_Config_Listener_List *listeners;
|
|
struct Ecore_Config_Prop *next; /**< pointer to the next property in the list */
|
|
} Ecore_Config_Prop;
|
|
|
|
/**
|
|
* A container for a list of properties. Provided so that an application can
|
|
* use different set of properties at any time. This is useful for multiple
|
|
* window support.
|
|
*/
|
|
typedef struct Ecore_Config_Bundle {
|
|
char *identifier; /**< identifier for this set of properties (window ID for example) */
|
|
char *owner; /**< this is used to store the application name related to the bundle */
|
|
long serial; /**< unique identifier to identify bundle */
|
|
Ecore_Config_Prop *data; /**< pointer to root of property list */
|
|
void *user_data; /**< app specific pointer to "other data" */
|
|
struct Ecore_Config_Bundle *next; /**< pointer to next bundle in this application */
|
|
} Ecore_Config_Bundle;
|
|
|
|
typedef struct Ecore_Config_Server {
|
|
void *server;
|
|
char *name;
|
|
Ecore_Config_Bundle *bundles; /* data anchor */
|
|
struct Ecore_Config_Server *next; } Ecore_Config_Server;
|
|
|
|
# ifdef __cplusplus
|
|
extern "C" {
|
|
# endif
|
|
|
|
/* global ptrs to save passing them through the API */
|
|
extern Ecore_Config_Server *__ecore_config_server_global;
|
|
extern Ecore_Config_Server *__ecore_config_server_local;
|
|
extern Ecore_Config_Bundle *__ecore_config_bundle_local;
|
|
extern char *__ecore_config_app_name;
|
|
|
|
Ecore_Config_Prop *ecore_config_get(Ecore_Config_Bundle *t,const char *key);
|
|
const char *ecore_config_get_type(const Ecore_Config_Prop *e);
|
|
void *ecore_config_get_data(const char *key);
|
|
char *ecore_config_get_string(const char *key);
|
|
long ecore_config_get_int(const char *key);
|
|
int ecore_config_get_rgb(const char *key,int *r, int *g, int *b);
|
|
float ecore_config_get_float(const char *key);
|
|
char *ecore_config_get_theme(const char *key);
|
|
char *ecore_config_get_as_string(const char *key);
|
|
char *ecore_config_canonize_key(char *,int modify);
|
|
void ecore_config_describe(const char *key, char *desc);
|
|
int ecore_config_set(Ecore_Config_Bundle *t,const char *key,char *val);
|
|
int ecore_config_set_string(const char *key,char *val);
|
|
int ecore_config_set_int(const char *key,int val);
|
|
int ecore_config_set_rgb(const char *key,char *val);
|
|
char *ecore_config_get_rgbstr(const char *key);
|
|
int ecore_config_set_float(const char *key,float val);
|
|
int ecore_config_set_theme(const char *key,char *val);
|
|
int ecore_config_set_as_string(const char *key,char *val);
|
|
|
|
int ecore_config_default(const char *key,char *val,float lo,float hi,float step);
|
|
int ecore_config_default_int(const char *key,int val);
|
|
int ecore_config_default_int_bound(const char *key,int val,int lo,int hi,int step);
|
|
int ecore_config_default_string(const char *key,char *val);
|
|
int ecore_config_default_float(const char *key,float val);
|
|
int ecore_config_default_float_bound(const char *key,float val,float lo,float hi,float step);
|
|
int ecore_config_default_rgb(const char *key,char *val);
|
|
int ecore_config_default_theme(const char *key,char *val);
|
|
|
|
int ecore_config_listen(const char *name,const char *key,Ecore_Config_Listener listener,int tag,void *data);
|
|
int ecore_config_deaf(const char *name,const char *key,Ecore_Config_Listener listener);
|
|
Ecore_Config_Prop *ecore_config_dst(Ecore_Config_Prop *e);
|
|
int ecore_config_guess_type(const char *key, char *val);
|
|
|
|
Ecore_Config_Bundle *ecore_config_bundle_new(Ecore_Config_Server *srv, const char *id);
|
|
Ecore_Config_Bundle *ecore_config_bundle_get_1st(Ecore_Config_Server *srv);
|
|
Ecore_Config_Bundle *ecore_config_bundle_get_next(Ecore_Config_Bundle *ns);
|
|
Ecore_Config_Bundle *ecore_config_bundle_get_by_serial(Ecore_Config_Server *srv, long serial);
|
|
Ecore_Config_Bundle *ecore_config_bundle_get_by_label(Ecore_Config_Server *srv, const char *label);
|
|
long ecore_config_bundle_get_serial(Ecore_Config_Bundle *ns);
|
|
char *ecore_config_bundle_get_label(Ecore_Config_Bundle *ns);
|
|
|
|
|
|
int ecore_config_init(char *name);
|
|
int ecore_config_exit(void);
|
|
|
|
int ecore_config_load(void);
|
|
int ecore_config_load_file(char *file);
|
|
int ecore_config_save(void);
|
|
int ecore_config_save_file(char *file);
|
|
|
|
/* error codes */
|
|
# define ECORE_CONFIG_ERR_NOTSUPP (-16)
|
|
# define ECORE_CONFIG_ERR_NOFILE (-15)
|
|
# define ECORE_CONFIG_ERR_META_DLFAIL (-14)
|
|
# define ECORE_CONFIG_ERR_META_FILE (-13)
|
|
# define ECORE_CONFIG_ERR_META_FORMAT (-12)
|
|
# define ECORE_CONFIG_ERR_MONMIS (-11)
|
|
# define ECORE_CONFIG_ERR_NOEXEC (-10)
|
|
# define ECORE_CONFIG_ERR_PARTIAL (-9)
|
|
# define ECORE_CONFIG_ERR_PATHEX (-8)
|
|
# define ECORE_CONFIG_ERR_TYPEMISMATCH (-7)
|
|
# define ECORE_CONFIG_ERR_MUTEX (-6)
|
|
# define ECORE_CONFIG_ERR_NOTFOUND (-5)
|
|
# define ECORE_CONFIG_ERR_OOM (-4)
|
|
# define ECORE_CONFIG_ERR_IGNORED (-3)
|
|
# define ECORE_CONFIG_ERR_NODATA (-2)
|
|
# define ECORE_CONFIG_ERR_FAIL (-1)
|
|
# define ECORE_CONFIG_ERR_SUCC (0)
|
|
|
|
/* convenience mathods in convenience.c */
|
|
int ecore_config_evas_font_path_apply(Evas *evas);
|
|
void ecore_config_prop_list_describe(void);
|
|
|
|
# ifdef __cplusplus
|
|
}
|
|
# endif
|
|
#endif
|