From 5c974980ef8e59ac46d2ce563598dae172b55a7f Mon Sep 17 00:00:00 2001
From: Seungha Yang <seungha@centricular.com>
Date: Thu, 20 Feb 2025 22:20:48 +0900
Subject: [PATCH] closedcaption: Add h264/h265 ccinserter docs

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

diff --git a/subprojects/gst-plugins-bad/docs/plugins/gst_plugins_cache.json b/subprojects/gst-plugins-bad/docs/plugins/gst_plugins_cache.json
index 81b646a63e..96be362a33 100644
--- a/subprojects/gst-plugins-bad/docs/plugins/gst_plugins_cache.json
+++ b/subprojects/gst-plugins-bad/docs/plugins/gst_plugins_cache.json
@@ -8942,6 +8942,32 @@
                 },
                 "rank": "none"
             },
+            "h264ccinserter": {
+                "author": "Seungha Yang <seungha@centricular.com>",
+                "description": "Insert closed caption data to H.264 streams",
+                "hierarchy": [
+                    "GstH264CCInserter",
+                    "GstCodecCCInserter",
+                    "GstElement",
+                    "GstObject",
+                    "GInitiallyUnowned",
+                    "GObject"
+                ],
+                "klass": "Codec/Video/Filter",
+                "pad-templates": {
+                    "sink": {
+                        "caps": "video/x-h264:\n      alignment: au\n",
+                        "direction": "sink",
+                        "presence": "always"
+                    },
+                    "src": {
+                        "caps": "video/x-h264:\n      alignment: au\n",
+                        "direction": "src",
+                        "presence": "always"
+                    }
+                },
+                "rank": "none"
+            },
             "h265ccextractor": {
                 "author": "Seungha Yang <seungha@centricular.com>",
                 "description": "Extract GstVideoCaptionMeta from input H.265 stream",
@@ -8969,6 +8995,32 @@
                 },
                 "rank": "none"
             },
+            "h265ccinserter": {
+                "author": "Seungha Yang <seungha@centricular.com>",
+                "description": "Insert closed caption data to H.265 streams",
+                "hierarchy": [
+                    "GstH265CCInserter",
+                    "GstCodecCCInserter",
+                    "GstElement",
+                    "GstObject",
+                    "GInitiallyUnowned",
+                    "GObject"
+                ],
+                "klass": "Codec/Video/Filter",
+                "pad-templates": {
+                    "sink": {
+                        "caps": "video/x-h265:\n      alignment: au\n",
+                        "direction": "sink",
+                        "presence": "always"
+                    },
+                    "src": {
+                        "caps": "video/x-h265:\n      alignment: au\n",
+                        "direction": "src",
+                        "presence": "always"
+                    }
+                },
+                "rank": "none"
+            },
             "line21decoder": {
                 "author": "Edward Hervey <edward@centricular.com>",
                 "description": "Extract line21 CC from SD video streams",
@@ -9154,6 +9206,57 @@
                     }
                 ]
             },
+            "GstCodecCCInsertMetaOrder": {
+                "kind": "enum",
+                "values": [
+                    {
+                        "desc": "Decode",
+                        "name": "decode",
+                        "value": "0"
+                    },
+                    {
+                        "desc": "Display",
+                        "name": "display",
+                        "value": "1"
+                    }
+                ]
+            },
+            "GstCodecCCInserter": {
+                "hierarchy": [
+                    "GstCodecCCInserter",
+                    "GstElement",
+                    "GstObject",
+                    "GInitiallyUnowned",
+                    "GObject"
+                ],
+                "kind": "object",
+                "properties": {
+                    "caption-meta-order": {
+                        "blurb": "Order of caption metas attached on buffers. In case of \"display\" order, inserter will reorder captions to decoding order",
+                        "conditionally-available": false,
+                        "construct": false,
+                        "construct-only": false,
+                        "controllable": false,
+                        "default": "decode (0)",
+                        "mutable": "ready",
+                        "readable": true,
+                        "type": "GstCodecCCInsertMetaOrder",
+                        "writable": true
+                    },
+                    "remove-caption-meta": {
+                        "blurb": "Remove caption meta from outgoing video buffers",
+                        "conditionally-available": false,
+                        "construct": false,
+                        "construct-only": false,
+                        "controllable": false,
+                        "default": "false",
+                        "mutable": "null",
+                        "readable": true,
+                        "type": "gboolean",
+                        "writable": true
+                    }
+                }
+            },
             "GstLine21DecoderMode": {
                 "kind": "enum",
                 "values": [