GDigicamManager

GDigicamManager — The manager provides a common way of accessing any GStreamer based digicam like bin

Synopsis

                    GDigicamDescriptor;
                    GDigicamFocuspointposition;
gboolean            (*GDigicamManagerFunc)              (GDigicamManager *manager,
                                                         gpointer user_data);
#define             G_DIGICAM_CAPABILITIES_VIEWFINDER
#define             G_DIGICAM_CAPABILITIES_FLASH
#define             G_DIGICAM_CAPABILITIES_AUTOFOCUS
#define             G_DIGICAM_CAPABILITIES_CONTINUOUSAUTOFOCUS
#define             G_DIGICAM_CAPABILITIES_MANUALFOCUS
#define             G_DIGICAM_CAPABILITIES_MACROFOCUS
#define             G_DIGICAM_CAPABILITIES_AUTOEXPOSURE
#define             G_DIGICAM_CAPABILITIES_MANUALEXPOSURE
#define             G_DIGICAM_CAPABILITIES_METERING
#define             G_DIGICAM_CAPABILITIES_ASPECTRATIO
#define             G_DIGICAM_CAPABILITIES_RESOLUTION
#define             G_DIGICAM_CAPABILITIES_VIEWFINDER_NAME
#define             G_DIGICAM_CAPABILITIES_OPTICALZOOM
#define             G_DIGICAM_CAPABILITIES_DIGITALZOOM
#define             G_DIGICAM_CAPABILITIES_AUTOISOSENSITIVITY
#define             G_DIGICAM_CAPABILITIES_AUTOWHITEBALANCE
#define             G_DIGICAM_CAPABILITIES_MANUALISOSENSITIVITY
#define             G_DIGICAM_CAPABILITIES_MANUALWHITEBALANCE
#define             G_DIGICAM_CAPABILITIES_QUALITY
#define             G_DIGICAM_CAPABILITIES_AUDIO
enum                GDigicamMode;
enum                GDigicamFlashmode;
enum                GDigicamFocusmode;
enum                GDigicamExposuremode;
enum                GDigicamIsosensitivitymode;
enum                GDigicamWhitebalancemode;
enum                GDigicamAperturemode;
enum                GDigicamMeteringmode;
enum                GDigicamShutterspeedmode;
enum                GDigicamAspectratio;
enum                GDigicamColorfilter;
enum                GDigicamQuality;
enum                GDigicamResolution;
enum                GDigicamVideostabilization;
enum                GDigicamLock;
enum                GDigicamFocuspoints;
enum                GDigicamFocusmodestatus;
enum                GDigicamAutoexposurestatus;
enum                GDigicamAudio;
                    GDigicamManager;
                    GDigicamManagerClass;
GDigicamManager*    g_digicam_manager_new               (void);
gboolean            g_digicam_manager_set_gstreamer_bin (GDigicamManager *manager,
                                                         GstElement *gst_bin,
                                                         GDigicamDescriptor *descriptor,
                                                         GError **error);
gboolean            g_digicam_manager_get_gstreamer_bin (GDigicamManager *manager,
                                                         GstElement **gst_bin,
                                                         GError **error);
gboolean            g_digicam_manager_query_capabilities
                                                        (GDigicamManager *manager,
                                                         GDigicamDescriptor **descriptor,
                                                         GError **error);
gboolean            g_digicam_manager_set_mode          (GDigicamManager *manager,
                                                         GDigicamMode mode,
                                                         GError **error,
                                                         gpointer user_data);
gboolean            g_digicam_manager_get_mode          (GDigicamManager *manager,
                                                         GDigicamMode *mode,
                                                         GError **error);
gboolean            g_digicam_manager_set_flash_mode    (GDigicamManager *manager,
                                                         GDigicamFlashmode flash_mode,
                                                         GError **error,
                                                         gpointer user_data);
gboolean            g_digicam_manager_get_flash_mode    (GDigicamManager *manager,
                                                         GDigicamFlashmode *flash_mode,
                                                         GError **error);
gboolean            g_digicam_manager_set_focus_mode    (GDigicamManager *manager,
                                                         GDigicamFocusmode focus_mode,
                                                         gboolean macro_enabled,
                                                         GError **error,
                                                         gpointer user_data);
gboolean            g_digicam_manager_get_focus_mode    (GDigicamManager *manager,
                                                         GDigicamFocusmode *focus_mode,
                                                         gboolean *macro_enabled,
                                                         GError **error);
gboolean            g_digicam_manager_set_focus_region_pattern
                                                        (GDigicamManager *manager,
                                                         GDigicamFocuspoints focus_points,
                                                         guint64 active_points,
                                                         GError **error,
                                                         gpointer user_data);
gboolean            g_digicam_manager_get_focus_region_pattern
                                                        (GDigicamManager *manager,
                                                         GDigicamFocuspoints *focus_points,
                                                         guint64 *active_points,
                                                         GError **error);
gboolean            g_digicam_manager_set_exposure_mode (GDigicamManager *manager,
                                                         GDigicamExposuremode exposure_mode,
                                                         const GDigicamExposureconf *conf,
                                                         GError **error,
                                                         gpointer user_data);
gboolean            g_digicam_manager_get_exposure_mode (GDigicamManager *manager,
                                                         GDigicamExposuremode *exposure_mode,
                                                         GError **error);
gboolean            g_digicam_manager_set_exposure_comp (GDigicamManager *manager,
                                                         gdouble exposure_comp,
                                                         GError **error,
                                                         gpointer user_data);
gboolean            g_digicam_manager_get_exposure_comp (GDigicamManager *manager,
                                                         gdouble *exposure_comp,
                                                         GError **error);
gboolean            g_digicam_manager_set_iso_sensitivity_mode
                                                        (GDigicamManager *manager,
                                                         GDigicamIsosensitivitymode iso_sensitivity_mode,
                                                         guint iso_level,
                                                         GError **error,
                                                         gpointer user_data);
gboolean            g_digicam_manager_get_iso_sensitivity_mode
                                                        (GDigicamManager *manager,
                                                         GDigicamIsosensitivitymode *iso_sensitivity_mode,
                                                         guint *iso_level,
                                                         GError **error);
gboolean            g_digicam_manager_set_white_balance_mode
                                                        (GDigicamManager *manager,
                                                         GDigicamWhitebalancemode white_balance_mode,
                                                         guint white_balance_level,
                                                         GError **error,
                                                         gpointer user_data);
gboolean            g_digicam_manager_get_white_balance_mode
                                                        (GDigicamManager *manager,
                                                         GDigicamWhitebalancemode *white_balance_mode,
                                                         guint *white_balance_level,
                                                         GError **error);
gboolean            g_digicam_manager_set_metering_mode (GDigicamManager *manager,
                                                         GDigicamMeteringmode metering_mode,
                                                         GError **error,
                                                         gpointer user_data);
gboolean            g_digicam_manager_get_metering_mode (GDigicamManager *manager,
                                                         GDigicamMeteringmode *metering_mode,
                                                         GError **error);
gboolean            g_digicam_manager_set_aspect_ratio  (GDigicamManager *manager,
                                                         GDigicamAspectratio aspect_ratio,
                                                         GError **error,
                                                         gpointer user_data);
gboolean            g_digicam_manager_get_aspect_ratio  (GDigicamManager *manager,
                                                         GDigicamAspectratio *aspect_ratio,
                                                         GError **error);
gboolean            g_digicam_manager_set_aspect_ratio_resolution
                                                        (GDigicamManager *manager,
                                                         GDigicamAspectratio aspect_ratio,
                                                         GDigicamResolution resolution,
                                                         GError **error,
                                                         gpointer user_data);
gboolean            g_digicam_manager_set_quality       (GDigicamManager *manager,
                                                         GDigicamQuality quality,
                                                         GError **error,
                                                         gpointer user_data);
gboolean            g_digicam_manager_get_quality       (GDigicamManager *manager,
                                                         GDigicamQuality *quality,
                                                         GError **error);
gboolean            g_digicam_manager_set_resolution    (GDigicamManager *manager,
                                                         GDigicamResolution resolution,
                                                         GError **error,
                                                         gpointer user_data);
gboolean            g_digicam_manager_get_resolution    (GDigicamManager *manager,
                                                         GDigicamResolution *resolution,
                                                         GError **error);
gboolean            g_digicam_manager_set_locks         (GDigicamManager *manager,
                                                         GDigicamLock locks,
                                                         GError **error,
                                                         gpointer user_data);
gboolean            g_digicam_manager_get_locks         (GDigicamManager *manager,
                                                         GDigicamLock *locks,
                                                         GError **error);
gboolean            g_digicam_manager_set_zoom          (GDigicamManager *manager,
                                                         gdouble zoom,
                                                         gboolean *digital,
                                                         GError **error,
                                                         gpointer user_data);
gboolean            g_digicam_manager_get_zoom          (GDigicamManager *manager,
                                                         gdouble *zoom,
                                                         gboolean *digital,
                                                         GError **error);
gboolean            g_digicam_manager_set_audio         (GDigicamManager *manager,
                                                         GDigicamAudio audio,
                                                         GError **error,
                                                         gpointer user_data);
gboolean            g_digicam_manager_get_audio         (GDigicamManager *manager,
                                                         GDigicamAudio *audio,
                                                         GError **error);
gboolean            g_digicam_manager_play_bin          (GDigicamManager *manager,
                                                         gulong xwindow_id,
                                                         GError **error);
gboolean            g_digicam_manager_stop_bin          (GDigicamManager *manager,
                                                         GError **error);
gboolean            g_digicam_manager_get_xwindow_id    (GDigicamManager *manager,
                                                         gulong *xwindow_id,
                                                         GError **error);
gboolean            g_digicam_manager_capture_still_picture
                                                        (GDigicamManager *manager,
                                                         const gchar *filename,
                                                         GError **error,
                                                         gpointer user_data);
gboolean            g_digicam_manager_start_recording_video
                                                        (GDigicamManager *manager,
                                                         GError **error,
                                                         gpointer user_data);
gboolean            g_digicam_manager_pause_recording_video
                                                        (GDigicamManager *manager,
                                                         gboolean resume,
                                                         GError **error,
                                                         gpointer user_data);
gboolean            g_digicam_manager_finish_recording_video
                                                        (GDigicamManager *manager,
                                                         GError **error,
                                                         gpointer user_data);
GDigicamDescriptor* g_digicam_manager_descriptor_new    (void);
void                g_digicam_manager_descriptor_free   (GDigicamDescriptor *descriptor);
GDigicamDescriptor* g_digicam_manager_descriptor_copy   (const GDigicamDescriptor *orig_descriptor);

Description

The manager provides a common way of accessing any GStreamer based digicam like bin. Although it holds some automatic autoconfiguration pending on the passed GStreamer bin, it relays in a custom set of external functions provided with the bin which will translate effectively the common manager's API to actions into the GStreamer bin.

The bin may be provided with a descriptor structure holding those custom functions and a set of flags signaling the capabilities of the current bin.

GDigicamManager is the manager object to any digicam like GStreamer bin.

Details

GDigicamDescriptor

typedef struct {
        gchar *name;
        GstElement *viewfinder_sink;
/*         guint32 max_width; */
/*         guint32 max_height; */
/*         guint orientation; */
        guint32 supported_features;
        guint supported_modes;
        GDigicamManagerFunc set_mode_func;
        guint supported_flash_modes;
        GDigicamManagerFunc set_flash_mode_func;
        guint supported_focus_modes;
        GDigicamManagerFunc set_focus_mode_func;
        GDigicamManagerFunc set_focus_region_pattern_func;
        guint supported_exposure_modes;
        GDigicamManagerFunc set_exposure_mode_func;
        GDigicamManagerFunc set_exposure_comp_func;
        guint supported_iso_sensitivity_modes;
        GDigicamManagerFunc set_iso_sensitivity_mode_func;
        guint supported_white_balance_modes;
        GDigicamManagerFunc set_white_balance_mode_func;
        guint supported_metering_modes;
        GDigicamManagerFunc set_metering_mode_func;
        guint supported_aspect_ratios;
        GDigicamManagerFunc set_aspect_ratio_func;
/*         guint supported_color_filters; */
        guint supported_qualities;
	GDigicamManagerFunc set_quality_func;
        guint supported_resolutions;
        GDigicamManagerFunc set_resolution_func;
        GDigicamManagerFunc set_aspect_ratio_resolution_func;
        GDigicamManagerFunc set_locks_func;
        gdouble max_zoom_macro_disabled;
        gdouble max_zoom_macro_enabled;
        gdouble max_optical_zoom_macro_disabled;
        gdouble max_optical_zoom_macro_enabled;
        gdouble max_digital_zoom;
        GDigicamManagerFunc set_zoom_func;
        guint supported_audio_states;
        GDigicamManagerFunc set_audio_func;
        guint supported_preview_modes;
        GDigicamManagerFunc set_preview_mode_func;
        GDigicamManagerFunc get_still_picture_func;
        GDigicamManagerFunc start_recording_video_func;
        GDigicamManagerFunc pause_recording_video_func;
        GDigicamManagerFunc finish_recording_video_func;
        GDigicamManagerFunc handle_bus_message_func;
        GDigicamManagerFunc handle_sync_bus_message_func;
/*         gdouble min_focus_distance_macro_disabled; */
/*         gdouble min_focus_distance_macro_enabled; */
/*         guint min_gamma; */
/*         guint max_gamma; */
} GDigicamDescriptor;

The GDigicamDescriptor structure contains the capabilities of the camera.

gchar *name; The name of the digicam like GstElement it owns to.
GstElement *viewfinder_sink; the a GstElement reference to the viewfinder sink of the digicam like GstElement, if any.
guint32 supported_features; mask holding the features of the digicam like GstElement.
guint supported_modes; mask holding the modes supported by the digicam like GstElement composed with GDigicamMode values.
GDigicamManagerFunc set_mode_func; custom GDigicamManagerFunc like function to change the GDigicamMode of the digicam like GstElement.
guint supported_flash_modes; mask holding the flash modes supported by the digicam like GstElement composed with GDigicamFlashmode values.
GDigicamManagerFunc set_flash_mode_func; custom GDigicamManagerFunc like function to change the GDigicamFlashmode of the digicam like GstElement.
guint supported_focus_modes; mask holding the focus modes supported by the digicam like GstElement composed with GDigicamFocusmode values.
GDigicamManagerFunc set_focus_mode_func; custom GDigicamManagerFunc like function to change the GDigicamFocusmode of the digicam like GstElement.
GDigicamManagerFunc set_focus_region_pattern_func; custom GDigicamManagerFunc like function to set the focus points mode from GDigicamFocuspoints values a mask pointing the active points.
guint supported_exposure_modes; mask holding the exposure modes supported by the digicam like GstElement composed with GDigicamExposuremode values.
GDigicamManagerFunc set_exposure_mode_func; custom GDigicamManagerFunc like function to change the GDigicamExposuremode of the digicam like GstElement.
GDigicamManagerFunc set_exposure_comp_func; custom GDigicamManagerFunc like function to change the exposure compensation of the digicam like GstElement.
guint supported_iso_sensitivity_modes; mask holding the iso sensitivity modes supported by the digicam like GstElement composed with
GDigicamManagerFunc set_iso_sensitivity_mode_func; custom GDigicamManagerFunc like function to change the iso sensitivity value of the digicam like GstElement.
guint supported_white_balance_modes; mask holding the iso white balance modes supported by the digicam like GstElement composed with
GDigicamManagerFunc set_white_balance_mode_func; custom GDigicamManagerFunc like function to change the white balance value of the digicam like GstElement.
guint supported_metering_modes; mask holding the metering modes supported by the digicam like GstElement composed with GDigicamMeteringmode values.
GDigicamManagerFunc set_metering_mode_func; custom GDigicamManagerFunc like function to change the GDigicamMeteringmode of the digicam like GstElement.
guint supported_aspect_ratios; mask holding the aspect ratio modes supported by the digicam like GstElement composed with GDigicamAspectratio values.
GDigicamManagerFunc set_aspect_ratio_func; custom GDigicamManagerFunc like function to change the GDigicamAspectratio of the digicam like GstElement.
guint supported_qualities; mask holding the qualities supported by the digicam like GstElement composed with GDigicamQualities values.
GDigicamManagerFunc set_quality_func; custom GDigicamManagerFunc like function to change the GDigicamQualities of the digicam like GstElement.
guint supported_resolutions; mask holding the resolution modes supported by the digicam like GstElement composed with GDigicamResolution values.
GDigicamManagerFunc set_resolution_func; custom GDigicamManagerFunc like function to change the GDigicamResolution of the digicam like GstElement.
GDigicamManagerFunc set_aspect_ratio_resolution_func; custom GDigicamManagerFunc like function to change the GDigicamResolution and GDigicamAspectRatio of the digicam like GstElement.
GDigicamManagerFunc set_locks_func; custom GDigicamManagerFunc like function to change the locks flags of the digicam like GstElement.
gdouble max_zoom_macro_disabled; The maximum overall zoom value with the macro mode disabled.
gdouble max_zoom_macro_enabled; The maximum overall zoom value with the macro mode enabled.
gdouble max_optical_zoom_macro_disabled; The maximum optical zoom value with the macro mode disabled.
gdouble max_optical_zoom_macro_enabled; The maximum optical zoom value with the macro mode enabled.
gdouble max_digital_zoom; The maximum digital zoom value.
GDigicamManagerFunc set_zoom_func; custom GDigicamManagerFunc like function to change the zoom value of the digicam like GstElement.
guint supported_audio_states; mask holding the audio states supported by the digicam like GstElement composed with
GDigicamManagerFunc set_audio_func; custom GDigicamManagerFunc like function to change the audio status of the digicam like GstElement.
guint supported_preview_modes;
GDigicamManagerFunc set_preview_mode_func;
GDigicamManagerFunc get_still_picture_func; custom GDigicamManagerFunc like function to grab still picture using the digicam like GstElement.
GDigicamManagerFunc start_recording_video_func; custom GDigicamManagerFunc like function to start a new video recording using the digicam like GstElement.
GDigicamManagerFunc pause_recording_video_func; custom GDigicamManagerFunc like function to pause the recording in progress using the digicam like GstElement.
GDigicamManagerFunc finish_recording_video_func; custom GDigicamManagerFunc like function to stop the recording in progress using the digicam like GstElement.
GDigicamManagerFunc handle_bus_message_func;
GDigicamManagerFunc handle_sync_bus_message_func;

GDigicamFocuspointposition

typedef struct {
        guint left;
        guint top;
        guint width;
        guint height;
} GDigicamFocuspointposition;

The GDigicamFocuspointposition structure contains the position of a single focus point.

guint left; left coordinate of the focus point.
guint top; top coordinate of the focus point.
guint width; width of the focus point.
guint height; height of the focus point.

GDigicamManagerFunc ()

gboolean            (*GDigicamManagerFunc)              (GDigicamManager *manager,
                                                         gpointer user_data);

This is a generic function to be used with every _set public function in GDigicam.

manager : A GDigicamManager
user_data : User data.
Returns : TRUE if succesful, FALSE otherwise.

G_DIGICAM_CAPABILITIES_VIEWFINDER

#define G_DIGICAM_CAPABILITIES_VIEWFINDER           ((guint32) 0x00000001)

Flag to set in the supported_modes field of a GDigicamDescriptor meaning that the digicam like GstElement it owns to has viewfinder capabilities.


G_DIGICAM_CAPABILITIES_FLASH

#define G_DIGICAM_CAPABILITIES_FLASH                ((guint32) 0x00000002)

Flag to set in the supported_modes field of a GDigicamDescriptor meaning that the digicam like GstElement it owns to has flash capabilities.


G_DIGICAM_CAPABILITIES_AUTOFOCUS

#define G_DIGICAM_CAPABILITIES_AUTOFOCUS                ((guint32) 0x00000004)

Flag to set in the supported_modes field of a GDigicamDescriptor meaning that the digicam like GstElement it owns to has auto focus capabilities.


G_DIGICAM_CAPABILITIES_CONTINUOUSAUTOFOCUS

#define G_DIGICAM_CAPABILITIES_CONTINUOUSAUTOFOCUS                ((guint32) 0x00000008)

Flag to set in the supported_modes field of a GDigicamDescriptor meaning that the digicam like GstElement it owns to has continous auto focus capabilities.


G_DIGICAM_CAPABILITIES_MANUALFOCUS

#define G_DIGICAM_CAPABILITIES_MANUALFOCUS            ((guint32) 0x00000010)

Flag to set in the supported_modes field of a GDigicamDescriptor meaning that the digicam like GstElement it owns to has manual focus capabilities.


G_DIGICAM_CAPABILITIES_MACROFOCUS

#define G_DIGICAM_CAPABILITIES_MACROFOCUS  ((guint32) 0x00000020)

Flag to set in the supported_modes field of a GDigicamDescriptor meaning that the digicam like GstElement it owns to has macro focus capabilities.


G_DIGICAM_CAPABILITIES_AUTOEXPOSURE

#define G_DIGICAM_CAPABILITIES_AUTOEXPOSURE          ((guint32) 0x00000040)

Flag to set in the supported_modes field of a GDigicamDescriptor meaning that the digicam like GstElement it owns to has auto exposure capabilities.


G_DIGICAM_CAPABILITIES_MANUALEXPOSURE

#define G_DIGICAM_CAPABILITIES_MANUALEXPOSURE           ((guint32) 0x00000080)

Flag to set in the supported_modes field of a GDigicamDescriptor meaning that the digicam like GstElement it owns to has manual exposure capabilities.


G_DIGICAM_CAPABILITIES_METERING

#define G_DIGICAM_CAPABILITIES_METERING     ((guint32) 0x00010000)

Flag to set in the metering_modes field of a GDigicamDescriptor meaning that the digicam like GstElement it owns to has metering mode capabilities.


G_DIGICAM_CAPABILITIES_ASPECTRATIO

#define G_DIGICAM_CAPABILITIES_ASPECTRATIO   ((guint32) 0x00020000)

Flag to set in the supported_modes field of a GDigicamDescriptor meaning that the digicam like GstElement it owns to has aspect ratio capabilities.


G_DIGICAM_CAPABILITIES_RESOLUTION

#define G_DIGICAM_CAPABILITIES_RESOLUTION          ((guint32) 0x00100000)

Flag to set in the supported_modes field of a GDigicamDescriptor meaning that the digicam like GstElement it owns to has resolution capabilities.


G_DIGICAM_CAPABILITIES_VIEWFINDER_NAME

#define G_DIGICAM_CAPABILITIES_VIEWFINDER_NAME      "viewfinder"

The name of the viewfinder GstElement.


G_DIGICAM_CAPABILITIES_OPTICALZOOM

#define G_DIGICAM_CAPABILITIES_OPTICALZOOM              ((guint32) 0x00200000)

Flag to set in the supported_modes field of a GDigicamDescriptor meaning that the digicam like GstElement it owns to has optical zoom capability.


G_DIGICAM_CAPABILITIES_DIGITALZOOM

#define G_DIGICAM_CAPABILITIES_DIGITALZOOM           ((guint32) 0x00400000)

Flag to set in the supported_modes field of a GDigicamDescriptor meaning that the digicam like GstElement it owns to has digital zoom capability.


G_DIGICAM_CAPABILITIES_AUTOISOSENSITIVITY

#define G_DIGICAM_CAPABILITIES_AUTOISOSENSITIVITY         ((guint32) 0x00000100)

Flag to set in the supported_modes field of a GDigicamDescriptor meaning that the digicam like GstElement it owns to has automatic iso sensitivity capabilities.


G_DIGICAM_CAPABILITIES_AUTOWHITEBALANCE

#define G_DIGICAM_CAPABILITIES_AUTOWHITEBALANCE     ((guint32) 0x00004000)

Flag to set in the supported_modes field of a GDigicamDescriptor meaning that the digicam like GstElement it owns to has automatic white balance capabilities.


G_DIGICAM_CAPABILITIES_MANUALISOSENSITIVITY

#define G_DIGICAM_CAPABILITIES_MANUALISOSENSITIVITY       ((guint32) 0x00000200)

Flag to set in the supported_modes field of a GDigicamDescriptor meaning that the digicam like GstElement it owns to has manual iso sensitivity capabilities.


G_DIGICAM_CAPABILITIES_MANUALWHITEBALANCE

#define G_DIGICAM_CAPABILITIES_MANUALWHITEBALANCE   ((guint32) 0x00008000)

Flag to set in the supported_modes field of a GDigicamDescriptor meaning that the digicam like GstElement it owns to has manual white balance capabilities.


G_DIGICAM_CAPABILITIES_QUALITY

#define G_DIGICAM_CAPABILITIES_QUALITY          ((guint32) 0x00080000)

Flag to set in the supported_qualities field of a GDigicamDescriptor meaning that the digicam like GstElement it owns to have the quality capabilities.


G_DIGICAM_CAPABILITIES_AUDIO

#define G_DIGICAM_CAPABILITIES_AUDIO           ((guint32) 0x00800000)

Flag to set in the supported_modes field of a GDigicamDescriptor meaning that the digicam like GstElement it owns to has audio capabilities.


enum GDigicamMode

    typedef enum {
        G_DIGICAM_MODE_NONE  = 0,

        G_DIGICAM_MODE_STILL = 1 << 0,
        G_DIGICAM_MODE_VIDEO = 1 << 1,

        G_DIGICAM_MODE_N     = (1 << 1)+1
    } GDigicamMode;

Indicates the camera mode; still picture or video.

G_DIGICAM_MODE_NONE No mode set.
G_DIGICAM_MODE_STILL Mode set to still picture.
G_DIGICAM_MODE_VIDEO Mode set to video.
G_DIGICAM_MODE_N Ceiling and number of modes.

enum GDigicamFlashmode

    typedef enum {
        G_DIGICAM_FLASHMODE_NONE                = 0,

        G_DIGICAM_FLASHMODE_OFF                 = 1 << 0,
        G_DIGICAM_FLASHMODE_ON                  = 1 << 1,
        G_DIGICAM_FLASHMODE_AUTO                = 1 << 2,
        G_DIGICAM_FLASHMODE_REDEYEREDUCTION     = 1 << 3,
        G_DIGICAM_FLASHMODE_REDEYEREDUCTIONAUTO = 1 << 4,
        G_DIGICAM_FLASHMODE_FILLIN              = 1 << 5,

        G_DIGICAM_FLASHMODE_N                   = (1 << 5)+1
    } GDigicamFlashmode;

Indicates the way in which the digicam flash will behave.

G_DIGICAM_FLASHMODE_NONE No flash mode set.
G_DIGICAM_FLASHMODE_OFF Flash mode is off, so it won't ever be triggered.
G_DIGICAM_FLASHMODE_ON Flash mode is on, so it will always be triggered.
G_DIGICAM_FLASHMODE_AUTO Flash mode set tu auto. This means flash will be triggered depending on the light level.
G_DIGICAM_FLASHMODE_REDEYEREDUCTION Flash mode set to red eyes reduction, so it will always be triggered in this mode.
G_DIGICAM_FLASHMODE_REDEYEREDUCTIONAUTO Flash mode set to do red eyes reduction automatically when it is needed.
G_DIGICAM_FLASHMODE_FILLIN Flash mode set to fill-in dimly lit areas.
G_DIGICAM_FLASHMODE_N Ceiling and number of flash modes.

enum GDigicamFocusmode

    typedef enum {
        G_DIGICAM_FOCUSMODE_NONE               = 0,

        G_DIGICAM_FOCUSMODE_MANUAL             = 1 << 0,
        G_DIGICAM_FOCUSMODE_AUTO               = 1 << 1,
        G_DIGICAM_FOCUSMODE_FACE               = 1 << 2,
        G_DIGICAM_FOCUSMODE_SMILE              = 1 << 3,
        G_DIGICAM_FOCUSMODE_CENTROID           = 1 << 4,
        G_DIGICAM_FOCUSMODE_CONTINUOUSAUTO     = 1 << 5,
        G_DIGICAM_FOCUSMODE_CONTINUOUSCENTROID = 1 << 6,

        G_DIGICAM_FOCUSMODE_N                  = (1 << 6)+1
    } GDigicamFocusmode;

Indicates the way in which the digicam focus mode will behave.

G_DIGICAM_FOCUSMODE_NONE No focus mode set.
G_DIGICAM_FOCUSMODE_MANUAL Focus mode set to manual.
G_DIGICAM_FOCUSMODE_AUTO Focus mode set to one-shot auto.
G_DIGICAM_FOCUSMODE_FACE Focus mode set to face auto recognition.
G_DIGICAM_FOCUSMODE_SMILE Focus mode set to smile auto recognition.
G_DIGICAM_FOCUSMODE_CENTROID Focus mode set to centroid one-shot auto.
G_DIGICAM_FOCUSMODE_CONTINUOUSAUTO Focus mode set to continous centroid auto.
G_DIGICAM_FOCUSMODE_CONTINUOUSCENTROID Focus mode set to continuous centroid.
G_DIGICAM_FOCUSMODE_N Ceiling and number of focus modes.

enum GDigicamExposuremode

    typedef enum {
        G_DIGICAM_EXPOSUREMODE_NONE          = 0,

        G_DIGICAM_EXPOSUREMODE_MANUAL        = 1 << 0,
        G_DIGICAM_EXPOSUREMODE_AUTO          = 1 << 1,
        G_DIGICAM_EXPOSUREMODE_NIGHT         = 1 << 2,
        G_DIGICAM_EXPOSUREMODE_BACKLIGHT     = 1 << 3,
        G_DIGICAM_EXPOSUREMODE_SPOTLIGHT     = 1 << 4,
        G_DIGICAM_EXPOSUREMODE_SPORTS        = 1 << 5,
        G_DIGICAM_EXPOSUREMODE_SNOW          = 1 << 6,
        G_DIGICAM_EXPOSUREMODE_BEACH         = 1 << 7,
        G_DIGICAM_EXPOSUREMODE_LARGEAPERTURE = 1 << 8,
        G_DIGICAM_EXPOSUREMODE_SMALLAPERTURE = 1 << 9,
        G_DIGICAM_EXPOSUREMODE_PORTRAIT      = 1 << 10,
        G_DIGICAM_EXPOSUREMODE_NIGHTPORTRAIT = 1 << 11,
        G_DIGICAM_EXPOSUREMODE_LANDSCAPE     = 1 << 12,

        G_DIGICAM_EXPOSUREMODE_N             = (1 << 12)+1
    } GDigicamExposuremode;

Indicates the camera exposure mode.

G_DIGICAM_EXPOSUREMODE_NONE No exposure mode set.
G_DIGICAM_EXPOSUREMODE_MANUAL Exposure mode set to manual.
G_DIGICAM_EXPOSUREMODE_AUTO Exposure mode set to auto.
G_DIGICAM_EXPOSUREMODE_NIGHT Exposure mode set to night.
G_DIGICAM_EXPOSUREMODE_BACKLIGHT Exposure mode set to backlight.
G_DIGICAM_EXPOSUREMODE_SPOTLIGHT Exposure mode set to spotlight.
G_DIGICAM_EXPOSUREMODE_SPORTS Exposure mode set to sports.
G_DIGICAM_EXPOSUREMODE_SNOW Exposure mode set to snow.
G_DIGICAM_EXPOSUREMODE_BEACH Exposure mode set to beach.
G_DIGICAM_EXPOSUREMODE_LARGEAPERTURE Exposure mode set to large aperture.
G_DIGICAM_EXPOSUREMODE_SMALLAPERTURE Exposure mode set to small aperture.
G_DIGICAM_EXPOSUREMODE_PORTRAIT Exposure mode set to portrait.
G_DIGICAM_EXPOSUREMODE_NIGHTPORTRAIT Exposure mode set to night
G_DIGICAM_EXPOSUREMODE_LANDSCAPE Exposure mode set to landscape time portrait.
G_DIGICAM_EXPOSUREMODE_N Ceiling and number of exposure modes.

enum GDigicamIsosensitivitymode

    typedef enum {
        G_DIGICAM_ISOSENSITIVITYMODE_NONE   = 0,

        G_DIGICAM_ISOSENSITIVITYMODE_MANUAL = 1 << 0,
        G_DIGICAM_ISOSENSITIVITYMODE_AUTO   = 1 << 1,

        G_DIGICAM_ISOSENSITIVITYMODE_N      = (1 << 1)+1
    } GDigicamIsosensitivitymode;

Indicates the ISO sensitivity mode.

G_DIGICAM_ISOSENSITIVITYMODE_NONE No ISO mode set.
G_DIGICAM_ISOSENSITIVITYMODE_MANUAL ISO mode set to manual sensitivity.
G_DIGICAM_ISOSENSITIVITYMODE_AUTO ISO mode set to auto sensitivity.
G_DIGICAM_ISOSENSITIVITYMODE_N Ceiling and number of ISO modes.

enum GDigicamWhitebalancemode

    typedef enum {
        G_DIGICAM_WHITEBALANCEMODE_NONE         = 0,

        G_DIGICAM_WHITEBALANCEMODE_MANUAL       = 1 << 0,
        G_DIGICAM_WHITEBALANCEMODE_AUTO         = 1 << 1,
        G_DIGICAM_WHITEBALANCEMODE_SUNLIGHT     = 1 << 2,
        G_DIGICAM_WHITEBALANCEMODE_CLOUDY       = 1 << 3,
        G_DIGICAM_WHITEBALANCEMODE_SHADE        = 1 << 4,
        G_DIGICAM_WHITEBALANCEMODE_TUNGSTEN     = 1 << 5,
        G_DIGICAM_WHITEBALANCEMODE_FLUORESCENT  = 1 << 6,
        G_DIGICAM_WHITEBALANCEMODE_INCANDESCENT = 1 << 7,
        G_DIGICAM_WHITEBALANCEMODE_FLASH        = 1 << 8,
        G_DIGICAM_WHITEBALANCEMODE_SUNSET       = 1 << 9,

        G_DIGICAM_WHITEBALANCEMODE_N            = (1 << 9)+1
    } GDigicamWhitebalancemode;

Indicates the white balance mode.

G_DIGICAM_WHITEBALANCEMODE_NONE No white balance mode set.
G_DIGICAM_WHITEBALANCEMODE_MANUAL White balance mode is set to manual.
G_DIGICAM_WHITEBALANCEMODE_AUTO White balance mode is set to auto.
G_DIGICAM_WHITEBALANCEMODE_SUNLIGHT White balance mode is set to sunlight.
G_DIGICAM_WHITEBALANCEMODE_CLOUDY White balance mode is set to cloudy.
G_DIGICAM_WHITEBALANCEMODE_SHADE White balance mode is set to shade.
G_DIGICAM_WHITEBALANCEMODE_TUNGSTEN White balance mode is set to tungsten.
G_DIGICAM_WHITEBALANCEMODE_FLUORESCENT White balance mode is set to fluorescent.
G_DIGICAM_WHITEBALANCEMODE_INCANDESCENT White balance mode is set to incandescent.
G_DIGICAM_WHITEBALANCEMODE_FLASH White balance mode is set to flash.
G_DIGICAM_WHITEBALANCEMODE_SUNSET White balance mode is set to sunset.
G_DIGICAM_WHITEBALANCEMODE_N

enum GDigicamAperturemode

    typedef enum {
        G_DIGICAM_APERTUREMODE_INVALID = -1,

        G_DIGICAM_APERTUREMODE_MANUAL,
        G_DIGICAM_APERTUREMODE_AUTO,

        G_DIGICAM_APERTUREMODE_N
    } GDigicamAperturemode;

Indicates the way in which the digicam aperture will behave.

G_DIGICAM_APERTUREMODE_INVALID Invalid and bottom limit of aperture modes.
G_DIGICAM_APERTUREMODE_MANUAL Aperture mode set to manual.
G_DIGICAM_APERTUREMODE_AUTO Aperture mode set to auto.
G_DIGICAM_APERTUREMODE_N Ceiling and number of aperture modes.

enum GDigicamMeteringmode

    typedef enum {
        G_DIGICAM_METERINGMODE_NONE = 0,

        G_DIGICAM_METERINGMODE_AVERAGE = 1 << 0,
        G_DIGICAM_METERINGMODE_SPOT    = 1 << 1,
        G_DIGICAM_METERINGMODE_MATRIX  = 1 << 2,

        G_DIGICAM_METERINGMODE_N       = (1 << 2)+1
    } GDigicamMeteringmode;

Indicates the metering mode for exposure.

G_DIGICAM_METERINGMODE_NONE No metering mode set.
G_DIGICAM_METERINGMODE_AVERAGE Metering mode set to center weighted average.
G_DIGICAM_METERINGMODE_SPOT Metering mode set to spot.
G_DIGICAM_METERINGMODE_MATRIX Metering mode set to matrix.
G_DIGICAM_METERINGMODE_N Ceiling and number of metering modes.

enum GDigicamShutterspeedmode

    typedef enum {
        G_DIGICAM_SHUTTERSPEEDMODE_INVALID = -1,

        G_DIGICAM_SHUTTERSPEEDMODE_MANUAL,
        G_DIGICAM_SHUTTERSPEEDMODE_AUTO,

        G_DIGICAM_SHUTTERSPEEDMODE_N
    } GDigicamShutterspeedmode;

Indicates the shutter speed mode.

G_DIGICAM_SHUTTERSPEEDMODE_INVALID Invalid and bottom limit of shutter speed modes.
G_DIGICAM_SHUTTERSPEEDMODE_MANUAL Shutter speed mode set to manual.
G_DIGICAM_SHUTTERSPEEDMODE_AUTO Shutter speed mode set to auto.
G_DIGICAM_SHUTTERSPEEDMODE_N Ceiling and number of shutter speed modes.

enum GDigicamAspectratio

    typedef enum {
        G_DIGICAM_ASPECTRATIO_NONE = 0,

        G_DIGICAM_ASPECTRATIO_4X3  = 1 << 0,
        G_DIGICAM_ASPECTRATIO_16X9 = 1 << 1,

        G_DIGICAM_ASPECTRATIO_N    = (1 << 1)+1
    } GDigicamAspectratio;

Indicates the aspect ratio.

G_DIGICAM_ASPECTRATIO_NONE No aspect ratio set.
G_DIGICAM_ASPECTRATIO_4X3 Aspect ratio set to 4x3.
G_DIGICAM_ASPECTRATIO_16X9 Aspect ratio set to 16x9.
G_DIGICAM_ASPECTRATIO_N Ceiling and number of aspect ratios.

enum GDigicamColorfilter

    typedef enum {
        G_DIGICAM_COLORFILTER_NONE   = 0,

        G_DIGICAM_COLORFILTER_NORMAL = 1 << 0,
        G_DIGICAM_COLORFILTER_SEPIA  = 1 << 1,
        G_DIGICAM_COLORFILTER_VIVID  = 1 << 2,
        G_DIGICAM_COLORFILTER_BW     = 1 << 3,

        G_DIGICAM_COLORFILTER_N      = (1 << 3)+1
    } GDigicamColorfilter;

Indicates the color filter to use when capturing.

G_DIGICAM_COLORFILTER_NONE No color filter set.
G_DIGICAM_COLORFILTER_NORMAL Color filter not set.
G_DIGICAM_COLORFILTER_SEPIA Color filter set to sepia.
G_DIGICAM_COLORFILTER_VIVID Color filter set to vivid.
G_DIGICAM_COLORFILTER_BW Color filter set to black & white.
G_DIGICAM_COLORFILTER_N Ceiling and number of color filters.

enum GDigicamQuality

    typedef enum {
        G_DIGICAM_QUALITY_NONE = 0,

        G_DIGICAM_QUALITY_HIGH = 1 << 0,
        G_DIGICAM_QUALITY_LOW  = 1 << 1,

        G_DIGICAM_QUALITY_N  = (1 << 1)+1
    } GDigicamQuality;

Indicates the capturing quality level.

G_DIGICAM_QUALITY_NONE No quality set.
G_DIGICAM_QUALITY_HIGH Quality set to high.
G_DIGICAM_QUALITY_LOW Quality set to low.
G_DIGICAM_QUALITY_N Ceiling and number of qualities.

enum GDigicamResolution

    typedef enum {
        G_DIGICAM_RESOLUTION_NONE   = 0,

        G_DIGICAM_RESOLUTION_HIGH   = 1 << 0,
        G_DIGICAM_RESOLUTION_MEDIUM = 1 << 1,
        G_DIGICAM_RESOLUTION_LOW    = 1 << 2,

        G_DIGICAM_RESOLUTION_N      = (1 << 2)+1
    } GDigicamResolution;

Indicates the capturing resolution.

G_DIGICAM_RESOLUTION_NONE No resolution set.
G_DIGICAM_RESOLUTION_HIGH Resolution set to high.
G_DIGICAM_RESOLUTION_MEDIUM Resolution set to medium.
G_DIGICAM_RESOLUTION_LOW Resolution set to low.
G_DIGICAM_RESOLUTION_N Ceiling and number of resolutions.

enum GDigicamVideostabilization

    typedef enum {
        G_DIGICAM_VIDEOSTABILIZATION_INVALID = -1,

        G_DIGICAM_VIDEOSTABILIZATION_OFF,
        G_DIGICAM_VIDEOSTABILIZATION_ON,

        G_DIGICAM_VIDEOSTABILIZATION_N
    } GDigicamVideostabilization;

Indicates the video stabilization mode.

G_DIGICAM_VIDEOSTABILIZATION_INVALID Invalid and bottom limit of video stabilization modes.
G_DIGICAM_VIDEOSTABILIZATION_OFF Video stabilization off.
G_DIGICAM_VIDEOSTABILIZATION_ON Video stabilization on.
G_DIGICAM_VIDEOSTABILIZATION_N Ceiling and number of video stabilization modes.

enum GDigicamLock

    typedef enum {
        G_DIGICAM_LOCK_AUTOFOCUS_NONE   = 0,

        G_DIGICAM_LOCK_AUTOFOCUS        = 1 << 0,
        G_DIGICAM_LOCK_AUTOEXPOSURE     = 1 << 1,
        G_DIGICAM_LOCK_AUTOWHITEBALANCE = 1 << 2,

        G_DIGICAM_LOCK_N                = 1 << 3
    } GDigicamLock;

GDigicam locks.

G_DIGICAM_LOCK_AUTOFOCUS_NONE No lock for autofocus set.
G_DIGICAM_LOCK_AUTOFOCUS Lock for the automatic focus.
G_DIGICAM_LOCK_AUTOEXPOSURE Lock for the automatic exposure settings.
G_DIGICAM_LOCK_AUTOWHITEBALANCE Lock for the automatic white balance.
G_DIGICAM_LOCK_N

enum GDigicamFocuspoints

    typedef enum {
        G_DIGICAM_FOCUSPOINTS_NONE           = 0,

        G_DIGICAM_FOCUSPOINTS_ONE            = 1 << 0,
        G_DIGICAM_FOCUSPOINTS_THREE_3X1      = 1 << 1,
        G_DIGICAM_FOCUSPOINTS_FIVE_CROSS     = 1 << 2,
        G_DIGICAM_FOCUSPOINTS_SEVEN_CROSS    = 1 << 3,
        G_DIGICAM_FOCUSPOINTS_NINE_SQUARE    = 1 << 4,
        G_DIGICAM_FOCUSPOINTS_ELEVEN_CROSS   = 1 << 5,
        G_DIGICAM_FOCUSPOINTS_TWELVE_3X4     = 1 << 6,
        G_DIGICAM_FOCUSPOINTS_TWELVE_4X3     = 1 << 7,
        G_DIGICAM_FOCUSPOINTS_SIXTEEN_SQUARE = 1 << 8,
        G_DIGICAM_FOCUSPOINTS_CUSTOM         = 1 << 9,

        G_DIGICAM_FOCUSPOINTS_N              = (1 << 9)+1
    } GDigicamFocuspoints;

GDigicam focus points.

G_DIGICAM_FOCUSPOINTS_NONE No focus points set.
G_DIGICAM_FOCUSPOINTS_ONE Just a single focus point placed in the center.
G_DIGICAM_FOCUSPOINTS_THREE_3X1 Three focus points in a horizontal line.
G_DIGICAM_FOCUSPOINTS_FIVE_CROSS Five focus points shaping a cross.
G_DIGICAM_FOCUSPOINTS_SEVEN_CROSS Seven focus points shaping a cross.
G_DIGICAM_FOCUSPOINTS_NINE_SQUARE Nine focues points drawing a square.
G_DIGICAM_FOCUSPOINTS_ELEVEN_CROSS Eleven focus points shaping a cross.
G_DIGICAM_FOCUSPOINTS_TWELVE_3X4 Twelve focus points; three horizontal, four vertical.
G_DIGICAM_FOCUSPOINTS_TWELVE_4X3 Twelve focus points; three vertical, four horizontal.
G_DIGICAM_FOCUSPOINTS_SIXTEEN_SQUARE Sixteen focus points drawing a square.
G_DIGICAM_FOCUSPOINTS_CUSTOM Custom; let's the user select the focus points
G_DIGICAM_FOCUSPOINTS_N Ceiling and number of focus points configurations.

enum GDigicamFocusmodestatus

    typedef enum {
        G_DIGICAM_FOCUSMODESTATUS_INVALID = -1,

        G_DIGICAM_FOCUSMODESTATUS_OFF,
        G_DIGICAM_FOCUSMODESTATUS_REQUEST,
        G_DIGICAM_FOCUSMODESTATUS_REACHED,
        G_DIGICAM_FOCUSMODESTATUS_UNABLETOREACH,
        G_DIGICAM_FOCUSMODESTATUS_LOST,

        G_DIGICAM_FOCUSMODESTATUS_N
    } GDigicamFocusmodestatus;

Indicates the status of the focus mode.

G_DIGICAM_FOCUSMODESTATUS_INVALID Invalid and bottom limit of focus mode statuses.
G_DIGICAM_FOCUSMODESTATUS_OFF Indicates that the manual focus mode is set so the focus status is not available.
G_DIGICAM_FOCUSMODESTATUS_REQUEST Indicates that the focus request is currently in progress.
G_DIGICAM_FOCUSMODESTATUS_REACHED Indicates that the focus has been reached.
G_DIGICAM_FOCUSMODESTATUS_UNABLETOREACH Indicates that the camera was unable to reach the focus.
G_DIGICAM_FOCUSMODESTATUS_LOST Indicates that the focus has been lost.
G_DIGICAM_FOCUSMODESTATUS_N Ceiling and number of focus mode statuses.

enum GDigicamAutoexposurestatus

    typedef enum {
        G_DIGICAM_AUTOEXPOSURESTATUS_INVALID = -1,

        G_DIGICAM_AUTOEXPOSURESTATUS_SUCCESS,
        G_DIGICAM_AUTOEXPOSURESTATUS_UNDEREXPOSURE,
        G_DIGICAM_AUTOEXPOSURESTATUS_OVEREXPOSURE,

        G_DIGICAM_AUTOEXPOSURESTATUS_N
    } GDigicamAutoexposurestatus;

Indicates the status of the auto exposure.

G_DIGICAM_AUTOEXPOSURESTATUS_INVALID Invalid and bottom limit of autoexposure statuses.
G_DIGICAM_AUTOEXPOSURESTATUS_SUCCESS Auto exposure has been successfully locked.
G_DIGICAM_AUTOEXPOSURESTATUS_UNDEREXPOSURE Auto exposure has been locked, but the photo will we underexposed in the current lighting conditions. Consider changing manually the exposure settings or freeing the lock and trying the locking again.
G_DIGICAM_AUTOEXPOSURESTATUS_OVEREXPOSURE Auto exposure has been locked, but the photo will we overexposed in the current lighting conditions. Consider changing manually the exposure settings or freeing the lock and trying the locking again.
G_DIGICAM_AUTOEXPOSURESTATUS_N Ceiling and number of autoexposure statuses.

enum GDigicamAudio

    typedef enum {
        G_DIGICAM_AUDIO_NONE        = 0,

        G_DIGICAM_AUDIO_PLAYBACKON  = 1 << 0,
        G_DIGICAM_AUDIO_PLAYBACKOFF = 1 << 1,
        G_DIGICAM_AUDIO_RECORDON    = 1 << 2,
        G_DIGICAM_AUDIO_RECORDOFF   = 1 << 3,

        G_DIGICAM_AUDIO_N           = 1 << 4
    } GDigicamAudio;

GDigicam audio states.

G_DIGICAM_AUDIO_NONE No audio settings.
G_DIGICAM_AUDIO_PLAYBACKON Audio playback is on.
G_DIGICAM_AUDIO_PLAYBACKOFF Audio playback is off.
G_DIGICAM_AUDIO_RECORDON Audio recording is on.
G_DIGICAM_AUDIO_RECORDOFF Audio recording is off.
G_DIGICAM_AUDIO_N Ceiling and number of audio settings.

GDigicamManager

typedef struct {
} GDigicamManager;

The GDigicamManager structure contains only private data and should not be accessed directly.


GDigicamManagerClass

typedef struct {
} GDigicamManagerClass;

Base class for GDigicamManager.


g_digicam_manager_new ()

GDigicamManager*    g_digicam_manager_new               (void);

Creates a new GDigicamManager object.

Returns : The newly created GDigicamManager object

g_digicam_manager_set_gstreamer_bin ()

gboolean            g_digicam_manager_set_gstreamer_bin (GDigicamManager *manager,
                                                         GstElement *gst_bin,
                                                         GDigicamDescriptor *descriptor,
                                                         GError **error);

Sets the GstElement bin with which interact with the digicam and stablish the internal structure with stores the digicam capabilities.

manager : A GDigicamManager
gst_bin : The GstElement bin which controls de digicam.
descriptor : The GDigicamDescriptor defining the GstElement, or NULL if we want GDigicamManager to provide a automatic one.
error : A GError to store the result of the operation.
Returns : True if success, False otherwise.

g_digicam_manager_get_gstreamer_bin ()

gboolean            g_digicam_manager_get_gstreamer_bin (GDigicamManager *manager,
                                                         GstElement **gst_bin,
                                                         GError **error);

Gets the GstElement bin with which interact with the digicam.

manager : A GDigicamManager
gst_bin : The GstElement bin which controls de digicam.
error : A GError to store the result of the operation.
Returns : True if success, FALSE otherwise.

g_digicam_manager_query_capabilities ()

gboolean            g_digicam_manager_query_capabilities
                                                        (GDigicamManager *manager,
                                                         GDigicamDescriptor **descriptor,
                                                         GError **error);

Gets the digicam descriptor from the GDigicamManager object.

manager : A GDigicamManager
descriptor : A pointer in which to set a copy of the GDigicamDescriptor from the GDigicamManager that will be have to be freed with g_digicam_manager_descriptor_free.
error : A GError to store the result of the operation.
Returns : True if success, False otherwise.

g_digicam_manager_set_mode ()

gboolean            g_digicam_manager_set_mode          (GDigicamManager *manager,
                                                         GDigicamMode mode,
                                                         GError **error,
                                                         gpointer user_data);

Sets the working mode in the GDigicamManager object.

manager : A GDigicamManager
mode : The mode to set in the GDigicamManager
error : A GError to store the result of the operation.
user_data : Data to be used with the customized set function provided by the user in the GDigicamDescriptor.
Returns : True if success, False otherwise.

g_digicam_manager_get_mode ()

gboolean            g_digicam_manager_get_mode          (GDigicamManager *manager,
                                                         GDigicamMode *mode,
                                                         GError **error);

Gets the working mode from the GDigicamManager object.

manager : A GDigicamManager
mode : A pointer in which to set the mode from the GDigicamManager
error : A GError to store the result of the operation.
Returns : True if success, FALSE otherwise.

g_digicam_manager_set_flash_mode ()

gboolean            g_digicam_manager_set_flash_mode    (GDigicamManager *manager,
                                                         GDigicamFlashmode flash_mode,
                                                         GError **error,
                                                         gpointer user_data);

Sets the flash mode in the GDigicamManager object.

manager : A GDigicamManager
flash_mode : The flash mode to set in the GDigicamManager
error : A GError to store the result of the operation.
user_data : Data to be used with the customized set function provided by the user in the GDigicamDescriptor.
Returns : True if success, False otherwise.

g_digicam_manager_get_flash_mode ()

gboolean            g_digicam_manager_get_flash_mode    (GDigicamManager *manager,
                                                         GDigicamFlashmode *flash_mode,
                                                         GError **error);

Gets the flash mode from the GDigicamManager object.

manager : A GDigicamManager
flash_mode : A pointer in which to set the flash mode from the GDigicamManager
error : A GError to store the result of the operation.
Returns : True if success, FALSE otherwise.

g_digicam_manager_set_focus_mode ()

gboolean            g_digicam_manager_set_focus_mode    (GDigicamManager *manager,
                                                         GDigicamFocusmode focus_mode,
                                                         gboolean macro_enabled,
                                                         GError **error,
                                                         gpointer user_data);

Sets the current focus mode and autofocus algorithm, in case of automatic focus setting.

manager : A GDigicamManager
focus_mode : the GDigicamFocusmode value to set.
macro_enabled : wether macro focus is enabled or not.
error : A GError to store the result of the operation.
user_data : Data to be used with the customized set function provided by the user in the GDigicamDescriptor.
Returns : True if success, False otherwise.

g_digicam_manager_get_focus_mode ()

gboolean            g_digicam_manager_get_focus_mode    (GDigicamManager *manager,
                                                         GDigicamFocusmode *focus_mode,
                                                         gboolean *macro_enabled,
                                                         GError **error);

Gets the current focus mode and autofocus algorithm, in case of automatic focus setting.

manager : A GDigicamManager
focus_mode : the GDigicamFocusmode value to get.
macro_enabled : wether macro focus is enabled or not.
error : A GError to store the result of the operation.
Returns : True if success, FALSE otherwise.

g_digicam_manager_set_focus_region_pattern ()

gboolean            g_digicam_manager_set_focus_region_pattern
                                                        (GDigicamManager *manager,
                                                         GDigicamFocuspoints focus_points,
                                                         guint64 active_points,
                                                         GError **error,
                                                         gpointer user_data);

Sets an active region in the image matrix for setting a focus pattern manually.

manager : A GDigicamManager
focus_points : the GDigicamFocuspoints points available.
active_points : active points used to manually focus.
error : A GError to store the result of the operation.
user_data : Data to be used with the customized set function provided by the user in the GDigicamDescriptor.
Returns : True if success, False otherwise.

g_digicam_manager_get_focus_region_pattern ()

gboolean            g_digicam_manager_get_focus_region_pattern
                                                        (GDigicamManager *manager,
                                                         GDigicamFocuspoints *focus_points,
                                                         guint64 *active_points,
                                                         GError **error);

Gets the current activated focus region pattern, used with the manual focus capability.

manager : A GDigicamManager
focus_points : the GDigicamFocuspoints focus points.
active_points : the active focus matrix points.
error : A GError to store the result of the operation.
Returns : True if success, FALSE otherwise.

g_digicam_manager_set_exposure_mode ()

gboolean            g_digicam_manager_set_exposure_mode (GDigicamManager *manager,
                                                         GDigicamExposuremode exposure_mode,
                                                         const GDigicamExposureconf *conf,
                                                         GError **error,
                                                         gpointer user_data);

Sets the exposure mode in the GDigicamManager object.

manager : A GDigicamManager
exposure_mode : The exposure mode to set in the GDigicamManager
conf : The exposure mode specific configuration to set automatically.
error : A GError to store the result of the operation.
user_data : Data to be used with the customized set function provided by the user in the GDigicamDescriptor.
Returns : True if success, False otherwise.

g_digicam_manager_get_exposure_mode ()

gboolean            g_digicam_manager_get_exposure_mode (GDigicamManager *manager,
                                                         GDigicamExposuremode *exposure_mode,
                                                         GError **error);

Gets the exposure mode from the GDigicamManager object.

manager : A GDigicamManager
exposure_mode : A pointer in which to set the exposure mode from the GDigicamManager
error : A GError to store the result of the operation.
Returns : True if success, FALSE otherwise.

g_digicam_manager_set_exposure_comp ()

gboolean            g_digicam_manager_set_exposure_comp (GDigicamManager *manager,
                                                         gdouble exposure_comp,
                                                         GError **error,
                                                         gpointer user_data);

Sets the exposure compensation value in the GDigicamManager object.

manager : A GDigicamManager
exposure_comp : The exposure compensation value to set in the GDigicamManager
error : A GError to store the result of the operation.
user_data : Data to be used with the customized set function provided by the user in the GDigicamDescriptor.
Returns : True if success, False otherwise.

g_digicam_manager_get_exposure_comp ()

gboolean            g_digicam_manager_get_exposure_comp (GDigicamManager *manager,
                                                         gdouble *exposure_comp,
                                                         GError **error);

Gets the exposure compensation from the GDigicamManager object.

manager : A GDigicamManager
exposure_comp : A pointer in which to set the exposure compensation value.
error : A GError to store the result of the operation.
Returns : True if success, FALSE otherwise.

g_digicam_manager_set_iso_sensitivity_mode ()

gboolean            g_digicam_manager_set_iso_sensitivity_mode
                                                        (GDigicamManager *manager,
                                                         GDigicamIsosensitivitymode iso_sensitivity_mode,
                                                         guint iso_level,
                                                         GError **error,
                                                         gpointer user_data);

Sets the ISO sensitivity mode in the GDigicamManager object.

manager : A GDigicamManager
iso_sensitivity_mode : The ISO sensitivity mode to set in the GDigicamManager
iso_level : used when G_DIGICAM_ISOSENSITIVITYMODE_MANUAL is set.
error : A GError to store the result of the operation.
user_data : Data to be used with the customized set function provided by the user in the GDigicamDescriptor.
Returns : True if success, False otherwise.

g_digicam_manager_get_iso_sensitivity_mode ()

gboolean            g_digicam_manager_get_iso_sensitivity_mode
                                                        (GDigicamManager *manager,
                                                         GDigicamIsosensitivitymode *iso_sensitivity_mode,
                                                         guint *iso_level,
                                                         GError **error);

Gets the ISO sensitivity mode from the GDigicamManager object.

manager : A GDigicamManager
iso_sensitivity_mode : A pointer in which to set the ISO sensitivity mode from the
iso_level : used when G_DIGICAM_ISOSENSITIVITYMODE_MANUAL is set. GDigicamManager
error : A GError to store the result of the operation.
Returns : True if success, FALSE otherwise.

g_digicam_manager_set_white_balance_mode ()

gboolean            g_digicam_manager_set_white_balance_mode
                                                        (GDigicamManager *manager,
                                                         GDigicamWhitebalancemode white_balance_mode,
                                                         guint white_balance_level,
                                                         GError **error,
                                                         gpointer user_data);

Sets the white balance mode in the GDigicamManager object.

manager : A GDigicamManager
white_balance_mode : The white balance mode to set in the GDigicamManager
white_balance_level : used when G_DIGICAM_WHITEBALANCEMODE_MANUAL is set.
error : A GError to store the result of the operation.
user_data : Data to be used with the customized set function provided by the user in the GDigicamDescriptor.
Returns : True if success, False otherwise.

g_digicam_manager_get_white_balance_mode ()

gboolean            g_digicam_manager_get_white_balance_mode
                                                        (GDigicamManager *manager,
                                                         GDigicamWhitebalancemode *white_balance_mode,
                                                         guint *white_balance_level,
                                                         GError **error);

Gets the white balance mode from the GDigicamManager object.

manager : A GDigicamManager
white_balance_mode : A pointer in which to set the white balance mode from the
white_balance_level : Manual value for white balance. GDigicamManager
error : A GError to store the result of the operation.
Returns : True if success, FALSE otherwise.

g_digicam_manager_set_metering_mode ()

gboolean            g_digicam_manager_set_metering_mode (GDigicamManager *manager,
                                                         GDigicamMeteringmode metering_mode,
                                                         GError **error,
                                                         gpointer user_data);

Sets the current metering mode and autometering algorithm, in case of automatic metering setting.

manager : A GDigicamManager
metering_mode : the GDigicamMeteringmode value to set.
error : A GError to store the result of the operation.
user_data : Data to be used with the customized set function provided by the user in the GDigicamDescriptor.
Returns : True if success, False otherwise.

g_digicam_manager_get_metering_mode ()

gboolean            g_digicam_manager_get_metering_mode (GDigicamManager *manager,
                                                         GDigicamMeteringmode *metering_mode,
                                                         GError **error);

Gets the metering mode from the GDigicamManager object.

manager : A GDigicamManager
metering_mode : A pointer in which to set the metering mode from the GDigicamManager
error : A GError to store the result of the operation.
Returns : True if success, FALSE otherwise.

g_digicam_manager_set_aspect_ratio ()

gboolean            g_digicam_manager_set_aspect_ratio  (GDigicamManager *manager,
                                                         GDigicamAspectratio aspect_ratio,
                                                         GError **error,
                                                         gpointer user_data);

Sets the aspect ratio in the GDigicamManager object.

manager : A GDigicamManager
aspect_ratio : The aspect ratio to set in the GDigicamManager
error : A GError to store the result of the operation.
user_data : Data to be used with the customized set function provided by the user in the GDigicamDescriptor.
Returns : True if success, False otherwise.

g_digicam_manager_get_aspect_ratio ()

gboolean            g_digicam_manager_get_aspect_ratio  (GDigicamManager *manager,
                                                         GDigicamAspectratio *aspect_ratio,
                                                         GError **error);

Gets the aspect_ratio mode from the GDigicamManager object.

manager : A GDigicamManager
aspect_ratio : A pointer in which to set the aspect ratio from the GDigicamManager
error : A GError to store the result of the operation.
Returns : True if success, FALSE otherwise.

g_digicam_manager_set_aspect_ratio_resolution ()

gboolean            g_digicam_manager_set_aspect_ratio_resolution
                                                        (GDigicamManager *manager,
                                                         GDigicamAspectratio aspect_ratio,
                                                         GDigicamResolution resolution,
                                                         GError **error,
                                                         gpointer user_data);

Sets the aspect ratio and resolution in the GDigicamManager object.

manager : A GDigicamManager
aspect_ratio : The aspect ratio to set in the GDigicamManager
resolution : The resolution ratio to set in the GDigicamManager
error : A GError to store the result of the operation.
user_data : Data to be used with the customized set function provided by the user in the GDigicamDescriptor.
Returns : True if success, False otherwise.

g_digicam_manager_set_quality ()

gboolean            g_digicam_manager_set_quality       (GDigicamManager *manager,
                                                         GDigicamQuality quality,
                                                         GError **error,
                                                         gpointer user_data);

Sets the quality in the GDigicamManager object.

manager : A GDigicamManager
quality : The quality to set in the GDigicamManager
error : A GError to store the result of the operation.
user_data : Data to be used with the customized set function provided by the user in the GDigicamDescriptor.
Returns : True if success, False otherwise.

g_digicam_manager_get_quality ()

gboolean            g_digicam_manager_get_quality       (GDigicamManager *manager,
                                                         GDigicamQuality *quality,
                                                         GError **error);

Gets the quality from the GDigicamManager object.

manager : A GDigicamManager
quality : A pointer in which to get the quality from the GDigicamManager
error : A GError to store the result of the operation.
Returns : True if success, FALSE otherwise.

g_digicam_manager_set_resolution ()

gboolean            g_digicam_manager_set_resolution    (GDigicamManager *manager,
                                                         GDigicamResolution resolution,
                                                         GError **error,
                                                         gpointer user_data);

Sets the resolution in the GDigicamManager object.

manager : A GDigicamManager
resolution : The resolution to set in the GDigicamManager
error : A GError to store the result of the operation.
user_data : Data to be used with the customized set function provided by the user in the GDigicamDescriptor.
Returns : True if success, False otherwise.

g_digicam_manager_get_resolution ()

gboolean            g_digicam_manager_get_resolution    (GDigicamManager *manager,
                                                         GDigicamResolution *resolution,
                                                         GError **error);

Gets the resolution from the GDigicamManager object.

manager : A GDigicamManager
resolution : A pointer in which to set the resolution from the GDigicamManager
error : A GError to store the result of the operation.
Returns : True if success, False otherwise.

g_digicam_manager_set_locks ()

gboolean            g_digicam_manager_set_locks         (GDigicamManager *manager,
                                                         GDigicamLock locks,
                                                         GError **error,
                                                         gpointer user_data);

Sets the locks in the GDigicamManager object.

manager : A GDigicamManager
locks : A GDigicamLock flag specifying which locks to set.
error : A GError to store the error condition.
user_data : Data to be used with the customized set function provided by the user in the GDigicamDescriptor.
Returns : True if success, False otherwise.

g_digicam_manager_get_locks ()

gboolean            g_digicam_manager_get_locks         (GDigicamManager *manager,
                                                         GDigicamLock *locks,
                                                         GError **error);

Sets the locks in the GDigicamManager object.

manager : A GDigicamManager
locks : A pointer in which to set the locks from the GDigicamManager.
error : A GError to store the error condition.
Returns : True if success, False otherwise.

g_digicam_manager_set_zoom ()

gboolean            g_digicam_manager_set_zoom          (GDigicamManager *manager,
                                                         gdouble zoom,
                                                         gboolean *digital,
                                                         GError **error,
                                                         gpointer user_data);

Sets the zoom in the GDigicamManager object.

manager : A GDigicamManager
zoom : The zoom to set in the GDigicamManager, from 1 to the maximum available.
digital : A pointer in which to set if we are using digital zoom or not.
error : A GError to store the error condition.
user_data : Data to be used with the customized set function provided by the user in the GDigicamDescriptor.
Returns : True if success, False otherwise.

g_digicam_manager_get_zoom ()

gboolean            g_digicam_manager_get_zoom          (GDigicamManager *manager,
                                                         gdouble *zoom,
                                                         gboolean *digital,
                                                         GError **error);

Gets the zoom value from the GDigicamManager object.

manager : A GDigicamManager
zoom : A pointer in which to set the zoom from the GDigicamManager.
digital : A pointer in which to set if we are using digital zoom or not.
error : A GError to store the result of the operation.
Returns : True if success, FALSE otherwise.

g_digicam_manager_set_audio ()

gboolean            g_digicam_manager_set_audio         (GDigicamManager *manager,
                                                         GDigicamAudio audio,
                                                         GError **error,
                                                         gpointer user_data);

Sets the audio status for the video recording operation.

manager : A GDigicamManager
audio : The audio state to set.
error : A GError to store the result of the operation.
user_data : Data to be used with the customized set function provided by the user in the GDigicamDescriptor.
Returns : True if success, False otherwise.

g_digicam_manager_get_audio ()

gboolean            g_digicam_manager_get_audio         (GDigicamManager *manager,
                                                         GDigicamAudio *audio,
                                                         GError **error);

Gets the audio state for the video recording operation.

manager : A GDigicamManager
audio : The audio state to get.
error : A GError to store the result of the operation.
Returns : True if success, FALSE otherwise.

g_digicam_manager_play_bin ()

gboolean            g_digicam_manager_play_bin          (GDigicamManager *manager,
                                                         gulong xwindow_id,
                                                         GError **error);

Plays the bin.

manager : A GDigicamManager
xwindow_id : Identifier of the X window to play in.
error : A GError to store the result of the operation.
Returns : True if success, False otherwise.

g_digicam_manager_stop_bin ()

gboolean            g_digicam_manager_stop_bin          (GDigicamManager *manager,
                                                         GError **error);

Stops the bin.

manager : A GDigicamManager
error : A GError to store the result of the operation.
Returns : True if success, False otherwise.

g_digicam_manager_get_xwindow_id ()

gboolean            g_digicam_manager_get_xwindow_id    (GDigicamManager *manager,
                                                         gulong *xwindow_id,
                                                         GError **error);

Gets the XWindow ID in which the bin will show its output.

manager : A GDigicamManager
xwindow_id : Identifier of the X window to play in.
error : A GError to store the result of the operation.
Returns : True if success, FALSE otherwise.

g_digicam_manager_capture_still_picture ()

gboolean            g_digicam_manager_capture_still_picture
                                                        (GDigicamManager *manager,
                                                         const gchar *filename,
                                                         GError **error,
                                                         gpointer user_data);

Captures a still picture.

manager : A GDigicamManager
filename : The file name to store the still picture created.
error : A GError to store the result of the operation.
user_data : Data to be used with the customized set function provided by the user in the GDigicamDescriptor.
Returns : True if success, False otherwise.

g_digicam_manager_start_recording_video ()

gboolean            g_digicam_manager_start_recording_video
                                                        (GDigicamManager *manager,
                                                         GError **error,
                                                         gpointer user_data);

Starts the video recording.

manager : A GDigicamManager
error : A GError to store the result of the operation.
user_data : Data to be used with the customized set function provided by the user in the GDigicamDescriptor.
Returns : True if success, False otherwise.

g_digicam_manager_pause_recording_video ()

gboolean            g_digicam_manager_pause_recording_video
                                                        (GDigicamManager *manager,
                                                         gboolean resume,
                                                         GError **error,
                                                         gpointer user_data);

Pauses the video recording.

manager : A GDigicamManager
resume : Whether to resume video recording or not.
error : A GError to store the result of the operation.
user_data : Data to be used with the customized set function provided by the user in the GDigicamDescriptor.
Returns : True if success, False otherwise.

g_digicam_manager_finish_recording_video ()

gboolean            g_digicam_manager_finish_recording_video
                                                        (GDigicamManager *manager,
                                                         GError **error,
                                                         gpointer user_data);

Stops the video recording.

manager : A GDigicamManager
error : A GError to store the result of the operation.
user_data : Data to be used with the customized set function provided by the user in the GDigicamDescriptor.
Returns : True if success, False otherwise.

g_digicam_manager_descriptor_new ()

GDigicamDescriptor* g_digicam_manager_descriptor_new    (void);

Creates an new and initialized GDigicamDescriptor.

Returns : the new and initialized GDigicamDescriptor.

g_digicam_manager_descriptor_free ()

void                g_digicam_manager_descriptor_free   (GDigicamDescriptor *descriptor);

Frees a GDigicamDescritor.

descriptor : the GDigicamDescritor to free.

g_digicam_manager_descriptor_copy ()

GDigicamDescriptor* g_digicam_manager_descriptor_copy   (const GDigicamDescriptor *orig_descriptor);

Duplicates a GDigicamDescriptor.

orig_descriptor : the GDigicamDescritor to copy.
Returns : the duplicated GDigicamDescriptor.