more docs and two more inlined
[platform/upstream/gstreamer.git] / gst / gstversion.h.in
1 /* GStreamer
2  * Copyright (C) 1999,2000 Erik Walthinsen <omega@cse.ogi.edu>
3  *                    2000 Wim Taymans <wtay@chello.be>
4  *
5  * gstversion.h: Version information for GStreamer
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., 59 Temple Place - Suite 330,
20  * Boston, MA 02111-1307, USA.
21  */
22 /**
23  * SECTION:gstversion
24  * @short_description: GStreamer version macros.
25  *
26  * Use the GST_VERSION_* macros e.g. when defining own plugins. The GStreamer
27  * runtime checks if these plugin and core version match and refuses to use a
28  * plugin compiled against a different version of GStreamer.
29  * You can also use the macros to keep the GStreamer version information in your
30  * application.
31  *
32  * Use the gst_version() function if you want to know which version of 
33  * GStreamer you are currently linked against.
34  *
35  * The version macros get defined by including "gst/gst.h".
36  */
37
38 #ifndef __GST_VERSION_H__
39 #define __GST_VERSION_H__
40
41 G_BEGIN_DECLS
42
43 /**
44  * GST_VERSION_MAJOR:
45  *
46  * The major version of GStreamer at compile time:
47  */
48 #define GST_VERSION_MAJOR (@GST_VERSION_MAJOR@)
49 /**
50  * GST_VERSION_MINOR:
51  *
52  * The minor version of GStreamer at compile time:
53  */
54 #define GST_VERSION_MINOR (@GST_VERSION_MINOR@)
55 /**
56  * GST_VERSION_MICRO:
57  *
58  * The micro version of GStreamer at compile time:
59  */
60 #define GST_VERSION_MICRO (@GST_VERSION_MICRO@)
61
62 void    gst_version     (guint *major, guint *minor, guint *micro);
63
64 G_END_DECLS
65
66 #endif /* __GST_VERSION_H__ */