Cheese.CameraDeviceMonitor¶

Subclasses:: None

Methods¶

Inherited:: GObject.Object (37), Gio.AsyncInitable (4), Gio.Initable (2)
Structs:: GObject.ObjectClass (5)

class	`new` ()
class	`new_async` (cancellable, callback, *user_data)
class	`new_finish` (result)
	`coldplug` ()

Virtual Methods¶

Inherited:: GObject.Object (7), Gio.AsyncInitable (2), Gio.Initable (1)

	`do_added` (device)
	`do_removed` (device)

Properties¶

None

Signals¶

Inherited:: GObject.Object (1)

Name	Short Description
`added`	The `::added` signal is emitted when a camera is added, or on start-up after `Cheese.CameraDeviceMonitor.coldplug`() is called.
`removed`	The `::removed` signal is emitted when a camera is unplugged, or disabled on the system.

Fields¶

Inherited:: GObject.Object (1)

Name	Type	Access	Description
parent	`GObject.Object`	r
unused	`object`	r

Class Details¶

class Cheese.CameraDeviceMonitor(**kwargs)¶

Bases:: GObject.Object, Gio.AsyncInitable, Gio.Initable
Abstract:: No
Structure:: Cheese.CameraDeviceMonitorClass

Use the accessor functions below.

classmethod new()¶

Returns:: a new Cheese.CameraDeviceMonitor object.
Return type:: Cheese.CameraDeviceMonitor

Returns a new Cheese.CameraDeviceMonitor object. The initialization may block. See Cheese.CameraDeviceMonitor.new_async() for the asynchronous version.

classmethod new_async(cancellable, callback, *user_data)¶

Parameters:

cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
callback (Gio.AsyncReadyCallback or None) – a Gio.AsyncReadyCallback to call when the initialization is finished
user_data (object or None) – user data to pass to callback

Creates a new Cheese.CameraDeviceMonitor object asynchronously. Callback will be called when it is done. Use Cheese.CameraDeviceMonitor.new_finish() to get the result.

See Cheese.CameraDeviceMonitor.new() for the synchronous version.

classmethod new_finish(result)¶

Parameters:: result (Gio.AsyncResult) – the Gio.AsyncResult from the callback
Raises:: GLib.Error
Returns:: a new Cheese.CameraDeviceMonitor object or None if error is set.
Return type:: Cheese.CameraDeviceMonitor

Finishes creating a new Cheese.CameraDeviceMonitor object.

coldplug()¶: Enumerate plugged in cameras and emit ::added for those which already exist. This is only required when your program starts, so be sure to connect to at least the ::added signal before calling this function.

do_added(device) virtual¶

Parameters:: device (Cheese.CameraDevice) –

invoked when a new video capture device is connected

do_removed(device) virtual¶

Parameters:: device (Cheese.CameraDevice) –

invoked when a video capture device is removed

Signal Details¶

Cheese.CameraDeviceMonitor.signals.added(camera_device_monitor, device)¶

Signal Name:

added

Flags:

RUN_LAST, ACTION

Parameters:

camera_device_monitor (Cheese.CameraDeviceMonitor) – The object which received the signal
device (Cheese.CameraDevice) – a new Cheese.CameraDevice representing the video capture device

The ::added signal is emitted when a camera is added, or on start-up after Cheese.CameraDeviceMonitor.coldplug() is called.

Cheese.CameraDeviceMonitor.signals.removed(camera_device_monitor, device)¶

Signal Name:

removed

Flags:

RUN_LAST, ACTION

Parameters:

camera_device_monitor (Cheese.CameraDeviceMonitor) – The object which received the signal
device (Cheese.CameraDevice) – the Cheese.CameraDevice that was removed

The ::removed signal is emitted when a camera is unplugged, or disabled on the system.