GStreamer Good Plugins 1.0 Plugins Reference Manual: v4l2sink

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

## Properties

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

## Types and Values

struct | GstV4l2Sink

## Object Hierarchy

        GObject
        ╰── GInitiallyUnowned
            ╰── GstObject
                ╰── GstElement
                    ╰── GstBaseSink
                        ╰── GstVideoSink
                            ╰── GstV4l2Sink

## Implemented Interfaces

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

## Description

## Synopsis

### Element Information

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

### Element Pads

name | sink
direction | sink
presence | always
details | image/jpeg
| video/mpeg, mpegversion=(int)4, systemstream=(boolean)false
| video/mpeg, mpegversion=(int)2
| video/mpegts, systemstream=(boolean)true
| video/x-bayer, width=(int)[ 1, 32768 ], height=(int)[ 1, 32768 ], framerate=(fraction)[ 0/1, 100/1 ]
| video/x-dv, systemstream=(boolean)true
| video/x-h263, variant=(string)itu
| video/x-h264, stream-format=(string)byte-stream, alignment=(string)au
| 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){ RGB15, RGB16, BGR, RGB, BGRx, BGRA, xRGB, ARGB, GRAY8, YVU9, YV12, YUY2, UYVY, Y42B, Y41B, NV12_64Z32, YUV9, I420, YVYU, NV21, NV12 }, 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-vp8

## Functions

## Types and Values

### struct GstV4l2Sink

    struct GstV4l2Sink;

## Property Details

### The `“device”` property

      “device”                   gchar *

Device location.

Flags: Read / Write

Default value: "/dev/video1"

### The `“device-fd”` property

      “device-fd”                gint

File descriptor of the device.

Flags: Read

Allowed values: >= G_MAXULONG

Default value: -1

### The `“device-name”` property

      “device-name”              gchar *

Name of the device.

Flags: Read

Default value: NULL

### The `“flags”` property

      “flags”                    GstV4l2DeviceTypeFlags

Device type flags.

Flags: Read

### The `“overlay-height”` property

      “overlay-height”           guint

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

Flags: Read / Write

Default value: 0

### The `“overlay-left”` property

      “overlay-left”             gint

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

Flags: Read / Write

Default value: 0

### The `“overlay-top”` property

      “overlay-top”              gint

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

Flags: Read / Write

Default value: 0

### The `“overlay-width”` property

      “overlay-width”            guint

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

Flags: Read / Write

Default value: 0

### The `“queue-size”` property

      “queue-size”               guint

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

Flags: Read / Write

Allowed values: [1,16]

Default value: 12

### The `“brightness”` property

      “brightness”               gint

Picture brightness, or more precisely, the black level.

Flags: Read / Write

Default value: 0

### The `“contrast”` property

      “contrast”                 gint

Picture contrast or luma gain.

Flags: Read / Write

Default value: 0

### The `“hue”` property

      “hue”                      gint

Hue or color balance.

Flags: Read / Write

Default value: 0

### The `“saturation”` property

      “saturation”               gint

Picture color saturation or chroma gain.

Flags: Read / Write

Default value: 0

### The `“crop-height”` property

      “crop-height”              guint

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

Flags: Read / Write

Default value: 0

### The `“crop-left”` property

      “crop-left”                gint

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

Flags: Read / Write

Default value: 0

### The `“crop-top”` property

      “crop-top”                 gint

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

Flags: Read / Write

Default value: 0

### The `“crop-width”` property

      “crop-width”               guint

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

Flags: Read / Write

Default value: 0

### The `“min-queued-bufs”` property

      “min-queued-bufs”          guint

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).

Flags: Read / Write

Allowed values: <= 16

Default value: 1

### The `“io-mode”` property

      “io-mode”                  GstV4l2IOMode

I/O mode.

Flags: Read / Write

Default value: GST_V4L2_IO_AUTO

### The `“norm”` property

      “norm”                     V4L2_TV_norms

video standard.

Flags: Read / Write

Default value: none

### The `“extra-controls”` property

      “extra-controls”           GstStructure *

Extra v4l2 controls (CIDs) for the device.

Flags: Read / Write

### The `“force-aspect-ratio”` property

      “force-aspect-ratio”       gboolean

When enabled, the pixel aspect ratio will be enforced.

Flags: Read / Write

Default value: TRUE

### The `“pixel-aspect-ratio”` property

      “pixel-aspect-ratio”       gchar *

Overwrite the pixel aspect ratio of the device.

Flags: Read / Write

Default value: "1/1"