nvcodec: Update for documentation

* Add Since marks
* Make use of GST_PARAM_CONDITIONALLY_AVAILABLE flag
* Add documentation template caps

1 files changed, 131 insertions, 24 deletions

diff --git a/docs/plugins/gst_plugins_cache.json b/docs/plugins/gst_plugins_cache.json
index cc487a4b0..cfd052e52 100644
--- a/docs/plugins/gst_plugins_cache.json
+++ b/docs/plugins/gst_plugins_cache.json
@@ -208108,12 +208108,12 @@
                 "long-name": "NVENC H.264 Video Encoder",
                 "pad-templates": {
                     "sink": {
-                        "caps": "video/x-raw:\n         format: { NV12, YV12, I420, BGRA, RGBA, Y444, VUYA }\n          width: [ 33, 4096 ]\n         height: [ 17, 4096 ]\n      framerate: [ 0/1, 2147483647/1 ]\n interlace-mode: { (string)progressive, (string)interleaved, (string)mixed }\n\nvideo/x-raw(memory:GLMemory):\n         format: { NV12, YV12, I420, BGRA, RGBA, Y444, VUYA }\n          width: [ 33, 4096 ]\n         height: [ 17, 4096 ]\n      framerate: [ 0/1, 2147483647/1 ]\n interlace-mode: { (string)progressive, (string)interleaved, (string)mixed }\n",
+                        "caps": "video/x-raw:\n         format: { NV12, YV12, I420, BGRA, RGBA, Y444, VUYA }\n          width: [ 145, 4096 ]\n         height: [ 49, 4096 ]\n      framerate: [ 0/1, 2147483647/1 ]\n interlace-mode: { (string)progressive }\n\nvideo/x-raw(memory:GLMemory):\n         format: { NV12, YV12, I420, BGRA, RGBA, Y444, VUYA }\n          width: [ 145, 4096 ]\n         height: [ 49, 4096 ]\n      framerate: [ 0/1, 2147483647/1 ]\n interlace-mode: { (string)progressive }\n",
                         "direction": "sink",
                         "presence": "always"
                     },
                     "src": {
-                        "caps": "video/x-h264:\n          width: [ 33, 4096 ]\n         height: [ 17, 4096 ]\n      framerate: [ 0/1, 2147483647/1 ]\n  stream-format: byte-stream\n      alignment: au\n        profile: { (string)main, (string)high, (string)high-4:4:4, (string)baseline }\n",
+                        "caps": "video/x-h264:\n          width: [ 145, 4096 ]\n         height: [ 49, 4096 ]\n      framerate: [ 0/1, 2147483647/1 ]\n  stream-format: byte-stream\n      alignment: au\n        profile: { (string)main, (string)high, (string)high-4:4:4, (string)baseline }\n",
                         "direction": "src",
                         "presence": "always"
                     }
@@ -208132,8 +208132,8 @@
                         "writable": true
                     },
                     "b-adapt": {
-                        "blurb": "Enable adaptive B-frame insert when lookahead is enabled (Exposed only if supported by device)",
-                        "conditionally-available": false,
+                        "blurb": "Enable adaptive B-frame insert when lookahead is enabled",
+                        "conditionally-available": true,
                         "construct": false,
                         "construct-only": false,
                         "controllable": false,
@@ -208144,8 +208144,8 @@
                         "writable": true
                     },
                     "bframes": {
-                        "blurb": "Number of B-frames between I and P (Exposed only if supported by device)",
-                        "conditionally-available": false,
+                        "blurb": "Number of B-frames between I and P",
+                        "conditionally-available": true,
                         "construct": false,
                         "construct-only": false,
                         "controllable": false,
@@ -208158,8 +208158,8 @@
                         "writable": true
                     },
                     "rc-lookahead": {
-                        "blurb": "Number of frames for frame type lookahead (Exposed only if supported by device)",
-                        "conditionally-available": false,
+                        "blurb": "Number of frames for frame type lookahead",
+                        "conditionally-available": true,
                         "construct": false,
                         "construct-only": false,
                         "controllable": false,
@@ -208172,8 +208172,8 @@
                         "writable": true
                     },
                     "temporal-aq": {
-                        "blurb": "Temporal Adaptive Quantization (Exposed only if supported by device)",
-                        "conditionally-available": false,
+                        "blurb": "Temporal Adaptive Quantization",
+                        "conditionally-available": true,
                         "construct": false,
                         "construct-only": false,
                         "controllable": false,
@@ -208184,8 +208184,8 @@
                         "writable": true
                     },
                     "vbv-buffer-size": {
-                        "blurb": "VBV(HRD) Buffer Size in kbits (0 = NVENC default) (Exposed only if supported by device)",
-                        "conditionally-available": false,
+                        "blurb": "VBV(HRD) Buffer Size in kbits (0 = NVENC default)",
+                        "conditionally-available": true,
                         "construct": false,
                         "construct-only": false,
                         "controllable": false,
@@ -208198,8 +208198,8 @@
                         "writable": true
                     },
                     "weighted-pred": {
-                        "blurb": "Weighted Prediction (Exposed only if supported by device)",
-                        "conditionally-available": false,
+                        "blurb": "Weighted Prediction",
+                        "conditionally-available": true,
                         "construct": false,
                         "construct-only": false,
                         "controllable": false,
@@ -208257,12 +208257,12 @@
                 "long-name": "NVDEC h265 Video Decoder",
                 "pad-templates": {
                     "sink": {
-                        "caps": "video/x-h265:\n  stream-format: byte-stream\n      alignment: au\n        profile: { (string)main, (string)main-10, (string)main-12 }\n          width: [ 144, 8192 ]\n         height: [ 144, 8192 ]\n",
+                        "caps": "video/x-h265:\n  stream-format: byte-stream\n      alignment: au\n        profile: { (string)main, (string)main-10, (string)main-12, (string)main-444, (string)main-444-10, (string)main-444-12 }\n          width: [ 144, 8192 ]\n         height: [ 144, 8192 ]\n",
                         "direction": "sink",
                         "presence": "always"
                     },
                     "src": {
-                        "caps": "video/x-raw:\n          width: [ 144, 8192 ]\n         height: [ 144, 8192 ]\n      framerate: [ 0/1, 2147483647/1 ]\n         format: { NV12, P010_10LE, P016_LE }\n\nvideo/x-raw(memory:GLMemory):\n          width: [ 144, 8192 ]\n         height: [ 144, 8192 ]\n      framerate: [ 0/1, 2147483647/1 ]\n         format: { NV12, P010_10LE, P016_LE }\n",
+                        "caps": "video/x-raw:\n          width: [ 144, 8192 ]\n         height: [ 144, 8192 ]\n      framerate: [ 0/1, 2147483647/1 ]\n         format: { NV12, P010_10LE, P016_LE, Y444, Y444_16LE, Y444_16LE }\n\nvideo/x-raw(memory:GLMemory):\n          width: [ 144, 8192 ]\n         height: [ 144, 8192 ]\n      framerate: [ 0/1, 2147483647/1 ]\n         format: { NV12, P010_10LE, P016_LE, Y444, Y444_16LE, Y444_16LE }\n",
                         "direction": "src",
                         "presence": "always"
                     }
@@ -208289,12 +208289,12 @@
                 "long-name": "NVENC HEVC Video Encoder",
                 "pad-templates": {
                     "sink": {
-                        "caps": "video/x-raw:\n         format: { NV12, YV12, I420, BGRA, RGBA, Y444, VUYA, P010_10LE, BGR10A2_LE, RGB10A2_LE, Y444_16LE }\n          width: [ 65, 8192 ]\n         height: [ 33, 8192 ]\n      framerate: [ 0/1, 2147483647/1 ]\n interlace-mode: { (string)progressive }\n\nvideo/x-raw(memory:GLMemory):\n         format: { NV12, YV12, I420, BGRA, RGBA, Y444, VUYA, P010_10LE, BGR10A2_LE, RGB10A2_LE, Y444_16LE }\n          width: [ 65, 8192 ]\n         height: [ 33, 8192 ]\n      framerate: [ 0/1, 2147483647/1 ]\n interlace-mode: { (string)progressive }\n",
+                        "caps": "video/x-raw:\n         format: { NV12, P010_10LE, P016_LE, Y444, Y444_16LE, Y444_16LE }\n          width: [ 144, 8192 ]\n         height: [ 144, 8192 ]\n      framerate: [ 0/1, 2147483647/1 ]\n\nvideo/x-raw(memory:GLMemory):\n         format: { NV12, P010_10LE, P016_LE, Y444, Y444_16LE, Y444_16LE }\n          width: [ 144, 8192 ]\n         height: [ 144, 8192 ]\n      framerate: [ 0/1, 2147483647/1 ]\n",
                         "direction": "sink",
                         "presence": "always"
                     },
                     "src": {
-                        "caps": "video/x-h265:\n          width: [ 65, 8192 ]\n         height: [ 33, 8192 ]\n      framerate: [ 0/1, 2147483647/1 ]\n  stream-format: byte-stream\n      alignment: au\n        profile: { (string)main, (string)main-10, (string)main-444 }\n",
+                        "caps": "video/x-h265:\n          width: [ 144, 8192 ]\n         height: [ 144, 8192 ]\n  stream-format: byte-stream\n      alignment: au\n        profile: { (string)main, (string)main-10, (string)main-12, (string)main-444, (string)main-444-10, (string)main-444-12 }\n",
                         "direction": "src",
                         "presence": "always"
                     }
@@ -208312,9 +208312,35 @@
                         "type": "gboolean",
                         "writable": true
                     },
+                    "b-adapt": {
+                        "blurb": "Enable adaptive B-frame insert when lookahead is enabled",
+                        "conditionally-available": true,
+                        "construct": false,
+                        "construct-only": false,
+                        "controllable": false,
+                        "default": "false",
+                        "mutable": "ready",
+                        "readable": true,
+                        "type": "gboolean",
+                        "writable": true
+                    },
+                    "bframes": {
+                        "blurb": "Number of B-frames between I and P",
+                        "conditionally-available": true,
+                        "construct": false,
+                        "construct-only": false,
+                        "controllable": false,
+                        "default": "0",
+                        "max": "5",
+                        "min": "0",
+                        "mutable": "ready",
+                        "readable": true,
+                        "type": "guint",
+                        "writable": true
+                    },
                     "rc-lookahead": {
-                        "blurb": "Number of frames for frame type lookahead (Exposed only if supported by device)",
-                        "conditionally-available": false,
+                        "blurb": "Number of frames for frame type lookahead",
+                        "conditionally-available": true,
                         "construct": false,
                         "construct-only": false,
                         "controllable": false,
@@ -208326,9 +208352,21 @@
                         "type": "guint",
                         "writable": true
                     },
+                    "temporal-aq": {
+                        "blurb": "Temporal Adaptive Quantization",
+                        "conditionally-available": true,
+                        "construct": false,
+                        "construct-only": false,
+                        "controllable": false,
+                        "default": "false",
+                        "mutable": "playing",
+                        "readable": true,
+                        "type": "gboolean",
+                        "writable": true
+                    },
                     "vbv-buffer-size": {
-                        "blurb": "VBV(HRD) Buffer Size in kbits (0 = NVENC default) (Exposed only if supported by device)",
-                        "conditionally-available": false,
+                        "blurb": "VBV(HRD) Buffer Size in kbits (0 = NVENC default)",
+                        "conditionally-available": true,
                         "construct": false,
                         "construct-only": false,
                         "controllable": false,
@@ -208341,8 +208379,8 @@
                         "writable": true
                     },
                     "weighted-pred": {
-                        "blurb": "Weighted Prediction (Exposed only if supported by device)",
-                        "conditionally-available": false,
+                        "blurb": "Weighted Prediction",
+                        "conditionally-available": true,
                         "construct": false,
                         "construct-only": false,
                         "controllable": false,
@@ -208355,6 +208393,35 @@
                 },
                 "rank": "primary + 256"
             },
+            "nvh265sldec": {
+                "author": "Seungha Yang <seungha@centricular.com>",
+                "description": "Nvidia H.265 video decoder",
+                "hierarchy": [
+                    "GstNvH265StatelessDec",
+                    "GstNvH265Dec",
+                    "GstH265Decoder",
+                    "GstVideoDecoder",
+                    "GstElement",
+                    "GstObject",
+                    "GInitiallyUnowned",
+                    "GObject"
+                ],
+                "klass": "Codec/Decoder/Video/Hardware",
+                "long-name": "NVDEC H.265 Stateless Decoder",
+                "pad-templates": {
+                    "sink": {
+                        "caps": "video/x-h265:\n  stream-format: { (string)hev1, (string)hvc1, (string)byte-stream }\n      alignment: au\n        profile: { (string)main, (string)main-10, (string)main-12, (string)main-444, (string)main-444-10, (string)main-444-12 }\n          width: [ 144, 8192 ]\n         height: [ 144, 8192 ]\n",
+                        "direction": "sink",
+                        "presence": "always"
+                    },
+                    "src": {
+                        "caps": "video/x-raw:\n          width: [ 144, 8192 ]\n         height: [ 144, 8192 ]\n      framerate: [ 0/1, 2147483647/1 ]\n         format: { NV12, P010_10LE, P016_LE, Y444, Y444_16LE, Y444_16LE }\n\nvideo/x-raw(memory:GLMemory):\n          width: [ 144, 8192 ]\n         height: [ 144, 8192 ]\n      framerate: [ 0/1, 2147483647/1 ]\n         format: { NV12, P010_10LE, P016_LE, Y444, Y444_16LE, Y444_16LE }\n",
+                        "direction": "src",
+                        "presence": "always"
+                    }
+                },
+                "rank": "secondary"
+            },
             "nvjpegdec": {
                 "author": "Ericsson AB, http://www.ericsson.com, Seungha Yang <seungha.yang@navercorp.com>",
                 "description": "NVDEC video decoder",
@@ -208467,6 +208534,34 @@
                 },
                 "rank": "primary"
             },
+            "nvvp8dec": {
+                "author": "Ericsson AB, http://www.ericsson.com, Seungha Yang <seungha.yang@navercorp.com>",
+                "description": "NVDEC video decoder",
+                "hierarchy": [
+                    "nvvp8dec",
+                    "GstNvDec",
+                    "GstVideoDecoder",
+                    "GstElement",
+                    "GstObject",
+                    "GInitiallyUnowned",
+                    "GObject"
+                ],
+                "klass": "Codec/Decoder/Video/Hardware",
+                "long-name": "NVDEC vp8 Video Decoder",
+                "pad-templates": {
+                    "sink": {
+                        "caps": "video/x-vp8:\n          width: [ 48, 4096 ]\n         height: [ 16, 4096 ]\n",
+                        "direction": "sink",
+                        "presence": "always"
+                    },
+                    "src": {
+                        "caps": "video/x-raw:\n          width: [ 48, 4096 ]\n         height: [ 16, 4096 ]\n      framerate: [ 0/1, 2147483647/1 ]\n         format: { NV12 }\n\nvideo/x-raw(memory:GLMemory):\n          width: [ 48, 4096 ]\n         height: [ 16, 4096 ]\n      framerate: [ 0/1, 2147483647/1 ]\n         format: { NV12 }\n",
+                        "direction": "src",
+                        "presence": "always"
+                    }
+                },
+                "rank": "primary"
+            },
             "nvvp9dec": {
                 "author": "Ericsson AB, http://www.ericsson.com, Seungha Yang <seungha.yang@navercorp.com>",
                 "description": "NVDEC video decoder",
@@ -208904,6 +208999,18 @@
                 ],
                 "kind": "object"
             },
+            "GstNvH265Dec": {
+                "hierarchy": [
+                    "GstNvH265Dec",
+                    "GstH265Decoder",
+                    "GstVideoDecoder",
+                    "GstElement",
+                    "GstObject",
+                    "GInitiallyUnowned",
+                    "GObject"
+                ],
+                "kind": "object"
+            },
             "GstNvPreset": {
                 "kind": "enum",
                 "values": [