## v4l2sink v4l2sink — Displays frames on a video4linux2 device |

## Synopsis

    struct              GstV4l2Sink;

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----GstObject
                   +----GstElement
                         +----GstBaseSink
                               +----GstVideoSink
                                     +----GstV4l2Sink

## Implemented Interfaces

GstV4l2Sink implements GstTuner, GstVideoOverlay, GstNavigation, GstColorBalance and GstVideoOrientation.

## Properties

      "device"                   gchar*                : Read / Write
      "device-fd"                gint                  : Read
      "device-name"              gchar*                : Read
      "flags"                    GstV4l2DeviceTypeFlags  : Read
      "overlay-height"           guint                 : Read / Write
      "overlay-left"             gint                  : Read / Write
      "overlay-top"              gint                  : Read / Write
      "overlay-width"            guint                 : Read / Write
      "queue-size"               guint                 : Read / Write
      "brightness"               gint                  : Read / Write
      "contrast"                 gint                  : Read / Write
      "hue"                      gint                  : Read / Write
      "saturation"               gint                  : Read / Write
      "crop-height"              guint                 : Read / Write
      "crop-left"                gint                  : Read / Write
      "crop-top"                 gint                  : Read / Write
      "crop-width"               guint                 : Read / Write
      "min-queued-bufs"          guint                 : Read / Write
      "io-mode"                  GstV4l2IOMode         : Read / Write
      "norm"                     V4L2_TV_norms         : Read / Write
      "extra-controls"           GstStructure*         : Read / Write
      "force-aspect-ratio"       gboolean              : Read / Write
      "pixel-aspect-ratio"       gchar*                : Read / Write

## Description

## Synopsis

### Element Information

plugin | video4linux2
author | Rob Clark <rob@ti.com>,
class | Sink/Video

### Element Pads

name | sink
direction | sink
presence | always
details | video/x-raw, format=(string)RGB15, width=(int)[ 1, 32768 ], height=(int)[ 1, 32768 ], framerate=(fraction)[ 0/1, 100/1 ]
| video/x-raw, format=(string)RGB16, width=(int)[ 1, 32768 ], height=(int)[ 1, 32768 ], framerate=(fraction)[ 0/1, 100/1 ]
| video/x-raw, format=(string)BGR, width=(int)[ 1, 32768 ], height=(int)[ 1, 32768 ], framerate=(fraction)[ 0/1, 100/1 ]
| video/x-raw, format=(string)RGB, width=(int)[ 1, 32768 ], height=(int)[ 1, 32768 ], framerate=(fraction)[ 0/1, 100/1 ]
| video/x-raw, format=(string)BGRx, width=(int)[ 1, 32768 ], height=(int)[ 1, 32768 ], framerate=(fraction)[ 0/1, 100/1 ]
| video/x-raw, format=(string)RGBx, width=(int)[ 1, 32768 ], height=(int)[ 1, 32768 ], framerate=(fraction)[ 0/1, 100/1 ]
| video/x-raw, format=(string)GRAY8, width=(int)[ 1, 32768 ], height=(int)[ 1, 32768 ], framerate=(fraction)[ 0/1, 100/1 ]
| video/x-raw, format=(string)YVU9, width=(int)[ 1, 32768 ], height=(int)[ 1, 32768 ], framerate=(fraction)[ 0/1, 100/1 ]
| video/x-raw, format=(string)YV12, width=(int)[ 1, 32768 ], height=(int)[ 1, 32768 ], framerate=(fraction)[ 0/1, 100/1 ]
| video/x-raw, format=(string)YUY2, width=(int)[ 1, 32768 ], height=(int)[ 1, 32768 ], framerate=(fraction)[ 0/1, 100/1 ]
| video/x-raw, format=(string)UYVY, width=(int)[ 1, 32768 ], height=(int)[ 1, 32768 ], framerate=(fraction)[ 0/1, 100/1 ]
| video/x-raw, format=(string)Y42B, width=(int)[ 1, 32768 ], height=(int)[ 1, 32768 ], framerate=(fraction)[ 0/1, 100/1 ]
| video/x-raw, format=(string)Y41B, width=(int)[ 1, 32768 ], height=(int)[ 1, 32768 ], framerate=(fraction)[ 0/1, 100/1 ]
| video/x-raw, format=(string)NV12, width=(int)[ 1, 32768 ], height=(int)[ 1, 32768 ], framerate=(fraction)[ 0/1, 100/1 ]
| video/x-raw, format=(string)NV21, width=(int)[ 1, 32768 ], height=(int)[ 1, 32768 ], framerate=(fraction)[ 0/1, 100/1 ]
| video/x-raw, format=(string)YUV9, width=(int)[ 1, 32768 ], height=(int)[ 1, 32768 ], framerate=(fraction)[ 0/1, 100/1 ]
| video/x-raw, format=(string)I420, width=(int)[ 1, 32768 ], height=(int)[ 1, 32768 ], framerate=(fraction)[ 0/1, 100/1 ]
| video/x-bayer, width=(int)[ 1, 32768 ], height=(int)[ 1, 32768 ], framerate=(fraction)[ 0/1, 100/1 ]
| image/jpeg, width=(int)[ 1, 32768 ], height=(int)[ 1, 32768 ], framerate=(fraction)[ 0/1, 100/1 ]
| image/jpeg, width=(int)[ 1, 32768 ], height=(int)[ 1, 32768 ], framerate=(fraction)[ 0/1, 100/1 ]
| image/jpeg, width=(int)[ 1, 32768 ], height=(int)[ 1, 32768 ], framerate=(fraction)[ 0/1, 100/1 ]
| video/x-dv, systemstream=(boolean)true, width=(int)[ 1, 32768 ], height=(int)[ 1, 32768 ], framerate=(fraction)[ 0/1, 100/1 ]
| video/mpegts
| video/mpeg, mpegversion=(int)4, systemstream=(boolean)false, width=(int)[ 1, 32768 ], height=(int)[ 1, 32768 ], framerate=(fraction)[ 0/1, 100/1 ]
| video/x-h263, variant=(string)itu, width=(int)[ 1, 32768 ], height=(int)[ 1, 32768 ], framerate=(fraction)[ 0/1, 100/1 ]
| video/x-h264, width=(int)[ 1, 32768 ], height=(int)[ 1, 32768 ], framerate=(fraction)[ 0/1, 100/1 ]
| video/x-sonix, width=(int)[ 1, 32768 ], height=(int)[ 1, 32768 ], framerate=(fraction)[ 0/1, 100/1 ]
| video/x-pwc1, width=(int)[ 1, 32768 ], height=(int)[ 1, 32768 ], framerate=(fraction)[ 0/1, 100/1 ]
| video/x-pwc2, width=(int)[ 1, 32768 ], height=(int)[ 1, 32768 ], framerate=(fraction)[ 0/1, 100/1 ]
| video/x-raw, format=(string)YVYU, width=(int)[ 1, 32768 ], height=(int)[ 1, 32768 ], framerate=(fraction)[ 0/1, 100/1 ]

## Details

### struct GstV4l2Sink

    struct GstV4l2Sink;

## Property Details

### The `"device"` property

      "device"                   gchar*                : Read / Write

Device location.

Default value: "/dev/video1"

### The `"device-fd"` property

      "device-fd"                gint                  : Read

File descriptor of the device.

Allowed values: >= G_MAXULONG

Default value: -1

### 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 `"overlay-height"` property

      "overlay-height"           guint                 : Read / Write

The height of the video overlay; default is equal to negotiated image height.

Default value: 0

### The `"overlay-left"` property

      "overlay-left"             gint                  : Read / Write

The leftmost (x) coordinate of the video overlay; top left corner of screen is 0,0.

Default value: 0

### The `"overlay-top"` property

      "overlay-top"              gint                  : Read / Write

The topmost (y) coordinate of the video overlay; top left corner of screen is 0,0.

Default value: 0

### The `"overlay-width"` property

      "overlay-width"            guint                 : Read / Write

The width of the video overlay; default is equal to negotiated image width.

Default value: 0

### 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: 12

### The `"brightness"` property

      "brightness"               gint                  : Read / Write

Picture brightness, or more precisely, the black level.

Default value: 0

### The `"contrast"` property

      "contrast"                 gint                  : Read / Write

Picture contrast or luma gain.

Default value: 0

### The `"hue"` property

      "hue"                      gint                  : Read / Write

Hue or color balance.

Default value: 0

### The `"saturation"` property

      "saturation"               gint                  : Read / Write

Picture color saturation or chroma gain.

Default value: 0

### The `"crop-height"` property

      "crop-height"              guint                 : Read / Write

The height of the video crop; default is equal to negotiated image height.

Default value: 0

### The `"crop-left"` property

      "crop-left"                gint                  : Read / Write

The leftmost (x) coordinate of the video crop; top left corner of image is 0,0.

Default value: 0

### The `"crop-top"` property

      "crop-top"                 gint                  : Read / Write

The topmost (y) coordinate of the video crop; top left corner of image is 0,0.

Default value: 0

### The `"crop-width"` property

      "crop-width"               guint                 : Read / Write

The width of the video crop; default is equal to negotiated image width.

Default value: 0

### The `"min-queued-bufs"` property

      "min-queued-bufs"          guint                 : Read / Write

Minimum number of queued bufs; v4l2sink won't dqbuf if the driver doesn't have more than this number (which normally you shouldn't change).

Allowed values: <= 16

Default value: 1

### The `"io-mode"` property

      "io-mode"                  GstV4l2IOMode         : Read / Write

I/O mode.

Default value: GST_V4L2_IO_AUTO

### The `"norm"` property

      "norm"                     V4L2_TV_norms         : Read / Write

video standard.

Default value: none

### The `"extra-controls"` property

      "extra-controls"           GstStructure*         : Read / Write

Extra v4l2 controls (CIDs) for the device.

### The `"force-aspect-ratio"` property

      "force-aspect-ratio"       gboolean              : Read / Write

When enabled, the pixel aspect ratio will be enforced.

Default value: TRUE

### The `"pixel-aspect-ratio"` property

      "pixel-aspect-ratio"       gchar*                : Read / Write

Overwrite the pixel aspect ratio of the device.

Default value: "1/1"