caps: gst_caps_is_any() should return TRUE or FALSE
[platform/upstream/gstreamer.git] / gst / gstcompat.h
1 /* GStreamer
2  * Copyright (C) 1999,2000 Erik Walthinsen <omega@cse.ogi.edu>
3  *                    2004 Wim Taymans <wim@fluendo.com>
4  *
5  * gstcompat.h: backwards compatibility stuff
6  *
7  * This library is free software; you can redistribute it and/or
8  * modify it under the terms of the GNU Library General Public
9  * License as published by the Free Software Foundation; either
10  * version 2 of the License, or (at your option) any later version.
11  *
12  * This library is distributed in the hope that it will be useful,
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
15  * Library General Public License for more details.
16  *
17  * You should have received a copy of the GNU Library General Public
18  * License along with this library; if not, write to the
19  * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
20  * Boston, MA 02110-1301, USA.
21  */
22
23 /* API compatibility stuff */
24 #ifndef __GSTCOMPAT_H__
25 #define __GSTCOMPAT_H__
26 /**
27  * SECTION:gstcompat
28  * @short_description: Deprecated API entries
29  *
30  * Please do not use these in new code.
31  * These symbols are only available by defining GST_DISABLE_DEPRECATED.
32  * This can be done in CFLAGS for compiling old code.
33  */
34
35
36 G_BEGIN_DECLS
37
38 #define gst_buffer_new_and_alloc(s)            gst_buffer_new_allocate(NULL, s, NULL)
39
40 #define GST_BUFFER_TIMESTAMP          GST_BUFFER_PTS
41 #define GST_BUFFER_TIMESTAMP_IS_VALID GST_BUFFER_PTS_IS_VALID
42
43 static inline gboolean
44 gst_pad_set_caps (GstPad * pad, GstCaps * caps)
45 {
46   GstEvent *event;
47   gboolean res = TRUE;
48
49   g_return_val_if_fail (GST_IS_PAD (pad), FALSE);
50   g_return_val_if_fail (caps != NULL && gst_caps_is_fixed (caps), FALSE);
51
52   event = gst_event_new_caps (caps);
53
54   if (GST_PAD_IS_SRC (pad))
55     res = gst_pad_push_event (pad, event);
56   else
57     res = gst_pad_send_event (pad, event);
58
59   return res;
60 }
61
62
63 #ifndef GST_DISABLE_DEPRECATED
64
65 /* added to ease the transition to 0.11 */
66 #define gst_element_class_set_details_simple  gst_element_class_set_metadata
67
68 #define gst_element_factory_get_longname(f)    gst_element_factory_get_metadata(f, GST_ELEMENT_METADATA_LONGNAME)
69 #define gst_element_factory_get_klass(f)       gst_element_factory_get_metadata(f, GST_ELEMENT_METADATA_KLASS)
70 #define gst_element_factory_get_description(f) gst_element_factory_get_metadata(f, GST_ELEMENT_METADATA_DESCRIPTION)
71 #define gst_element_factory_get_author(f)      gst_element_factory_get_metadata(f, GST_ELEMENT_METADATA_AUTHOR)
72 #define gst_element_factory_get_documentation_uri(f)  gst_element_factory_get_metadata(f, GST_ELEMENT_METADATA_DOC_URI)
73 #define gst_element_factory_get_icon_name(f)   gst_element_factory_get_metadata(f, GST_ELEMENT_METADATA_ICON_NAME)
74
75 #define gst_pad_get_caps_reffed(p)             gst_pad_get_caps(p)
76 #define gst_pad_peer_get_caps_reffed(p)        gst_pad_peer_get_caps(p)
77
78 #define gst_adapter_prev_timestamp    gst_adapter_prev_pts
79
80 #define gst_tag_list_free(taglist)    gst_tag_list_unref(taglist)
81
82 #define GST_MESSAGE_DURATION GST_MESSAGE_DURATION_CHANGED
83 #define gst_message_new_duration(src,fmt,dur) \
84     gst_message_new_duration_changed(src)
85 #define gst_message_parse_duration(msg,fmt,dur) \
86 G_STMT_START { \
87   GstFormat *p_fmt = fmt; \
88   gint64 *p_dur = dur; \
89   if (p_fmt) \
90     *p_fmt = GST_FORMAT_TIME; \
91   if (p_dur) \
92     *p_dur = GST_CLOCK_TIME_NONE; \
93 } G_STMT_END
94
95 #endif /* not GST_DISABLE_DEPRECATED */
96
97 G_END_DECLS
98
99 #endif /* __GSTCOMPAT_H__ */