tag: Adds GST_TAG_CAPTURE_FLASH_FIRED/_MODE

Adds a new tag for informing if flash was used while
capturing an image and the flash mode selected by the
user during this capture

API: GST_TAG_CAPTURING_FLASH_FIRED
API: GST_TAG_CAPTURING_FLASH_MODE

https://bugzilla.gnome.org/show_bug.cgi?id=626651

diff --git a/docs/libs/gst-plugins-base-libs-sections.txt b/docs/libs/gst-plugins-base-libs-sections.txt
index 5670f2a..d3c1d66 100644 (file)
--- a/docs/libs/gst-plugins-base-libs-sections.txt
+++ b/docs/libs/gst-plugins-base-libs-sections.txt
@@ -1646,6 +1646,8 @@ GST_TAG_CAPTURING_GAIN_ADJUSTMENT
 GST_TAG_CAPTURING_WHITE_BALANCE
 GST_TAG_CAPTURING_CONTRAST
 GST_TAG_CAPTURING_SATURATION
+GST_TAG_CAPTURING_FLASH_FIRED
+GST_TAG_CAPTURING_FLASH_MODE
 gst_tag_register_musicbrainz_tags
 gst_tag_freeform_string_to_utf8
 gst_tag_parse_extended_comment

diff --git a/gst-libs/gst/tag/tag.h b/gst-libs/gst/tag/tag.h
index 08a024a..17fac20 100644 (file)
--- a/gst-libs/gst/tag/tag.h
+++ b/gst-libs/gst/tag/tag.h
@@ -280,6 +280,31 @@ G_BEGIN_DECLS
  */
 #define GST_TAG_CAPTURING_SATURATION          "capturing-saturation"
 
+/**
+ * GST_TAG_CAPTURING_FLASH_FIRED:
+ *
+ * If flash was fired during the capture of an image. (boolean)
+ *
+ * Note that if this tag isn't present, it should not be assumed that
+ * the flash did not fire. It should be treated as unknown.
+ *
+ * Since: 0.10.31
+ */
+#define GST_TAG_CAPTURING_FLASH_FIRED         "capturing-flash-fired"
+
+/**
+ * GST_TAG_CAPTURING_FLASH_MODE:
+ *
+ * The flash mode selected during the capture of an image. (string)
+ *
+ * The allowed values are:
+ *  "auto"
+ *  "always"
+ *  "never"
+ *
+ * Since: 0.10.31
+ */
+#define GST_TAG_CAPTURING_FLASH_MODE         "capturing-flash-mode"
 
 /* additional information for image tags */
 

diff --git a/gst-libs/gst/tag/tags.c b/gst-libs/gst/tag/tags.c
index 6b1a23d..6b4c7da 100644 (file)
--- a/gst-libs/gst/tag/tags.c
+++ b/gst-libs/gst/tag/tags.c
@@ -136,6 +136,14 @@ gst_tag_register_tags_internal (gpointer unused)
       _("The direction of saturation processing applied when "
           "capturing an image"), NULL);
 
+  gst_tag_register (GST_TAG_CAPTURING_FLASH_FIRED, GST_TAG_FLAG_META,
+      G_TYPE_BOOLEAN, _("capturing flash fired"),
+      _("If the flash fired while capturing and image"), NULL);
+
+  gst_tag_register (GST_TAG_CAPTURING_FLASH_MODE, GST_TAG_FLAG_META,
+      G_TYPE_STRING, _("capturing flash mode"),
+      _("The selected flash mode while capturing and image"), NULL);
+
   return NULL;
 }