va: Add since markers

Part-of: <https://gitlab.freedesktop.org/gstreamer/gstreamer/-/merge_requests/8774>

subprojects/gst-plugins-bad/sys/va/gstvacodecalphadecodebin.h

@@ -36,6 +36,15 @@
 
 G_BEGIN_DECLS
 
+/**
+ * GstVaCodecAlphaDecodeBin:
+ *
+ * Base class for VA-API based decoder for alpha formats which come
+ * as a separate stream, typically found in VP8 and VP9.
+ *
+ * Since: 1.24
+ */
+
 #define GST_TYPE_VA_CODEC_ALPHA_DECODE_BIN (gst_va_codec_alpha_decode_bin_get_type())
 G_DECLARE_DERIVABLE_TYPE (GstVaCodecAlphaDecodeBin,
     gst_va_codec_alpha_decode_bin, GST, VA_CODEC_ALPHA_DECODE_BIN, GstBin);

subprojects/gst-plugins-bad/sys/va/gstvafilter.c

@@ -585,6 +585,11 @@ static const struct _CBDesc {
   [VAProcColorBalanceAutoBrightness] =
       { "auto-brightness", "Auto-Brightness", "Enable auto brightness",
         GST_VA_FILTER_PROP_AUTO_BRIGHTNESS    },
+  /**
+   * GstVaPostProc:auto-contrast:
+   *
+   * Since: 1.20
+   */
   [VAProcColorBalanceAutoContrast] =
       { "auto-contrast", "Auto-Contrast", "Enable auto contrast",
         GST_VA_FILTER_PROP_AUTO_CONTRAST },
@@ -692,6 +697,13 @@ gst_va_filter_install_properties (GstVaFilter * self, GObjectClass * klass)
 
   if (self->pipeline_caps.mirror_flags != VA_MIRROR_NONE
       || self->pipeline_caps.rotation_flags != VA_ROTATION_NONE) {
+    /**
+     * GstVaPostProc:video-direction:
+     *
+     * Video direction: rotation and flipping
+     *
+     * Since: 1.20
+     */
     g_object_class_install_property (klass, GST_VA_FILTER_PROP_VIDEO_DIR,
         g_param_spec_enum ("video-direction", "Video Direction",
             "Video direction: rotation and flipping",

subprojects/gst-plugins-bad/sys/va/gstvavpp.c

@@ -2301,14 +2301,29 @@ gst_va_vpp_init (GTypeInstance * instance, gpointer g_class)
   self->prev_direction = self->direction;
   self->tag_direction = GST_VIDEO_ORIENTATION_AUTO;
 
+  /**
+   * GstVaPostProc:denoise:
+   *
+   * Since: 1.20
+   */
   pspec = g_object_class_find_property (g_class, "denoise");
   if (pspec)
     self->denoise = g_value_get_float (g_param_spec_get_default_value (pspec));
 
+  /**
+   * GstVaPostProc:sharpen:
+   *
+   * Since: 1.20
+   */
   pspec = g_object_class_find_property (g_class, "sharpen");
   if (pspec)
     self->sharpen = g_value_get_float (g_param_spec_get_default_value (pspec));
 
+  /**
+   * GstVaPostProc:skin-tone:
+   *
+   * Since: 1.20
+   */
   pspec = g_object_class_find_property (g_class, "skin-tone");
   if (pspec) {
     const GValue *value = g_param_spec_get_default_value (pspec);
@@ -2319,22 +2334,44 @@ gst_va_vpp_init (GTypeInstance * instance, gpointer g_class)
   }
 
   /* color balance */
+                                        /**
+   * GstVaPostProc:brightness:
+   *
+   * Since: 1.20
+   */
   pspec = g_object_class_find_property (g_class, "brightness");
   if (pspec) {
     self->brightness =
         g_value_get_float (g_param_spec_get_default_value (pspec));
     _create_colorbalance_channel (self, "BRIGHTNESS");
   }
+  /**
+   * GstVaPostProc:contrast:
+   *
+   * Since: 1.20
+   */
   pspec = g_object_class_find_property (g_class, "contrast");
   if (pspec) {
     self->contrast = g_value_get_float (g_param_spec_get_default_value (pspec));
     _create_colorbalance_channel (self, "CONTRAST");
   }
+  /**
+   * GstVaPostProc:hue:
+   *
+   * Since: 1.20
+   */
   pspec = g_object_class_find_property (g_class, "hue");
   if (pspec) {
     self->hue = g_value_get_float (g_param_spec_get_default_value (pspec));
     _create_colorbalance_channel (self, "HUE");
   }
+  /**
+   * GstVaPostProc:saturation:
+   *
+   * Color saturation value
+   *
+   * Since: 1.20
+   */
   pspec = g_object_class_find_property (g_class, "saturation");
   if (pspec) {
     self->saturation =
@@ -2342,7 +2379,13 @@ gst_va_vpp_init (GTypeInstance * instance, gpointer g_class)
     _create_colorbalance_channel (self, "SATURATION");
   }
 
-  /* HDR tone mapping */
+                                        /**
+   * GstVaPostProc:hdr-tone-mapping:
+   *
+   * HDR tone mapping
+   *
+   * Since: 1.22
+   */
   pspec = g_object_class_find_property (g_class, "hdr-tone-mapping");
   if (pspec) {
     self->hdr_mapping =

subprojects/gst-plugins-bad/sys/va/meson.build

@@ -61,6 +61,7 @@ va_headers = [
   'gstvavp9enc.h',
   'gstvavpp.h',
   'vacompat.h',
+  'gstvacodecalphadecodebin.h'
 ]
 
 va_linux_sources = [