This repository has been archived by the owner on Feb 11, 2021. It is now read-only.
/
SDL_version.h
167 lines (146 loc) · 4.94 KB
1
2
/*
SDL - Simple DirectMedia Layer
3
Copyright (C) 1997-2011 Sam Lantinga
4
5
This library is free software; you can redistribute it and/or
6
modify it under the terms of the GNU Lesser General Public
7
License as published by the Free Software Foundation; either
8
version 2.1 of the License, or (at your option) any later version.
9
10
11
12
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13
Lesser General Public License for more details.
14
15
16
17
You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
18
19
Sam Lantinga
20
slouken@libsdl.org
21
22
*/
23
/**
24
25
26
* \file SDL_version.h
*
* This header defines the current SDL version.
27
*/
28
29
30
31
#ifndef _SDL_version_h
#define _SDL_version_h
32
#include "SDL_stdinc.h"
33
34
35
36
#include "begin_code.h"
/* Set up for C function definitions, even when using C++ */
#ifdef __cplusplus
37
/* *INDENT-OFF* */
38
extern "C" {
39
/* *INDENT-ON* */
40
41
#endif
42
/**
43
44
45
* \brief Information the version of SDL in use.
*
* Represents the library's version as three levels: major revision
46
47
48
49
* (increments with massive changes, additions, and enhancements),
* minor revision (increments with backwards-compatible changes to the
* major revision), and patchlevel (increments with fixes to the minor
* revision).
50
51
52
*
* \sa SDL_VERSION
* \sa SDL_GetVersion
53
54
55
56
57
58
59
60
*/
typedef struct SDL_version
{
Uint8 major; /**< major version */
Uint8 minor; /**< minor version */
Uint8 patch; /**< update version */
} SDL_version;
61
62
63
/* Printable format: "%d.%d.%d", MAJOR, MINOR, PATCHLEVEL
*/
#define SDL_MAJOR_VERSION 1
64
65
66
67
#define SDL_MINOR_VERSION 3
#define SDL_PATCHLEVEL 0
/**
68
69
70
* \brief Macro to determine SDL version program was compiled against.
*
* This macro fills in a SDL_version structure with the version of the
71
72
73
* library you compiled against. This is determined by what header the
* compiler uses. Note that if you dynamically linked the library, you might
* have a slightly newer or older version at runtime. That version can be
74
* determined with SDL_GetVersion(), which, unlike SDL_VERSION(),
75
* is not a macro.
76
77
78
79
80
*
* \param x A pointer to a SDL_version struct to initialize.
*
* \sa SDL_version
* \sa SDL_GetVersion
81
*/
82
#define SDL_VERSION(x) \
83
{ \
84
85
86
(x)->major = SDL_MAJOR_VERSION; \
(x)->minor = SDL_MINOR_VERSION; \
(x)->patch = SDL_PATCHLEVEL; \
87
88
}
89
90
91
92
93
94
95
96
/**
* This macro turns the version numbers into a numeric value:
* \verbatim
(1,2,3) -> (1203)
\endverbatim
*
* This assumes that there will never be more than 100 patchlevels.
*/
97
#define SDL_VERSIONNUM(X, Y, Z) \
98
((X)*1000 + (Y)*100 + (Z))
99
100
101
102
/**
* This is the version number macro for the current SDL version.
*/
103
104
105
#define SDL_COMPILEDVERSION \
SDL_VERSIONNUM(SDL_MAJOR_VERSION, SDL_MINOR_VERSION, SDL_PATCHLEVEL)
106
107
108
/**
* This macro will evaluate to true if compiled with SDL at least X.Y.Z.
*/
109
110
111
#define SDL_VERSION_ATLEAST(X, Y, Z) \
(SDL_COMPILEDVERSION >= SDL_VERSIONNUM(X, Y, Z))
112
/**
113
* \brief Get the version of SDL that is linked against your program.
114
*
115
116
117
118
* If you are linking to SDL dynamically, then it is possible that the
* current version will be different than the version you compiled against.
* This function returns the current version, while SDL_VERSION() is a
* macro that tells you what version you compiled with.
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
*
* \code
* SDL_version compiled;
* SDL_version linked;
*
* SDL_VERSION(&compiled);
* SDL_GetVersion(&linked);
* printf("We compiled against SDL version %d.%d.%d ...\n",
* compiled.major, compiled.minor, compiled.patch);
* printf("But we linked against SDL version %d.%d.%d.\n",
* linked.major, linked.minor, linked.patch);
* \endcode
*
* This function may be called safely at any time, even before SDL_Init().
*
* \sa SDL_VERSION
135
*/
136
extern DECLSPEC void SDLCALL SDL_GetVersion(SDL_version * ver);
137
138
/**
139
* \brief Get the code revision of SDL that is linked against your program.
140
*
141
142
143
* Returns an arbitrary string (a hash value) uniquely identifying the
* exact revision of the SDL library in use, and is only useful in comparing
* against other revisions. It is NOT an incrementing number.
144
*/
145
extern DECLSPEC const char *SDLCALL SDL_GetRevision(void);
146
147
148
149
150
151
152
153
154
155
156
/**
* \brief Get the revision number of SDL that is linked against your program.
*
* Returns a number uniquely identifying the exact revision of the SDL
* library in use. It is an incrementing number based on commits to
* hg.libsdl.org.
*/
extern DECLSPEC int SDLCALL SDL_GetRevisionNumber(void);
157
158
/* Ends C function definitions when using C++ */
#ifdef __cplusplus
159
/* *INDENT-OFF* */
160
}
161
/* *INDENT-ON* */
162
163
164
165
#endif
#include "close_code.h"
#endif /* _SDL_version_h */
166
167
/* vi: set ts=4 sw=4 expandtab: */