unicapgtk

unicapgtk

Synopsis




enum                UnicapgtkDeviceStateFlags;
gchar*              unicapgtk_get_user_config_path      (void);
GKeyFile*           unicapgtk_save_device_state         (unicap_handle_t handle,
                                                         UnicapgtkDeviceStateFlags flags);
gboolean            unicapgtk_load_device_state         (unicap_handle_t handle,
                                                         GKeyFile *keyfile,
                                                         UnicapgtkDeviceStateFlags flags);
unicap_status_t     unicapgtk_check_version             (unsigned int major,
                                                         unsigned int minor,
                                                         unsigned int micro);

Description

Details

enum UnicapgtkDeviceStateFlags

typedef enum
{
   UNICAPGTK_DEVICE_STATE_VIDEO_FORMAT = 1 << 0,
   UNICAPGTK_DEVICE_STATE_PROPERTIES   = 1 << 1,
}UnicapgtkDeviceStateFlags;


unicapgtk_get_user_config_path ()

gchar*              unicapgtk_get_user_config_path      (void);

Get path to the directory containing the configuration files

Returns : Path to configuration directory

unicapgtk_save_device_state ()

GKeyFile*           unicapgtk_save_device_state         (unicap_handle_t handle,
                                                         UnicapgtkDeviceStateFlags flags);

Saves the current device state. If UNICAPGTK_DEVICE_STATE_VIDEO_FORMAT is set in the flags field, a section containing information about the current video format is added to the configuration file. If UNICAPGTK_DEVICE_STATE_PROPERTIES is set, a section containing the current state of the device properties is added to the configuration file.

handle : unicap handle
flags : flags
Returns : A newly allocated GKeyfile. Must be freed with g_key_file_free() by the application.

unicapgtk_load_device_state ()

gboolean            unicapgtk_load_device_state         (unicap_handle_t handle,
                                                         GKeyFile *keyfile,
                                                         UnicapgtkDeviceStateFlags flags);

handle : handle of the device
keyfile : GKeyFile to load the device state information from
flags : UnicapgtkDeviceStateFlags specifying what parts to configure Reads device state information from a key-file and sets the parameters of a device accordingly.
Returns :

unicapgtk_check_version ()

unicap_status_t     unicapgtk_check_version             (unsigned int major,
                                                         unsigned int minor,
                                                         unsigned int micro);

Checks whether the installed library version is newer or equal to the given version

major : Major version to check
minor : Minor version to check
micro : Micro version to check
Returns : STATUS_INCOMPATIBLE_MAJOR_VERSION if the given major version is too old STATUS_INCOMPATIBLE_MINOR_VERSION if the given minor version is too old STATUS_INCOMPATIBLE_MACRO_VERSION if the given macro version is too old STATUS_SUCCESS if the version is compatible