## CheeseWidget CheeseWidget — A photo/video capture widget |

## Stability Level

Unstable, unless otherwise indicated

## Synopsis

    #include <cheese/cheese-widget.h>

    struct              CheeseWidget;
    GtkWidget *         cheese_widget_new                   (void);
    void                cheese_widget_get_error             (CheeseWidget *widget,
                                                             GError **error);
    enum                CheeseWidgetState;

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----GtkWidget
                   +----GtkContainer
                         +----GtkNotebook
                               +----CheeseWidget

## Implemented Interfaces

CheeseWidget implements AtkImplementorIface and GtkBuildable.

## Properties

      "state"                    CheeseWidgetState     : Read

## Description

CheeseWidget provides a basic photo and video capture widget, for embedding in an application.

## Details

### struct CheeseWidget

    struct CheeseWidget;

Use the accessor functions below.

### cheese_widget_new ()

    GtkWidget *         cheese_widget_new                   (void);

Creates a new CheeseWidget. Make sure that you call `cheese_gtk_init()`, and check for errors during initialization, before calling this function.

Returns : | a new CheeseWidget

### cheese_widget_get_error ()

    void                cheese_widget_get_error             (CheeseWidget *widget,
                                                             GError **error);

Listen for notify::state signals and call this when the current state is `CHEESE_WIDGET_STATE_ERROR`.

The returned GError will contain more details on what went wrong.

`widget` : | a CheeseWidget
`error` : | return location for the error

### enum CheeseWidgetState

    typedef enum {
      CHEESE_WIDGET_STATE_NONE,
      CHEESE_WIDGET_STATE_READY,
      CHEESE_WIDGET_STATE_ERROR
    } CheeseWidgetState;

Current CheeseWidget state.

`CHEESE_WIDGET_STATE_NONE` | Default state, camera uninitialized
`CHEESE_WIDGET_STATE_READY` | The camera should be ready and the widget should be displaying the preview
`CHEESE_WIDGET_STATE_ERROR` | An error occurred while setting up the camera, check what went wrong with `cheese_widget_get_error()`

## Property Details

### The `"state"` property

      "state"                    CheeseWidgetState     : Read

Current state of the widget.

Connect to notify::state signal to get notified about state changes. Useful to update other widgets sensitivities when the camera is ready or to handle errors if camera setup fails.

Default value: CHEESE_WIDGET_STATE_NONE