From 2b152eae69cc7063e8b10df8ca2ed9325c85f2f0 Mon Sep 17 00:00:00 2001
From: Seungha Yang <seungha@centricular.com>
Date: Wed, 9 Sep 2020 21:38:33 +0900
Subject: videoparsers: Add vp9parse element

Adding vp9parse element to parse various stream information such as
resolution, profile, and so on. If upstream does not provide resolution and/or
profile, this would be useful for decodebin pipeline for autoplugging
suitable decoder element depending on template caps of each decoder element.

In addition, vp9parse element supports unpacking superframe into
single frame for decoders. The vp9 superframe is a frame which consists
of multiple frames (or superframe with one frame is allowed) followed by superframe
index block. Then unpacked each frame will be considered as normal frame
by decoder. The decision for unpacking will be done by downstream element's
"alignment" caps field, which can be "super-frame" or "frame".
If downstream specifies the "alignment" as "frame",
then vp9parse element will split an incoming superframe into single frames
and the superframe index (located at the end of the superframe) data
will be discarded by vp9parse element.

Part-of: <https://gitlab.freedesktop.org/gstreamer/gst-plugins-bad/-/merge_requests/1041>
---
 docs/plugins/gst_plugins_cache.json | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

(limited to 'docs')

diff --git a/docs/plugins/gst_plugins_cache.json b/docs/plugins/gst_plugins_cache.json
index f2ca4f690..82491a194 100644
--- a/docs/plugins/gst_plugins_cache.json
+++ b/docs/plugins/gst_plugins_cache.json
@@ -221903,6 +221903,33 @@
                 },
                 "properties": {},
                 "rank": "none"
+            },
+            "vp9parse": {
+                "author": "Seungha Yang <seungha@centricular.com>",
+                "description": "Parses VP9 streams",
+                "hierarchy": [
+                    "GstVp9Parse",
+                    "GstBaseParse",
+                    "GstElement",
+                    "GstObject",
+                    "GInitiallyUnowned",
+                    "GObject"
+                ],
+                "klass": "Codec/Parser/Converter/Video",
+                "long-name": "VP9 parser",
+                "pad-templates": {
+                    "sink": {
+                        "caps": "video/x-vp9:\n",
+                        "direction": "sink",
+                        "presence": "always"
+                    },
+                    "src": {
+                        "caps": "video/x-vp9:\n         parsed: true\n      alignment: { (string)super-frame, (string)frame }\n",
+                        "direction": "src",
+                        "presence": "always"
+                    }
+                },
+                "rank": "secondary"
             }
         },
         "filename": "gstvideoparsersbad",
-- 
cgit v1.2.1