From: Víctor Manuel Jáquez Leal <vjaquez@igalia.com>
Date: Sun, 20 Sep 2020 06:31:23 +0000 (+0200)
Subject: va: h264dec: add documentation
X-Git-Tag: 1.19.3~507^2~1384
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=9e9e5c72d54b69cb3def2753066195e01ca5cad1;p=platform%2Fupstream%2Fgstreamer.git

va: h264dec: add documentation

Part-of: <https://gitlab.freedesktop.org/gstreamer/gst-plugins-bad/-/merge_requests/1585>
---

diff --git a/sys/va/gstvah264dec.c b/sys/va/gstvah264dec.c
index 841429f..6dc872d 100644
--- a/sys/va/gstvah264dec.c
+++ b/sys/va/gstvah264dec.c
@@ -18,6 +18,31 @@
  * Boston, MA 02110-1301, USA.
  */
 
+/**
+ * SECTION:element-vah264dec
+ * @title: vah264dec
+ * @short_description: A VA-API based H264 video decoder
+ *
+ * vah264dec decodes H264 bitstreams to VA surfaces using the
+ * installed and chosen [VA-API](https://01.org/linuxmedia/vaapi)
+ * driver.
+ *
+ * The decoding surfaces can be mapped onto main memory as video
+ * frames.
+ *
+ * ## Example launch line
+ * |[
+ * gst-launch-1.0 filesrc location=big_buck_bunny.mov ! parsebin ! vah264dec ! autovideosink
+ * ]|
+ *
+ */
+
+/* ToDo:
+ *
+ * + interlaced streams
+ * + mutiview and stereo profiles
+ */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif