.. _DS_plugin_nvvideotestsrc:

Gst-nvvideotestsrc
==================

The ``Gst-nvvideotestsrc`` plugin uses CUDA to generate video test data in a variety of formats and patterns that is written directly to GPU output buffers using the video/x-raw(memory:NVMM) data type. 

The plugin can also be used to input raw video and generate GPU buffers at the output. 
The plugin provides properties to introduce jitter in buffer latencies which can be used to simulate 
network conditions locally. 

.. note::
  The ``Gst-nvvideotestsrc`` plugin is currently only supported on X86. 

Outputs
-------------------

This section summarizes the outputs of the ``Gst-nvvideotestsrc`` plugin.

* Output

  *     Gst Buffer with a test pattern
  *     Video Format: NV12, I420, RGBA (NVMM)

* Control parameters

  *     gpu-id
  *     animation-mode
  *     memtype
  *     blocksize
  *     pattern     

Gst Properties
----------------

The following tables describes the ``Gst`` properties of the ``Gst-nvvideotestsrc`` plugin.

.. csv-table:: nvvideotestsrc plugin properties
  :file: ../text/tables/Gst-nvvideotestsrc tables/DS_Plugin_gst-nvvideotestsrc_gst_properties.csv
  :widths: 20, 20, 20, 20
  :header-rows: 1

How to test
-----------

``nvvideotestsrc`` is currently supported for X86 only. support with "Jetson + dGPU" is not yet enabled.

Run following reference `gst-launch-1.0 pipeline` on DGPU setup.

A) Default SMPTE Pattern - 720p 60Hz

::

    gst-launch-1.0 nvvideotestsrc ! queue ! nveglglessink -e

B) Mandelbrot Pattern - 1080p 60Hz

 ::

    gst-launch-1.0 nvvideotestsrc pattern=mandelbrot ! 'video/x-raw(memory:NVMM), width=1920, height=1080, framerate=60/1' ! queue ! nveglglessink -e

C) Gradient Pattern - 720p 60Hz

::

    gst-launch-1.0 gst-launch-1.0 nvvideotestsrc pattern=2 ! queue ! nveglglessink -e