| Gnome Scan Reference Manual | ||||
|---|---|---|---|---|
GnomeScanSettings;
GnomeScanSettings* gnome_scan_settings_new (void);
void gnome_scan_settings_init_value (GnomeScanSettings *settings,
GParamSpec *pspec);
void gnome_scan_settings_set (GnomeScanSettings *settings,
const gchar *name,
const GValue *value);
void gnome_scan_settings_set_transform (GnomeScanSettings *settings,
const gchar *name,
const GValue *value);
void gnome_scan_settings_set_double (GnomeScanSettings *settings,
const gchar *name,
gdouble value);
void gnome_scan_settings_set_int (GnomeScanSettings *settings,
const gchar *name,
gint value);
void gnome_scan_settings_set_boolean (GnomeScanSettings *settings,
const gchar *name,
gboolean value);
void gnome_scan_settings_set_enum (GnomeScanSettings *settings,
const gchar *name,
GType type,
gint value);
void gnome_scan_settings_set_boxed (GnomeScanSettings *settings,
const gchar *name,
GType type,
gpointer value);
void gnome_scan_settings_set_object (GnomeScanSettings *settings,
const gchar *name,
GObject *value);
void gnome_scan_settings_set_pointer (GnomeScanSettings *settings,
const gchar *name,
gpointer value);
GValue* gnome_scan_settings_get (GnomeScanSettings *settings,
const gchar *name);
GValue* gnome_scan_settings_get_transformed (GnomeScanSettings *settings,
const gchar *name,
GType type);
gchar* gnome_scan_settings_get_string (GnomeScanSettings *settings,
const gchar *name);
gdouble gnome_scan_settings_get_double (GnomeScanSettings *settings,
const gchar *name);
gint gnome_scan_settings_get_int (GnomeScanSettings *settings,
const gchar *name);
gboolean gnome_scan_settings_get_boolean (GnomeScanSettings *settings,
const gchar *name);
gint gnome_scan_settings_get_enum (GnomeScanSettings *settings,
const gchar *name,
GType type);
gpointer gnome_scan_settings_get_boxed (GnomeScanSettings *settings,
const gchar *name,
GType type);
GObject* gnome_scan_settings_get_object (GnomeScanSettings *settings,
const gchar *name);
gpointer gnome_scan_settings_get_pointer (GnomeScanSettings *settings,
const gchar *name);
GHashTable* gnome_scan_settings_get_all (GnomeScanSettings *settings);
When user switch from a scanner to another, he expects the settings
to keep almost the same. e.g. resolution should not be resetted on
device selection. The settings are remember in a GnomeScanSettings
which maintains a table of GValue using GParamSpec:name as
key. This allow to apply the same GnomeScanSettings on various
GnomeScanPlugin through gnome_scan_plugin_configure().
Since 0.5.92, GnomeScanSettings load and store automatically
settings in GConf in /apps/gnome-scan/prgname%/key%. Ensure you
have a call to g_set_prgname() before gnome_scan_init(). Loading is
done upon construction. However, storing is done at dispose
stage. Ensure to correctly ref/unref your GnomeScanSettings
instance in order to actually use this feature.
typedef struct _GnomeScanSettings GnomeScanSettings;
A GnomeScanSettings manage a table of GValue indexed by the name of the param spec they where associated to.
GnomeScanSettings* gnome_scan_settings_new (void);
Create a new empty GnomeScanSettings.
Returns : |
a new GnomeScanSettings |
void gnome_scan_settings_init_value (GnomeScanSettings *settings, GParamSpec *pspec);
Store a new value in settings using default value and key from
pspec.
|
a GnomeScanSettings |
|
a GSParamSpec |
void gnome_scan_settings_set (GnomeScanSettings *settings, const gchar *name, const GValue *value);
Store value for name key.
See: gnome_scan_settings_get()
|
a GnomeScanSettings |
|
GParamSpec name |
|
GParamSpec user value |
void gnome_scan_settings_set_transform (GnomeScanSettings *settings, const gchar *name, const GValue *value);
Store value for name key, keeping existing value type by
transforming value. value type is used if the name setting has
never been set.
See: gnome_scan_settings_get_transformed()
|
a GnomeScanSettings |
|
GParamSpec name |
|
GParamSpec user value |
void gnome_scan_settings_set_double (GnomeScanSettings *settings, const gchar *name, gdouble value);
See: gnome_scan_settings_set_transform()
|
a GnomeScanSettings |
|
GParamSpec name |
|
gdouble value |
void gnome_scan_settings_set_int (GnomeScanSettings *settings, const gchar *name, gint value);
See: gnome_scan_settings_set_transform()
|
a GnomeScanSettings |
|
GParamSpec name |
|
gint value |
void gnome_scan_settings_set_boolean (GnomeScanSettings *settings, const gchar *name, gboolean value);
See: gnome_scan_settings_set_transform()
|
a GnomeScanSettings |
|
GParamSpec name |
|
gboolean value |
void gnome_scan_settings_set_enum (GnomeScanSettings *settings, const gchar *name, GType type, gint value);
See: gnome_scan_settings_set_transform()
|
a GnomeScanSettings |
|
GParamSpec name |
|
enum GType |
|
enum value |
void gnome_scan_settings_set_boxed (GnomeScanSettings *settings, const gchar *name, GType type, gpointer value);
See: gnome_scan_settings_set_transform()
|
a GnomeScanSettings |
|
GParamSpec name |
|
|
|
a GBoxed |
void gnome_scan_settings_set_object (GnomeScanSettings *settings, const gchar *name, GObject *value);
See: gnome_scan_settings_set_transform()
|
a GnomeScanSettings |
|
GParamSpec name |
|
a GObject |
void gnome_scan_settings_set_pointer (GnomeScanSettings *settings, const gchar *name, gpointer value);
See: gnome_scan_settings_set_transform()
|
a GnomeScanSettings |
|
GParamSpec name |
|
a gpointer |
GValue* gnome_scan_settings_get (GnomeScanSettings *settings, const gchar *name);
Look for a value stored in the table for name key.
|
a GnomeScanSettings |
|
a key |
Returns : |
the value corresponding to key or NULL.
See: gnome_scan_settings_set()
|
GValue* gnome_scan_settings_get_transformed (GnomeScanSettings *settings, const gchar *name, GType type);
Look for a value stored in the table for name key.
|
a GnomeScanSettings |
|
a key |
|
Transformation destination type. |
Returns : |
the value corresponding to key or NULL.
See: gnome_scan_settings_set()
|
gchar* gnome_scan_settings_get_string (GnomeScanSettings *settings, const gchar *name);
Look for a value stored in the table for name key.
|
a GnomeScanSettings |
|
a key |
Returns : |
the string corresponding to key.
See: gnome_scan_settings_get()
|
gdouble gnome_scan_settings_get_double (GnomeScanSettings *settings, const gchar *name);
Look for a value stored in the table for name key.
|
a GnomeScanSettings |
|
a key |
Returns : |
the string corresponding to key or NULL.
See: gnome_scan_settings_get()
|
gint gnome_scan_settings_get_int (GnomeScanSettings *settings, const gchar *name);
Look for a value stored in the table for name key.
|
a GnomeScanSettings |
|
a key |
Returns : |
the string corresponding to key or NULL.
See: gnome_scan_settings_get()
|
gboolean gnome_scan_settings_get_boolean (GnomeScanSettings *settings, const gchar *name);
|
a GnomeScanSettings |
|
value name |
Returns : |
a gboolean |
gint gnome_scan_settings_get_enum (GnomeScanSettings *settings, const gchar *name, GType type);
Look for a value stored in the table for name key.
|
a GnomeScanSettings |
|
a key |
|
GEnum subtype |
Returns : |
the enum value corresponding to key or 0.
See: gnome_scan_settings_get()
|
gpointer gnome_scan_settings_get_boxed (GnomeScanSettings *settings, const gchar *name, GType type);
Look for a value stored in the table for name key.
|
a GnomeScanSettings |
|
a key |
|
GBoxed derived GType |
Returns : |
the boxed-type value corresponding to key or NULL.
See: gnome_scan_settings_get()
|
GObject* gnome_scan_settings_get_object (GnomeScanSettings *settings, const gchar *name);
Look for a value stored in the table for name key.
|
a GnomeScanSettings |
|
a key |
Returns : |
the object corresponding to key or NULL.
See: gnome_scan_settings_get()
|
gpointer gnome_scan_settings_get_pointer (GnomeScanSettings *settings, const gchar *name);
Look for a value stored in the table for name key.
|
a GnomeScanSettings |
|
a key |
Returns : |
the pointer corresponding to key or NULL.
See: gnome_scan_settings_get()
|
GHashTable* gnome_scan_settings_get_all (GnomeScanSettings *settings);
Retrun all stored values in a GHashTable. Use g_hash_table_ref() if
you want to keep the GHashTable in memory after settings destruction.
|
a GnomeScanSettings |
Returns : |
a GHashTable containings GValues |
"changed" signalvoid user_function (GnomeScanSettings *widget, gchar *key, gpointer user_data) : Run Last
This signal is emitted when the value is changed by the user.
|
The emitting widget |
|
The changed key |
|
The new value |
|
user data set when the signal handler was connected. |