]> git.saurik.com Git - wxWidgets.git/blob - include/wx/platform.h
added and documented wx_const/static_cast<>
[wxWidgets.git] / include / wx / platform.h
1 /**
2 * Name: wx/platform.h
3 * Purpose: define the OS and compiler identification macros
4 * Author: Vadim Zeitlin
5 * Modified by:
6 * Created: 29.10.01 (extracted from wx/defs.h)
7 * RCS-ID: $Id$
8 * Copyright: (c) 1997-2001 wxWindows team
9 * Licence: wxWindows licence
10 */
11
12 /* THIS IS A C FILE, DON'T USE C++ FEATURES (IN PARTICULAR COMMENTS) IN IT */
13
14 #ifndef _WX_PLATFORM_H_
15 #define _WX_PLATFORM_H_
16
17
18 /*
19 Codewarrior doesn't define any Windows symbols until some headers
20 are included
21 */
22 #if __MWERKS__
23 # include <stddef.h>
24 #endif
25
26 /*
27 WXMAC variants
28 __WXMAC_CLASSIC__ means ppc non-carbon builds, __WXMAC_CARBON__ means
29 carbon API available (mach or cfm builds) , __WXMAC_OSX__ means mach-o
30 builds, running under 10.2 + only
31 */
32 #ifdef __WXMAC__
33 #if defined(__MACH__)
34 #define __WXMAC_OSX__ 1
35 #define __WXMAC_CARBON__ 1
36 #define __WXMAC_CLASSIC__ 0
37 #else
38 #define __WXMAC_OSX__ 0
39 #if TARGET_CARBON
40 #define __WXMAC_CARBON__ 1
41 #define __WXMAC_CLASSIC__ 0
42 #else
43 #define __WXMAC_CARBON__ 0
44 #define __WXMAC_CLASSIC__ 1
45 #endif
46 #endif
47 #endif
48
49 /*
50 first define Windows symbols if they're not defined on the command line: we
51 can autodetect everything we need if _WIN32 is defined
52 */
53 #if defined(__CYGWIN32__) && !defined(__WXMOTIF__) && !defined(__WXGTK__) \
54 && !defined(__WXX11__)
55 /* for Cygwin, default to wxMSW unless otherwise specified */
56 # ifndef __WXMSW__
57 # define __WXMSW__
58 # endif
59
60 # ifndef _WIN32
61 # define _WIN32
62 # endif
63
64 # ifndef WIN32
65 # define WIN32
66 # endif
67 #endif
68
69 #if defined(_WIN64)
70 # ifndef _WIN32
71 /*
72 a lot of code (mistakenly) uses #ifdef _WIN32 to either test for
73 Windows or to test for !__WIN16__, so we must define _WIN32 for
74 Win64 as well to ensure that the existing code continues to work.
75 */
76 # define _WIN32
77 # endif /* !_WIN32 */
78
79 # ifndef __WIN64__
80 # define __WIN64__
81 # endif /* !__WIN64__ */
82 #endif /* _WIN64 */
83
84 #if defined(_WIN32) || defined(WIN32) || defined(__NT__) || defined(__WXWINCE__)
85 # ifndef __WXMSW__
86 # define __WXMSW__
87 # endif
88
89 # ifndef __WIN32__
90 # define __WIN32__
91 # endif
92
93 /*
94 see MSDN for the description of possible WINVER values, this one is a
95 good default and, anyhow, we check for most of the features we use
96 during run-time.
97 */
98 # ifndef WINVER
99 # define WINVER 0x0400
100 # endif
101
102 /* Win95 means Win95-style UI, i.e. Win9x/NT 4+ */
103 # if !defined(__WIN95__) && (WINVER >= 0x0400)
104 # define __WIN95__
105 # endif
106 #endif /* Win32 */
107
108 #if defined(__WXMSW__) || defined(__WIN32__)
109 # if !defined(__WINDOWS__)
110 # define __WINDOWS__
111 # endif
112 #endif
113
114 #ifdef __WINE__
115 # ifndef __WIN95__
116 # define __WIN95__
117 # endif
118 #endif /* WINE */
119
120 /*
121 Include wx/setup.h for the Unix platform defines generated by configure and
122 the library compilation options
123 */
124 #include "wx/setup.h"
125
126 /* check the consistency of the settings in setup.h */
127 #include "wx/chkconf.h"
128
129 /*
130 adjust the Unicode setting: wxUSE_UNICODE should be defined as 0 or 1
131 and is used by wxWindows, _UNICODE and/or UNICODE may be defined or used by
132 the system headers so bring these settings in sync
133 */
134
135 /* set wxUSE_UNICODE to 1 if UNICODE or _UNICODE is defined */
136 #if defined(_UNICODE) || defined(UNICODE)
137 # undef wxUSE_UNICODE
138 # define wxUSE_UNICODE 1
139 #else /* !UNICODE */
140 # ifndef wxUSE_UNICODE
141 # define wxUSE_UNICODE 0
142 # endif
143 #endif /* UNICODE/!UNICODE */
144
145 /* and vice versa: define UNICODE and _UNICODE if wxUSE_UNICODE is 1 */
146 #if wxUSE_UNICODE
147 # ifndef _UNICODE
148 # define _UNICODE
149 # endif
150 # ifndef UNICODE
151 # define UNICODE
152 # endif
153 #endif /* wxUSE_UNICODE */
154
155 #if defined( __MWERKS__ ) && !defined(__INTEL__)
156 // otherwise MSL headers bring in WIN32 dependant APIs
157 #undef UNICODE
158 #endif
159 /*
160 some compilers don't support iostream.h any longer, while some of theme
161 are not updated with <iostream> yet, so override the users setting here
162 in such case.
163 */
164 #if defined(_MSC_VER) && (_MSC_VER >= 1310)
165 # undef wxUSE_IOSTREAMH
166 # define wxUSE_IOSTREAMH 0
167 #elif defined(__DMC__) || defined(__WATCOMC__)
168 # undef wxUSE_IOSTREAMH
169 # define wxUSE_IOSTREAMH 1
170 #endif /* compilers not supporting iostream.h */
171
172 /*
173 old C++ headers (like <iostream.h>) declare classes in the global namespace
174 while the new, standard ones (like <iostream>) do it in std:: namespace
175
176 using this macro allows constuctions like "wxSTD iostream" to work in
177 either case
178 */
179 #if !wxUSE_IOSTREAMH
180 # define wxSTD std::
181 #else
182 # define wxSTD
183 #endif
184
185 /*
186 OS: first of all, test for MS-DOS platform. We must do this before testing
187 for Unix, because DJGPP compiler defines __unix__ under MS-DOS
188 */
189 #if defined(__GO32__) || defined(__DJGPP__) || defined(__DOS__)
190 # ifndef __DOS__
191 # define __DOS__
192 # endif
193 /* size_t is the same as unsigned int for Watcom 11 compiler, */
194 /* so define it if it hadn't been done by configure yet */
195 # if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG)
196 # ifdef __WATCOMC__
197 # define wxSIZE_T_IS_UINT
198 # endif
199 # ifdef __DJGPP__
200 # define wxSIZE_T_IS_ULONG
201 # endif
202 # endif
203
204 /*
205 OS: then test for generic Unix defines, then for particular flavours and
206 finally for Unix-like systems
207 */
208 #elif defined(__UNIX__) || defined(__unix) || defined(__unix__) || \
209 defined(____SVR4____) || defined(__LINUX__) || defined(__sgi) || \
210 defined(__hpux) || defined(sun) || defined(__SUN__) || defined(_AIX) || \
211 defined(__EMX__) || defined(__VMS) || defined(__BEOS__)
212
213 # define __UNIX_LIKE__
214
215 /* Helps SGI compilation, apparently */
216 # ifdef __SGI__
217 # ifdef __GNUG__
218 # define __need_wchar_t
219 # else /* !gcc */
220 /*
221 Note I use the term __SGI_CC__ for both cc and CC, its not a good
222 idea to mix gcc and cc/CC, the name mangling is different
223 */
224 # define __SGI_CC__
225 # endif /* gcc/!gcc */
226 # endif /* SGI */
227
228 # if defined(sun) || defined(__SUN__)
229 # ifndef __GNUG__
230 # ifndef __SUNCC__
231 # define __SUNCC__
232 # endif /* Sun CC */
233 # endif
234 # endif /* Sun */
235
236 # ifdef __EMX__
237 # define OS2EMX_PLAIN_CHAR
238 # endif
239
240 /* define __HPUX__ for HP-UX where standard macro is __hpux */
241 # if defined(__hpux) && !defined(__HPUX__)
242 # define __HPUX__
243 # endif /* HP-UX */
244
245 # if defined(__CYGWIN__) || defined(__WINE__)
246 # if !defined(wxSIZE_T_IS_UINT)
247 # define wxSIZE_T_IS_UINT
248 # endif
249 # endif
250 #elif defined(applec) || \
251 defined(THINK_C) || \
252 (defined(__MWERKS__) && !defined(__INTEL__))
253 /* MacOS */
254 # if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG)
255 # define wxSIZE_T_IS_ULONG
256 # endif
257 #elif defined(__WXMAC__) && defined(__APPLE__)
258 /* Mac OS X */
259 # define __UNIX_LIKE__
260
261 /*
262 These defines are needed when compiling using Project Builder
263 with a non generated setup0.h
264 */
265 # ifndef __UNIX__
266 # define __UNIX__ 1
267 # endif
268 # ifndef __BSD__
269 # define __BSD__ 1
270 # endif
271 # ifndef __DARWIN__
272 # define __DARWIN__ 1
273 # endif
274 # ifndef __POWERPC__
275 # define __POWERPC__ 1
276 # endif
277 # ifndef TARGET_CARBON
278 # define TARGET_CARBON 1
279 # endif
280
281 # if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG)
282 # define wxSIZE_T_IS_ULONG
283 # endif
284 /*
285 Some code has been added to workaround defects(?) in the
286 bundled gcc compiler. These corrections are identified by
287 __DARWIN__ for Darwin related corrections (wxMac, wxMotif)
288 */
289 #elif defined(__OS2__)
290 # if defined(__IBMCPP__)
291 # define __VISAGEAVER__ __IBMCPP__
292 # endif
293 # ifndef __WXOS2__
294 # define __WXOS2__
295 # endif
296 # ifndef __WXPM__
297 # define __WXPM__
298 # endif
299
300 /* Place other OS/2 compiler environment defines here */
301 # if defined(__VISAGECPP__)
302 /* VisualAge is the only thing that understands _Optlink */
303 # define LINKAGEMODE _Optlink
304 # endif
305 # define wxSIZE_T_IS_UINT
306
307 #else /* Windows */
308 # ifndef __WINDOWS__
309 # define __WINDOWS__
310 # endif /* Windows */
311
312 /* to be changed for Win64! */
313 # ifndef __WIN32__
314 # error "__WIN32__ should be defined for Win32 and Win64, Win16 is not supported"
315 # endif
316
317 /*
318 define another standard symbol for Microsoft Visual C++: the standard
319 one (_MSC_VER) is also defined by Metrowerks compiler
320 */
321 # if defined(_MSC_VER) && !defined(__MWERKS__)
322 # define __VISUALC__ _MSC_VER
323 # elif defined(__BCPLUSPLUS__) && !defined(__BORLANDC__)
324 # define __BORLANDC__
325 # elif defined(__WATCOMC__)
326 # elif defined(__SC__)
327 # define __SYMANTECC__
328 # endif /* compiler */
329
330 /* size_t is the same as unsigned int for all Windows compilers we know, */
331 /* so define it if it hadn't been done by configure yet */
332 # if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG)
333 # define wxSIZE_T_IS_UINT
334 # endif
335 #endif /* OS */
336
337 /*
338 if we're on a Unix system but didn't use configure (so that setup.h didn't
339 define __UNIX__), do define __UNIX__ now
340 */
341 #if !defined(__UNIX__) && defined(__UNIX_LIKE__)
342 # define __UNIX__
343 #endif /* Unix */
344
345 #if defined(__HPUX__) && !defined(__WXGTK__)
346 # ifndef __WXMOTIF__
347 # define __WXMOTIF__
348 # endif /* __WXMOTIF__ */
349 #endif
350
351 #if defined(__WXMOTIF__) || defined(__WXX11__)
352 # define __X__
353 #endif
354
355 #ifdef __SC__
356 # ifdef __DMC__
357 # define __DIGITALMARS__
358 # else
359 # define __SYMANTEC__
360 # endif
361 #endif
362
363 /* Force linking against required libraries under Windows CE: */
364 #ifdef __WXWINCE__
365 # include "wx/msw/wince/libraries.h"
366 #endif
367
368 /*
369 This macro can be used to test the gcc version and can be used like this:
370
371 # if wxCHECK_GCC_VERSION(3, 1)
372 ... we have gcc 3.1 or later ...
373 # else
374 ... no gcc at all or gcc < 3.1 ...
375 # endif
376 */
377 #define wxCHECK_GCC_VERSION( major, minor ) \
378 ( defined(__GNUC__) && defined(__GNUC_MINOR__) \
379 && ( ( __GNUC__ > (major) ) \
380 || ( __GNUC__ == (major) && __GNUC_MINOR__ >= (minor) ) ) )
381
382 /*
383 This macro can be used to check that the version of mingw32 compiler is
384 at least maj.min
385 */
386 #if ( defined( __GNUWIN32__ ) || defined( __MINGW32__ ) || \
387 defined( __CYGWIN__ ) || \
388 (defined(__WATCOMC__) && __WATCOMC__ >= 1200) ) && \
389 !defined(__DOS__)
390 # include "wx/msw/gccpriv.h"
391 #else
392 # undef wxCHECK_W32API_VERSION
393 # define wxCHECK_W32API_VERSION(maj, min) (0)
394 #endif
395
396 #if defined (__WXMSW__)
397 # if !defined(__WATCOMC__)
398 # define wxHAVE_RAW_BITMAP
399 # endif
400 #endif
401
402 #if defined (__WXMAC__)
403 # ifndef WORDS_BIGENDIAN
404 # define WORDS_BIGENDIAN 1
405 # endif
406 #endif
407
408 /* Choose which method we will use for updating menus
409 * - in OnIdle, or when we receive a wxEVT_MENU_OPEN event.
410 * Presently, only Windows and GTK+ support wxEVT_MENU_OPEN.
411 */
412 #ifndef wxUSE_IDLEMENUUPDATES
413 # if (defined(__WXMSW__) || defined(__WXGTK__)) && !defined(__WXUNIVERSAL__)
414 # define wxUSE_IDLEMENUUPDATES 0
415 # else
416 # define wxUSE_IDLEMENUUPDATES 1
417 # endif
418 #endif
419
420 /*
421 * Define symbols that are not yet in
422 * configure or possibly some setup.h files.
423 * They will need to be added.
424 */
425
426 #ifndef wxUSE_FILECONFIG
427 # if wxUSE_CONFIG
428 # define wxUSE_FILECONFIG 1
429 # else
430 # define wxUSE_FILECONFIG 0
431 # endif
432 #endif
433
434 #ifndef wxUSE_HOTKEY
435 # define wxUSE_HOTKEY 0
436 #endif
437
438 #if !defined(wxUSE_WXDIB) && defined(__WXMSW__)
439 # define wxUSE_WXDIB 1
440 #endif
441
442 #endif /* _WX_PLATFORM_H_ */
443