v4l2sink

v4l2sink

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
  "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
  "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

v4l2sink can be used to display video to v4l2 devices (screen overlays provided by the graphics hardware, tv-out, etc)

Example launch lines

1
gst-launch-1.0 videotestsrc ! v4l2sink device=/dev/video1
This pipeline displays a test pattern on /dev/video1
1
gst-launch-1.0 -v videotestsrc ! navigationtest ! v4l2sink
A pipeline to test navigation events. While moving the mouse pointer over the test signal you will see a black box following the mouse pointer. If you press the mouse button somewhere on the video and release it somewhere else a green box will appear where you pressed the button and a red one where you released it. (The navigationtest element is part of gst-plugins-good.) You can observe here that even if the images are scaled through hardware the pointer coordinates are converted back to the original video frame geometry so that the box can be drawn to the correct position. This also handles borders correctly, limiting coordinates to the image area

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, format=(string){ bggr, gbrg, grbg, rggb }, width=(int)[ 1, 32768 ], height=(int)[ 1, 32768 ], framerate=(fraction)[ 0/1, 2147483647/1 ]

video/x-dv, systemstream=(boolean)true

video/x-h263, variant=(string)itu

video/x-h264, stream-format=(string){ byte-stream, avc }, alignment=(string)au

video/x-pwc1, width=(int)[ 1, 32768 ], height=(int)[ 1, 32768 ], framerate=(fraction)[ 0/1, 2147483647/1 ]

video/x-pwc2, width=(int)[ 1, 32768 ], height=(int)[ 1, 32768 ], framerate=(fraction)[ 0/1, 2147483647/1 ]

video/x-raw, format=(string){ RGB16, BGR, RGB, GRAY8, GRAY16_LE, GRAY16_BE, YVU9, YV12, YUY2, YVYU, UYVY, Y42B, Y41B, YUV9, NV12_64Z32, NV24, NV61, NV16, NV21, NV12, I420, BGRA, BGRx, ARGB, xRGB, BGR15, RGB15 }, width=(int)[ 1, 32768 ], height=(int)[ 1, 32768 ], framerate=(fraction)[ 0/1, 2147483647/1 ]

video/x-sonix, width=(int)[ 1, 32768 ], height=(int)[ 1, 32768 ], framerate=(fraction)[ 0/1, 2147483647/1 ]

video/x-vp8

video/x-wmv, wmvversion=(int)3, format=(string)WVC1

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 "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 "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"