flu_device_list_get ()

GList *
flu_device_list_get ();

Retrieves the list of currently available hardware devices as a GList of FluDevice.

Free the whole list afterwards with flu_device_list_free(), or keep extra references with flu_device_ref() and flu_device_unref()

flu_device_ref ()

FluDevice *
flu_device_ref (FluDevice *device);

Add a reference to an FluDevice

flu_device_unref ()

void
flu_device_unref (FluDevice *device);

Remove a reference from an FluDevice

flu_device_list_free ()

void
flu_device_list_free (GList *devices_list);

Frees a device list returned by flu_device_list_get().

This is a convenience wrapper around g_list_free_full() calling flu_device_unref() for each entry in the list.

flu_device_type_name_get ()

const gchar *
flu_device_type_name_get (FluDeviceType type);

Returns a human-readable string describing a device category

flu_device_type_get ()

FluDeviceType
flu_device_type_get (const FluDevice *device);

Category this device belongs to

flu_device_name_get ()

const gchar *
flu_device_name_get (const FluDevice *device);

A human-readable name of the device. Some devices might return a unique identifier instead.

flu_device_uri_get ()

const gchar *
flu_device_uri_get (const FluDevice *device);

Device URI

Could be dvd:///dev/dvd on Linux or dvd://\\.\D: on Windows, for example. Not all devices have a URI.

flu_device_label_get ()

const gchar *
flu_device_label_get (const FluDevice *device);

Media label read from the device. Not available for all kinds of media. Mostly human-readable.

flu_device_current_media_id_get ()

const gchar *
flu_device_current_media_id_get (const FluDevice *device);

Unique ID for the media currently inserted in the device (for devices with removable media, like DVDs, for example) or the name of the GStreamer plugin used to provide a device interface (for hardware devices like a camera or a microphone, for example).

In case of removable media, it is a 128-bit MD5 string (16 chars), NULL-terminated for convenience.

flu_device_is_fake ()

gboolean
flu_device_is_fake (const FluDevice *device);

Gets the information if device is a fake software device or a real hardware device. Useful to identify a real camera or microphone from emulated devices, for example.

flu_device_output_formats_get ()

const GList *
flu_device_output_formats_get (FluDevice *device);

Gets a list of output formats provided by this device.

flu_device_config_clear ()

void
flu_device_config_clear (FluDeviceConfig *config);

Clear (initialize to default values) a FluDeviceConfig structure and frees associated memory.

flu_device_config_copy ()

void
flu_device_config_copy (FluDeviceConfig *target,
                        const FluDeviceConfig *src);

Copy the information of a device configuration. This function will copy data from a source FluDeviceConfig into a target structure. While doing so it will first free the members of target to avoid memory leaks. Target does not need to be of the same type as src.

WARNING: Use flu_device_config_clear() to clear and free the information of the struct

flu_device_config_set ()

gboolean
flu_device_config_set (FluDevice *device,
                       const FluDeviceConfig *device_config);

WARNING: actual device configuration values are read when connecting the device to a recorder or opening it from a player. Calling flu_device_config_set() AFTER flu_recorder_connect_device() or flu_player_device_open() WILL NOT change recorder or player configurations.

flu_device_config_get ()

const FluDeviceConfig *
flu_device_config_get (const FluDevice *device);

Gets device configuration or NULL if device is not configurable.

enum FluDeviceType

Device categories, useful for searching for a specific device or using device-type-specific API

enum FluDeviceConfigAppCapturePlatform

enum FluDeviceConfigAppCaptureApi

enum FluDeviceConfigAppCaptureInjectMode

FluDeviceConfigAppCapture

typedef struct {
  gint pid;
  FluDeviceConfigAppCapturePlatform platform;
  FluDeviceConfigAppCaptureApi api;
  FluDeviceConfigAppCaptureInjectMode inject_mode;
  gchar *installation_dir;
} FluDeviceConfigAppCapture;

Configuration structure for application capture devices.

FluDeviceConfigData

Generic configuration data for each configurable device type. Used only in FluDeviceConfig.

FluDeviceConfig

typedef struct {
  FluDeviceType type;
  FluStreamInfo output_format;
  FluDeviceConfigData data;
} FluDeviceConfig;

FluDevice

typedef struct {
} FluDevice;

An opaque structure representing a hardware device. Obtain the list of available devices using flu_device_list_get() and examine each one through the different flu_device_*_get() methods. You also receive an FluDevice in the FLU_EVENT_TYPE_NEW_MEDIA_AVAILABLE and FLU_EVENT_TYPE_MEDIA_REMOVED events.