videotestsrc

videotestsrc — Creates a test video stream

Properties

GstVideoTestSrcPattern pattern Read / Write
gint64 timestamp-offset Read / Write
gboolean is-live Read / Write
gboolean peer-alloc Read / Write
GstVideoTestSrcColorSpec colorspec Read / Write
gint k0 Read / Write
gint kt Read / Write
gint kt2 Read / Write
gint kx Read / Write
gint kx2 Read / Write
gint kxt Read / Write
gint kxy Read / Write
gint ky Read / Write
gint ky2 Read / Write
gint kyt Read / Write
gint xoffset Read / Write
gint yoffset Read / Write
guint background-color Read / Write
guint foreground-color Read / Write
gint horizontal-speed Read / Write

Types and Values

Object Hierarchy

    GObject
    ╰── GInitiallyUnowned
        ╰── GstObject
            ╰── GstElement
                ╰── GstBaseSrc
                    ╰── GstPushSrc
                        ╰── GstVideoTestSrc

Description

The videotestsrc element is used to produce test video data in a wide variety of formats. The video test data produced can be controlled with the "pattern" property.

Example launch line

1
gst-launch -v videotestsrc pattern=snow ! ximagesink
Shows random noise in an X window.

Synopsis

Element Information

plugin

videotestsrc

author

David A. Schleef <ds@schleef.org>

class

Source/Video

Element Pads

name

src

direction

source

presence

always

details

video/x-raw, format=(string){ I420, YV12, YUY2, UYVY, AYUV, RGBx, BGRx, xRGB, xBGR, RGBA, BGRA, ARGB, ABGR, RGB, BGR, Y41B, Y42B, YVYU, Y444, v210, v216, NV12, NV21, NV16, NV24, GRAY8, GRAY16_BE, GRAY16_LE, v308, RGB16, BGR16, RGB15, BGR15, UYVP, A420, RGB8P, YUV9, YVU9, IYU1, ARGB64, AYUV64, r210, I420_10LE, I420_10BE, I422_10LE, I422_10BE, Y444_10LE, Y444_10BE, GBR, GBR_10LE, GBR_10BE }, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]

video/x-bayer, format=(string){ bggr, rggb, grbg, gbrg }, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]

Functions

Types and Values

struct GstVideoTestSrc

struct GstVideoTestSrc;

Opaque data structure.


enum GstVideoTestSrcPattern

The test pattern to produce.

The Gamut pattern creates a checkerboard pattern of colors at the edge of the YCbCr gamut and nearby colors that are out of gamut. The pattern is divided into 4 regions: black, white, red, and blue. After conversion to RGB, the out-of-gamut colors should be converted to the same value as their in-gamut neighbors. If the checkerboard pattern is still visible after conversion, this indicates a faulty conversion. Image manipulation, such as adjusting contrast or brightness, can also cause the pattern to be visible.

The Zone Plate pattern is based on BBC R&D Report 1978/23, and can be used to test spatial frequency response of a system. This pattern generator is controlled by the xoffset and yoffset parameters and also by all the parameters starting with 'k'. The default parameters produce a grey pattern. Try 'videotestsrc pattern=zone-plate kx2=20 ky2=20 kt=1' to produce something interesting.

Members

GST_VIDEO_TEST_SRC_SMPTE

A standard SMPTE test pattern

 

GST_VIDEO_TEST_SRC_SNOW

Random noise

 

GST_VIDEO_TEST_SRC_BLACK

A black image

 

GST_VIDEO_TEST_SRC_WHITE

A white image

 

GST_VIDEO_TEST_SRC_RED

A red image

 

GST_VIDEO_TEST_SRC_GREEN

A green image

 

GST_VIDEO_TEST_SRC_BLUE

A blue image

 

GST_VIDEO_TEST_SRC_CHECKERS1

Checkers pattern (1px)

 

GST_VIDEO_TEST_SRC_CHECKERS2

Checkers pattern (2px)

 

GST_VIDEO_TEST_SRC_CHECKERS4

Checkers pattern (4px)

 

GST_VIDEO_TEST_SRC_CHECKERS8

Checkers pattern (8px)

 

GST_VIDEO_TEST_SRC_CIRCULAR

Circular pattern

 

GST_VIDEO_TEST_SRC_BLINK

Alternate between black and white

 

GST_VIDEO_TEST_SRC_SMPTE75

SMPTE test pattern (75% color bars)

 

GST_VIDEO_TEST_SRC_ZONE_PLATE

Zone plate

 

GST_VIDEO_TEST_SRC_GAMUT

Gamut checking pattern

 

GST_VIDEO_TEST_SRC_CHROMA_ZONE_PLATE

Chroma zone plate

 

GST_VIDEO_TEST_SRC_SOLID

   

GST_VIDEO_TEST_SRC_BALL

Moving ball

 

GST_VIDEO_TEST_SRC_SMPTE100

SMPTE test pattern (100% color bars)

 

GST_VIDEO_TEST_SRC_BAR

Bar with foreground color

 

GST_VIDEO_TEST_SRC_PINWHEEL

Pinwheel

 

GST_VIDEO_TEST_SRC_SPOKES

Spokes

 

Property Details

The “pattern” property

  “pattern”                  GstVideoTestSrcPattern

Type of test pattern to generate.

Flags: Read / Write

Default value: SMPTE 100% color bars


The “timestamp-offset” property

  “timestamp-offset”         gint64

An offset added to timestamps set on buffers (in ns).

Flags: Read / Write

Default value: 0


The “is-live” property

  “is-live”                  gboolean

Whether to act as a live source.

Flags: Read / Write

Default value: FALSE


The “peer-alloc” property

  “peer-alloc”               gboolean

Ask the peer to allocate an output buffer.

Flags: Read / Write

Default value: TRUE


The “colorspec” property

  “colorspec”                GstVideoTestSrcColorSpec

Generate video in the given color specification (Deprecated: use a caps filter with video/x-raw-yuv,color-matrix="sdtv" or "hdtv" instead).

Flags: Read / Write

Default value: ITU-R Rec. BT.601


The “k0” property

  “k0”                       gint

Zoneplate zero order phase, for generating plain fields or phase offsets.

Flags: Read / Write

Default value: 0


The “kt” property

  “kt”                       gint

Zoneplate 1st order t phase, for generating phase rotation as a function of time.

Flags: Read / Write

Default value: 0


The “kt2” property

  “kt2”                      gint

Zoneplate 2nd order t phase, t*t/256 cycles per picture.

Flags: Read / Write

Default value: 0


The “kx” property

  “kx”                       gint

Zoneplate 1st order x phase, for generating constant horizontal frequencies.

Flags: Read / Write

Default value: 0


The “kx2” property

  “kx2”                      gint

Zoneplate 2nd order x phase, normalised to kx2/256 cycles per horizontal pixel at width/2 from origin.

Flags: Read / Write

Default value: 0


The “kxt” property

  “kxt”                      gint

Zoneplate x*t product phase, normalised to kxy/256 cycles per vertical pixel at width/2 from origin.

Flags: Read / Write

Default value: 0


The “kxy” property

  “kxy”                      gint

Zoneplate x*y product phase.

Flags: Read / Write

Default value: 0


The “ky” property

  “ky”                       gint

Zoneplate 1st order y phase, for generating contant vertical frequencies.

Flags: Read / Write

Default value: 0


The “ky2” property

  “ky2”                      gint

Zoneplate 2nd order y phase, normailsed to ky2/256 cycles per vertical pixel at height/2 from origin.

Flags: Read / Write

Default value: 0


The “kyt” property

  “kyt”                      gint

Zoneplate y*t product phase.

Flags: Read / Write

Default value: 0


The “xoffset” property

  “xoffset”                  gint

Zoneplate 2nd order products x offset.

Flags: Read / Write

Default value: 0


The “yoffset” property

  “yoffset”                  gint

Zoneplate 2nd order products y offset.

Flags: Read / Write

Default value: 0


The “background-color” property

  “background-color”         guint

Color to use for background color of some patterns. Default is black (0xff000000).

Flags: Read / Write

Default value: 4278190080


The “foreground-color” property

  “foreground-color”         guint

Color to use for solid-color pattern and foreground color of other patterns. Default is white (0xffffffff).

Flags: Read / Write

Default value: 4294967295


The “horizontal-speed” property

  “horizontal-speed”         gint

Scroll image number of pixels per frame (positive is scroll to the left).

Flags: Read / Write

Default value: 0