![]() |
![]() |
![]() |
Cheese Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Implemented Interfaces | Properties |
#include <cheese/cheese-camera-device.h> CheeseCameraDevice; struct CheeseVideoFormat; CheeseCameraDevice * cheese_camera_device_new (const gchar *uuid
,const gchar *device_node
,const gchar *name
,guint v4l_api_version
,GError **error
); const gchar * cheese_camera_device_get_name (CheeseCameraDevice *device
); const gchar * cheese_camera_device_get_uuid (CheeseCameraDevice *device
); const gchar * cheese_camera_device_get_device_node (CheeseCameraDevice *device
); CheeseVideoFormat * cheese_camera_device_get_best_format (CheeseCameraDevice *device
); GstCaps * cheese_camera_device_get_caps_for_format (CheeseCameraDevice *device
,CheeseVideoFormat *format
); GList * cheese_camera_device_get_format_list (CheeseCameraDevice *device
); const gchar * cheese_camera_device_get_src (CheeseCameraDevice *device
);
"device-node" gchar* : Read / Write / Construct Only "name" gchar* : Read / Write / Construct Only "uuid" gchar* : Read / Write / Construct Only "v4l-api-version" guint : Read / Write / Construct Only
typedef struct _CheeseCameraDevice CheeseCameraDevice;
Use the accessor functions below.
struct CheeseVideoFormat { gint width; gint height; };
A description of the resolution, in pixels, of the format to capture with a CheeseCameraDevice.
CheeseCameraDevice * cheese_camera_device_new (const gchar *uuid
,const gchar *device_node
,const gchar *name
,guint v4l_api_version
,GError **error
);
Tries to create a new CheeseCameraDevice with the supplied parameters. If
construction fails, NULL
is returned, and error
is set.
|
UUID of the device, as supplied by udev |
|
path to the device node of the video capture device. [type filename] |
|
human-readable name of the device, as supplied by udev |
|
version of the Video4Linux API that the device uses. Currently either 1 or 2 |
|
a location to store errors |
Returns : |
a new CheeseCameraDevice, or NULL
|
const gchar * cheese_camera_device_get_name (CheeseCameraDevice *device
);
Get a human-readable name for the device, as reported by udev, which is suitable for display to a user.
|
a CheeseCameraDevice |
Returns : |
the human-readable name of the video capture device. [transfer none] |
const gchar * cheese_camera_device_get_uuid (CheeseCameraDevice *device
);
Get the UUID of the device
, as reported by udev.
|
a CheeseCameraDevice |
Returns : |
the UUID of the video capture device. [transfer none] |
const gchar * cheese_camera_device_get_device_node
(CheeseCameraDevice *device
);
Get the path to the device node associated with the device
.
|
a CheeseCameraDevice |
Returns : |
the path to the device node of the video capture device. [transfer none] |
CheeseVideoFormat * cheese_camera_device_get_best_format
(CheeseCameraDevice *device
);
Get the CheeseVideoFormat with the highest rsolution for this device
.
|
a CheeseCameraDevice |
Returns : |
the highest-resolution supported CheeseVideoFormat. [transfer full] |
GstCaps * cheese_camera_device_get_caps_for_format (CheeseCameraDevice *device
,CheeseVideoFormat *format
);
Get the GstCaps for the given format
on the device
.
|
a CheeseCameraDevice |
|
a CheeseVideoFormat |
Returns : |
the GstCaps for the given format . [transfer full]
|
GList * cheese_camera_device_get_format_list
(CheeseCameraDevice *device
);
Get the sorted list of CheeseVideoFormat that the device
supports.
|
a CheeseCameraDevice |
Returns : |
list of CheeseVideoFormat. [element-type Cheese.VideoFormat][transfer container] |
const gchar * cheese_camera_device_get_src (CheeseCameraDevice *device
);
Get the name of the source GStreamer element for the device
. Currently,
this will be either v4lsrc or v4l2src, depending on the version of the
Video4Linux API that the device supports.
|
a CheeseCameraDevice |
Returns : |
the name of the source GStreamer element. [transfer none] |
"device-node"
property"device-node" gchar* : Read / Write / Construct Only
Path to the device node of the video capture device.
Default value: NULL
"name"
property"name" gchar* : Read / Write / Construct Only
Human-readable name of the video capture device, for display to the user.
Default value: NULL
"uuid"
property"uuid" gchar* : Read / Write / Construct Only
UUID of the video capture device.
Default value: NULL
"v4l-api-version"
property"v4l-api-version" guint : Read / Write / Construct Only
Version of the Video4Linux API that the device supports. Currently, either 1 or 2 are supported.
Allowed values: [1,2]
Default value: 2