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.

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