## OGMRipSourceChooser OGMRipSourceChooser — Source chooser interface used by OGMRipSourceChooserWidget |

## Synopsis

    #include <ogmrip-source-chooser.h>

    enum                OGMRipSourceType;
                        OGMRipSourceChooser;
    struct              OGMRipSourceChooserIface;
    void                ogmrip_source_chooser_set_title     (OGMRipSourceChooser *chooser,
                                                             OGMDvdTitle *title);
    OGMDvdTitle *       ogmrip_source_chooser_get_title     (OGMRipSourceChooser *chooser);
    OGMRipSource *      ogmrip_source_chooser_get_active    (OGMRipSourceChooser *chooser,
                                                             OGMRipSourceType *type);
    void                ogmrip_source_chooser_select_language
                                                            (OGMRipSourceChooser *chooser,
                                                             gint language);

## Object Hierarchy

      GInterface
       +----OGMRipSourceChooser

## Prerequisites

OGMRipSourceChooser requires GtkWidget.

## Properties

      "source"                   gpointer              : Read / Write
      "title"                    gpointer              : Read / Write

## Description

## Details

### enum OGMRipSourceType

    typedef enum {
      OGMRIP_SOURCE_INVALID = -1,
      OGMRIP_SOURCE_NONE,
      OGMRIP_SOURCE_STREAM,
      OGMRIP_SOURCE_FILE
    } OGMRipSourceType;

The type of a source

`OGMRIP_SOURCE_INVALID` | This is not a valid source
`OGMRIP_SOURCE_NONE` | No source is selected
`OGMRIP_SOURCE_STREAM` | The source is a DVD stream
`OGMRIP_SOURCE_FILE` | The source is a file

### OGMRipSourceChooser

    typedef struct _OGMRipSourceChooser OGMRipSourceChooser;

### struct OGMRipSourceChooserIface

    struct OGMRipSourceChooserIface {
      GTypeInterface base_iface;

      void           (* set_title)       (OGMRipSourceChooser *chooser,
                                          OGMDvdTitle         *title);
      OGMDvdTitle *  (* get_title)       (OGMRipSourceChooser *chooser);

      OGMRipSource * (* get_active)      (OGMRipSourceChooser *chooser,
                                          OGMRipSourceType    *type);
      void           (* select_language) (OGMRipSourceChooser *chooser,
                                          gint                language);
    };

### ogmrip_source_chooser_set_title ()

    void                ogmrip_source_chooser_set_title     (OGMRipSourceChooser *chooser,
                                                             OGMDvdTitle *title);

Sets the OGMDvdTitle from which to select the source.

`chooser` : | An OGMRipSourceChooser
`title` : | An OGMDvdTitle

### ogmrip_source_chooser_get_title ()

    OGMDvdTitle *       ogmrip_source_chooser_get_title     (OGMRipSourceChooser *chooser);

Returns the OGMDvdTitle which was passed to `ogmrip_source_chooser_set_title()`.

`chooser` : | An OGMRipSourceChooser
Returns : | The current OGMDvdTitle

### ogmrip_source_chooser_get_active ()

    OGMRipSource *      ogmrip_source_chooser_get_active    (OGMRipSourceChooser *chooser,
                                                             OGMRipSourceType *type);

Returns the active source and its type.

`chooser` : | An OGMRipSourceChooser
`type` : | A pointer to store the type of the chooser
Returns : | The active OGMRipSource

### ogmrip_source_chooser_select_language ()

    void                ogmrip_source_chooser_select_language
                                                            (OGMRipSourceChooser *chooser,
                                                             gint language);

Select the first source entry of the chosen language.

`chooser` : | An OGMRipSourceChooser
`language` : | The language to select

## Property Details

### The `"source"` property

      "source"                   gpointer              : Read / Write

The active source.

### The `"title"` property

      "title"                    gpointer              : Read / Write

The DVD title.