New API: add GST_MESSAGE_TYPE_NAME and GST_QUERY_TYPE_NAME macros (#330906). Also...

Original commit message from CVS:
* docs/gst/gstreamer-sections.txt:
* gst/gstmessage.h:
* gst/gstquery.h:
New API: add GST_MESSAGE_TYPE_NAME and GST_QUERY_TYPE_NAME
macros (#330906). Also, document the already existing
GST_QUERY_TYPE macro.

diff --git a/ChangeLog b/ChangeLog
index 664b500..ca73628 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,12 @@
+2006-02-13  Tim-Philipp Müller  <tim at centricular dot net>
+
+       * docs/gst/gstreamer-sections.txt:
+       * gst/gstmessage.h:
+       * gst/gstquery.h:
+         New API: add GST_MESSAGE_TYPE_NAME and GST_QUERY_TYPE_NAME
+         macros (#330906). Also, document the already existing
+         GST_QUERY_TYPE macro.
+
 2006-02-13  Wim Taymans  <wim@fluendo.com>
 
        * tests/check/gst/gstutils.c: (data_probe), (buffer_probe),

diff --git a/docs/gst/gstreamer-sections.txt b/docs/gst/gstreamer-sections.txt
index b423205..393d821 100644 (file)
--- a/docs/gst/gstreamer-sections.txt
+++ b/docs/gst/gstreamer-sections.txt
@@ -940,6 +940,7 @@ GstMessageType
 GST_MESSAGE_SRC
 GST_MESSAGE_TIMESTAMP
 GST_MESSAGE_TYPE
+GST_MESSAGE_TYPE_NAME
 GST_MESSAGE_TRACE_NAME
 gst_message_type_to_quark
 gst_message_type_get_name
@@ -1507,6 +1508,8 @@ gst_rank_get_type
 <TITLE>GstQuery</TITLE>
 GstQuery
 GstQueryType
+GST_QUERY_TYPE
+GST_QUERY_TYPE_NAME
 GST_QUERY_TYPE_RATE_DEN
 GstQueryTypeDefinition
 

diff --git a/gst/gstmessage.h b/gst/gstmessage.h
index 6603f0c..4e633ef 100644 (file)
--- a/gst/gstmessage.h
+++ b/gst/gstmessage.h
@@ -124,6 +124,15 @@ typedef enum
  */
 #define GST_MESSAGE_TYPE(message)      (GST_MESSAGE(message)->type)
 /**
+ * GST_MESSAGE_TYPE_NAME:
+ * @message: a #GstMessage
+ *
+ * Get a constant string representation of the #GstMessageType of @message.
+ *
+ * Since: 0.10.4
+ */
+#define GST_MESSAGE_TYPE_NAME(message) gst_message_type_get_name(GST_MESSAGE_TYPE(message))
+/**
  * GST_MESSAGE_TIMESTAMP:
  * @message: a #GstMessage
  *

diff --git a/gst/gstquery.h b/gst/gstquery.h
index 6accc2e..fc7e316 100644 (file)
--- a/gst/gstquery.h
+++ b/gst/gstquery.h
@@ -99,9 +99,26 @@ struct _GstQueryTypeDefinition
 #define GST_QUERY(obj)                         (G_TYPE_CHECK_INSTANCE_CAST ((obj), GST_TYPE_QUERY, GstQuery))
 #define GST_QUERY_CLASS(klass)                 (G_TYPE_CHECK_CLASS_CAST ((klass), GST_TYPE_QUERY, GstQueryClass))
 
+/**
+ * GST_QUERY_TYPE:
+ * @query: the query to query
+ *
+ * Get the #GstQueryType of the query.
+ */
 #define GST_QUERY_TYPE(query)  (((GstQuery*)(query))->type)
 
 /**
+ * GST_QUERY_TYPE_NAME:
+ * @query: the query to query
+ *
+ * Get a constant string representation of the #GstQueryType of the query.
+ *
+ * Since: 0.10.4
+ */
+#define GST_QUERY_TYPE_NAME(query) (gst_query_type_get_name(GST_QUERY_TYPE(query)))
+
+
+/**
  * GstQuery:
  * @mini_object: The parent #GstMiniObject type
  * @type: the #GstQueryType