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., 51 Franklin St, Fifth Floor,
  20  * Boston, MA 02110-1301, USA.
  21  */
  22
  23 #ifndef __GST_VERSION_H__
  24 #define __GST_VERSION_H__
  25
  26 /**
  27  * SECTION:gstversion
  28  * @short_description: GStreamer version macros.
  29  *
  30  * Use the GST_VERSION_* macros e.g. when defining own plugins. The GStreamer
  31  * runtime checks if these plugin and core version match and refuses to use a
  32  * plugin compiled against a different version of GStreamer.
  33  * You can also use the macros to keep the GStreamer version information in
  34  * your application.
  35  *
  36  * Use the gst_version() function if you want to know which version of
  37  * GStreamer you are currently linked against.
  38  *
  39  * The version macros get defined by including "gst/gst.h".
  40  */
  41
  42 G_BEGIN_DECLS
  43
  44 /**
  45  * GST_VERSION_MAJOR:
  46  *
  47  * The major version of GStreamer at compile time:
  48  */
  49 #define GST_VERSION_MAJOR (@GST_VERSION_MAJOR@)
  50 /**
  51  * GST_VERSION_MINOR:
  52  *
  53  * The minor version of GStreamer at compile time:
  54  */
  55 #define GST_VERSION_MINOR (@GST_VERSION_MINOR@)
  56 /**
  57  * GST_VERSION_MICRO:
  58  *
  59  * The micro version of GStreamer at compile time:
  60  */
  61 #define GST_VERSION_MICRO (@GST_VERSION_MICRO@)
  62 /**
  63  * GST_VERSION_NANO:
  64  *
  65  * The nano version of GStreamer at compile time:
  66  * Actual releases have 0, GIT versions have 1, prerelease versions have 2-...
  67  */
  68 #define GST_VERSION_NANO (@GST_VERSION_NANO@)
  69
  70 /**
  71  * GST_CHECK_VERSION:
  72  * @major: a number indicating the major version
  73  * @minor: a number indicating the minor version
  74  * @micro: a number indicating the micro version
  75  *
  76  * Check whether a GStreamer version equal to or greater than
  77  * major.minor.micro is present.
  78  */
  79 #define GST_CHECK_VERSION(major,minor,micro)    \
  80     (GST_VERSION_MAJOR > (major) || \
  81      (GST_VERSION_MAJOR == (major) && GST_VERSION_MINOR > (minor)) || \
  82      (GST_VERSION_MAJOR == (major) && GST_VERSION_MINOR == (minor) && \
  83       GST_VERSION_MICRO >= (micro)) || \
  84      (GST_VERSION_MAJOR == (major) && GST_VERSION_MINOR == (minor) && \
  85       GST_VERSION_MICRO + 1 == (micro) && GST_VERSION_NANO > 0))
  86
  87 G_END_DECLS
  88
  89 #endif /* __GST_VERSION_H__ */