v4l2src

v4l2src — Reads frames from a Video4Linux2 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
  "brightness"               gint                  : Read / Write
  "contrast"                 gint                  : Read / Write
  "decimate"                 gint                  : Read / Write
  "hue"                      gint                  : Read / Write
  "saturation"               gint                  : Read / Write

Description

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

Example launch lines

1
gst-launch v4l2src ! xvimagesink
This pipeline shows the video captured from /dev/video0 tv card and for webcams.
1
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


The "brightness" property

  "brightness"               gint                  : Read / Write

Picture brightness, or more precisely, the black level

Default value: 0

Since 0.10.26


The "contrast" property

  "contrast"                 gint                  : Read / Write

Picture contrast or luma gain

Default value: 0

Since 0.10.26


The "decimate" property

  "decimate"                 gint                  : Read / Write

Only use every nth frame

Allowed values: >= 1

Default value: 1

Since 0.10.26


The "hue" property

  "hue"                      gint                  : Read / Write

Hue or color balance

Default value: 0

Since 0.10.26


The "saturation" property

  "saturation"               gint                  : Read / Write

Picture color saturation or chroma gain

Default value: 0

Since 0.10.26