v4l2src

v4l2src — Reads frames from a video4linux2 (BT8x8) device

Synopsis

                    GstV4l2Src;

Object Hierarchy

  GObject
   +----GstObject
         +----GstElement
               +----GstBaseSrc
                     +----GstPushSrc
                           +----GstV4l2Src

Implemented Interfaces

GstV4l2Src implements GstURIHandler, GstImplementsInterface, GstTuner, GstColorBalance, GstVideoOrientation and GstPropertyProbe.

Properties

  "device"                   gchar*                : Read / Write
  "device-name"              gchar*                : Read
  "flags"                    GstV4l2DeviceTypeFlags  : Read
  "queue-size"               guint                 : Read / Write
  "always-copy"              gboolean              : Read / Write
  "device-fd"                gint                  : Read

Description

v4l2src can be used to capture video from v4l2 devices, like webcams and tv cards.

Example launch lines

gst-launch v4l2src ! xvimagesink
This pipeline shows the video captured from /dev/video0 tv card and for webcams.
gst-launch v4l2src ! jpegdec ! xvimagesink
This pipeline shows the video captured from a webcam that delivers jpeg images.

Details

GstV4l2Src

typedef struct _GstV4l2Src GstV4l2Src;

Opaque object.

Property Details

The "device" property

  "device"                   gchar*                : Read / Write

Device location.

Default value: "/dev/video0"


The "device-name" property

  "device-name"              gchar*                : Read

Name of the device.

Default value: NULL


The "flags" property

  "flags"                    GstV4l2DeviceTypeFlags  : Read

Device type flags.


The "queue-size" property

  "queue-size"               guint                 : Read / Write

Number of buffers to be enqueud in the driver in streaming mode.

Allowed values: [1,16]

Default value: 2


The "always-copy" property

  "always-copy"              gboolean              : Read / Write

If the buffer will or not be used directly from mmap.

Default value: TRUE


The "device-fd" property

  "device-fd"                gint                  : Read

File descriptor of the device.

Allowed values: >= G_MAXULONG

Default value: -1