Added licence/copyright information
[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 Vadim Zeitlin
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__
35 # define __WXMAC_CARBON__
36 # ifdef __WXMAC_XCODE__
37 # include <unistd.h>
38 # include "wx/mac/carbon/config_xcode.h"
39 # endif
40 # else
41 # if TARGET_CARBON
42 # define __WXMAC_CARBON__
43 # else
44 # define __WXMAC_CLASSIC__
45 # endif
46 # endif
47 #endif
48
49 /*
50 __WXOSX__ is a common define to wxMac (Carbon) and wxCocoa ports under OS X.
51 */
52 #if defined(__WXMAC_OSX__) || defined(__WXCOCOA__)
53 # define __WXOSX__
54 #endif
55
56 /*
57 first define Windows symbols if they're not defined on the command line: we
58 can autodetect everything we need if _WIN32 is defined
59 */
60 #if defined(__CYGWIN32__) && !defined(__WXMOTIF__) && !defined(__WXGTK__) \
61 && !defined(__WXX11__)
62 /* for Cygwin, default to wxMSW unless otherwise specified */
63 # ifndef __WXMSW__
64 # define __WXMSW__
65 # endif
66
67 # ifndef _WIN32
68 # define _WIN32
69 # endif
70
71 # ifndef WIN32
72 # define WIN32
73 # endif
74 #endif
75
76 #if defined(__PALMOS__)
77 # ifndef __WXPALMOS__
78 # define __WXPALMOS__
79 # endif
80 # ifdef __WXMSW__
81 # undef __WXMSW__
82 # endif
83 # ifdef __WINDOWS__
84 # undef __WINDOWS__
85 # endif
86 # ifdef __WIN32__
87 # undef __WIN32__
88 # endif
89 # ifdef WIN32
90 # undef WIN32
91 # endif
92 # ifdef _WIN32
93 # undef _WIN32
94 # endif
95 #endif
96
97 #if defined(_WIN64)
98 # ifndef _WIN32
99 /*
100 a lot of code (mistakenly) uses #ifdef _WIN32 to either test for
101 Windows or to test for !__WIN16__, so we must define _WIN32 for
102 Win64 as well to ensure that the existing code continues to work.
103 */
104 # define _WIN32
105 # endif /* !_WIN32 */
106
107 # ifndef __WIN64__
108 # define __WIN64__
109 # endif /* !__WIN64__ */
110 #endif /* _WIN64 */
111
112 #if (defined(_WIN32) || defined(WIN32) || defined(__NT__) || defined(__WXWINCE__)) \
113 && !defined(__WXMOTIF__) && !defined(__WXGTK__) && !defined(__WXX11__)
114 # ifndef __WXMSW__
115 # define __WXMSW__
116 # endif
117
118 # ifndef __WIN32__
119 # define __WIN32__
120 # endif
121
122 /*
123 The library user may override the default setting of WINVER by defining
124 it in his own makefile or project file -- if it is defined, we don't
125 touch it at all.
126
127 It makes sense to define WINVER as:
128 - either some lowish value (e.g. 0x0302) to not even compile in the
129 features not available in Windows version lower than some given
130 one
131 - or to a higher value than the one used by default for the given
132 compiler if you updated its headers to newer version of Platform
133 SDK, e.g. VC6 ships with 0x0400 headers by default but may also
134 work with 0x0500 headers and beyond
135 */
136 # ifndef WINVER
137 # if defined(_MSC_VER) && _MSC_VER < 1300
138 /*
139 VC6 defines some stuff in its default headers which is normally
140 only present if WINVER >= 0x0500 (FLASHW_XXX constants) which
141 means that our usual tests not involving WINVER sometimes fail
142 with it, hence explicitly define a lower WINVER value for it.
143 */
144 # define WINVER 0x0400
145 # elif defined(__DMC__)
146 /*
147 Digital Mars is distributed with a little outdated headers.
148 */
149 # define WINVER 0x0400
150 # else /* !VC++ 6 */
151 /*
152 see MSDN for the description of possible WINVER values, this one
153 is the highest one defined right now (Windows Server 2003) and
154 we use it unless it was explicitly overridden by the user to
155 disable recent features support as we check for all of the
156 features we use which could be not available on earlier Windows
157 systems during run-time anyhow, so there is almost no
158 disadvantage in using it.
159 */
160 # define WINVER 0x0502
161 # endif /* VC++ 6/!VC++6 */
162 # endif
163
164 /* Win95 means Win95-style UI, i.e. Win9x/NT 4+ */
165 # if !defined(__WIN95__) && (WINVER >= 0x0400)
166 # define __WIN95__
167 # endif
168 #endif /* Win32 */
169
170 #if defined(__WXMSW__) || defined(__WIN32__)
171 # if !defined(__WINDOWS__)
172 # define __WINDOWS__
173 # endif
174 #endif
175
176 #ifdef __WINE__
177 # ifndef __WIN95__
178 # define __WIN95__
179 # endif
180 #endif /* WINE */
181
182 /* detect MS SmartPhone */
183 #if defined( WIN32_PLATFORM_WFSP )
184 # ifndef __SMARTPHONE__
185 # define __SMARTPHONE__
186 # endif
187 # ifndef __WXWINCE__
188 # define __WXWINCE__
189 # endif
190 #endif
191
192 /* detect PocketPC */
193 #if defined( WIN32_PLATFORM_PSPC )
194 # ifndef __POCKETPC__
195 # define __POCKETPC__
196 # endif
197 # ifndef __WXWINCE__
198 # define __WXWINCE__
199 # endif
200 #endif
201
202 /* detect Standard WinCE SDK */
203 #if defined( WCE_PLATFORM_STANDARDSDK )
204 # ifndef __WINCE_STANDARDSDK__
205 # define __WINCE_STANDARDSDK__
206 # endif
207 # ifndef __WXWINCE__
208 # define __WXWINCE__
209 # endif
210 #endif
211
212 #if defined(_WIN32_WCE) && !defined(WIN32_PLATFORM_WFSP) && !defined(WIN32_PLATFORM_PSPC)
213 # if (_WIN32_WCE >= 400)
214 # ifndef __WINCE_NET__
215 # define __WINCE_NET__
216 # endif
217 # elif (_WIN32_WCE >= 200)
218 # ifndef __HANDHELDPC__
219 # define __HANDHELDPC__
220 # endif
221 # endif
222 # ifndef __WXWINCE__
223 # define __WXWINCE__
224 # endif
225 #endif
226
227 /*
228 Hardware platform detection.
229
230 VC++ defines _M_xxx symbols.
231 */
232 #if defined(_M_IX86) || defined(i386) || defined(__i386) || defined(__i386__)
233 #ifndef __INTEL__
234 #define __INTEL__
235 #endif
236 #endif /* x86 */
237
238 #if defined(_M_IA64)
239 #ifndef __IA64__
240 #define __IA64__
241 #endif
242 #endif /* ia64 */
243
244 #if defined(_M_MPPC) || defined(__PPC__)
245 #ifndef __POWERPC__
246 #define __POWERPC__
247 #endif
248 #endif /* alpha */
249
250 #if defined(_M_ALPHA) || defined(__AXP__)
251 #ifndef __ALPHA__
252 #define __ALPHA__
253 #endif
254 #endif /* alpha */
255
256 /*
257 Include wx/setup.h for the Unix platform defines generated by configure and
258 the library compilation options
259 */
260 #include "wx/setup.h"
261
262 /* check the consistency of the settings in setup.h */
263 #include "wx/chkconf.h"
264
265 /*
266 adjust the Unicode setting: wxUSE_UNICODE should be defined as 0 or 1
267 and is used by wxWidgets, _UNICODE and/or UNICODE may be defined or used by
268 the system headers so bring these settings in sync
269 */
270
271 /* set wxUSE_UNICODE to 1 if UNICODE or _UNICODE is defined */
272 #if defined(_UNICODE) || defined(UNICODE)
273 # undef wxUSE_UNICODE
274 # define wxUSE_UNICODE 1
275 #else /* !UNICODE */
276 # ifndef wxUSE_UNICODE
277 # define wxUSE_UNICODE 0
278 # endif
279 #endif /* UNICODE/!UNICODE */
280
281 /* and vice versa: define UNICODE and _UNICODE if wxUSE_UNICODE is 1 */
282 #if wxUSE_UNICODE
283 # ifndef _UNICODE
284 # define _UNICODE
285 # endif
286 # ifndef UNICODE
287 # define UNICODE
288 # endif
289 #endif /* wxUSE_UNICODE */
290
291 #if defined( __MWERKS__ ) && !defined(__INTEL__)
292 // otherwise MSL headers bring in WIN32 dependant APIs
293 #undef UNICODE
294 #endif
295 /*
296 some compilers don't support iostream.h any longer, while some of theme
297 are not updated with <iostream> yet, so override the users setting here
298 in such case.
299 */
300 #if defined(_MSC_VER) && (_MSC_VER >= 1310)
301 # undef wxUSE_IOSTREAMH
302 # define wxUSE_IOSTREAMH 0
303 #elif defined(__DMC__) || defined(__WATCOMC__)
304 # undef wxUSE_IOSTREAMH
305 # define wxUSE_IOSTREAMH 1
306 #elif defined(__MINGW32__)
307 # undef wxUSE_IOSTREAMH
308 # define wxUSE_IOSTREAMH 0
309 #endif /* compilers with/without iostream.h */
310
311 /*
312 old C++ headers (like <iostream.h>) declare classes in the global namespace
313 while the new, standard ones (like <iostream>) do it in std:: namespace,
314 unless it's an old gcc version.
315
316 using this macro allows constuctions like "wxSTD iostream" to work in
317 either case
318 */
319 #if !wxUSE_IOSTREAMH && (!defined(__GNUC__) || ( __GNUC__ > 2 ) || (__GNUC__ == 2 && __GNUC_MINOR__ >= 95))
320 # define wxSTD std::
321 #else
322 # define wxSTD
323 #endif
324
325 /*
326 OS: first of all, test for MS-DOS platform. We must do this before testing
327 for Unix, because DJGPP compiler defines __unix__ under MS-DOS
328 */
329 #if defined(__GO32__) || defined(__DJGPP__) || defined(__DOS__)
330 # ifndef __DOS__
331 # define __DOS__
332 # endif
333 /* size_t is the same as unsigned int for Watcom 11 compiler, */
334 /* so define it if it hadn't been done by configure yet */
335 # if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG)
336 # ifdef __WATCOMC__
337 # define wxSIZE_T_IS_UINT
338 # endif
339 # ifdef __DJGPP__
340 # define wxSIZE_T_IS_ULONG
341 # endif
342 # endif
343
344 /*
345 OS: then test for generic Unix defines, then for particular flavours and
346 finally for Unix-like systems
347 */
348 #elif defined(__UNIX__) || defined(__unix) || defined(__unix__) || \
349 defined(____SVR4____) || defined(__LINUX__) || defined(__sgi) || \
350 defined(__hpux) || defined(sun) || defined(__SUN__) || defined(_AIX) || \
351 defined(__EMX__) || defined(__VMS) || defined(__BEOS__)
352
353 # define __UNIX_LIKE__
354
355 /* Helps SGI compilation, apparently */
356 # ifdef __SGI__
357 # ifdef __GNUG__
358 # define __need_wchar_t
359 # else /* !gcc */
360 /*
361 Note I use the term __SGI_CC__ for both cc and CC, its not a good
362 idea to mix gcc and cc/CC, the name mangling is different
363 */
364 # define __SGI_CC__
365 # endif /* gcc/!gcc */
366 # endif /* SGI */
367
368 # if defined(sun) || defined(__SUN__)
369 # ifndef __GNUG__
370 # ifndef __SUNCC__
371 # define __SUNCC__
372 # endif /* Sun CC */
373 # endif
374 # endif /* Sun */
375
376 # ifdef __EMX__
377 # define OS2EMX_PLAIN_CHAR
378 # endif
379
380 /* define __HPUX__ for HP-UX where standard macro is __hpux */
381 # if defined(__hpux) && !defined(__HPUX__)
382 # define __HPUX__
383 # endif /* HP-UX */
384
385 # if defined(__CYGWIN__) || defined(__WINE__)
386 # if !defined(wxSIZE_T_IS_UINT)
387 # define wxSIZE_T_IS_UINT
388 # endif
389 # endif
390 #elif defined(applec) || \
391 defined(THINK_C) || \
392 (defined(__MWERKS__) && !defined(__INTEL__))
393 /* MacOS */
394 # if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG)
395 # define wxSIZE_T_IS_ULONG
396 # endif
397 #elif defined(__WXMAC__) && defined(__APPLE__)
398 /* Mac OS X */
399 # define __UNIX_LIKE__
400
401 /*
402 These defines are needed when compiling using Project Builder
403 with a non generated setup0.h
404 */
405 # ifndef __UNIX__
406 # define __UNIX__ 1
407 # endif
408 # ifndef __BSD__
409 # define __BSD__ 1
410 # endif
411 # ifndef __DARWIN__
412 # define __DARWIN__ 1
413 # endif
414 # ifndef __POWERPC__
415 # define __POWERPC__ 1
416 # endif
417 # ifndef TARGET_CARBON
418 # define TARGET_CARBON 1
419 # endif
420
421 # if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG)
422 # define wxSIZE_T_IS_ULONG
423 # endif
424 /*
425 Some code has been added to workaround defects(?) in the
426 bundled gcc compiler. These corrections are identified by
427 __DARWIN__ for Darwin related corrections (wxMac, wxMotif)
428 */
429 #elif defined(__OS2__)
430 # if defined(__IBMCPP__)
431 # define __VISAGEAVER__ __IBMCPP__
432 # endif
433 # ifndef __WXOS2__
434 # define __WXOS2__
435 # endif
436 # ifndef __WXPM__
437 # define __WXPM__
438 # endif
439
440 /* Place other OS/2 compiler environment defines here */
441 # if defined(__VISAGECPP__)
442 /* VisualAge is the only thing that understands _Optlink */
443 # define LINKAGEMODE _Optlink
444 # endif
445 # define wxSIZE_T_IS_UINT
446
447 #elif defined(__PALMOS__)
448 # ifdef __WIN32__
449 # error "__WIN32__ should not be defined for PalmOS"
450 # endif
451 # ifdef __WINDOWS__
452 # error "__WINDOWS__ should not be defined for PalmOS"
453 # endif
454 # ifdef __WXMSW__
455 # error "__WXMSW__ should not be defined for PalmOS"
456 # endif
457
458 #else /* Windows */
459 # ifndef __WINDOWS__
460 # define __WINDOWS__
461 # endif /* Windows */
462
463 /* to be changed for Win64! */
464 # ifndef __WIN32__
465 # error "__WIN32__ should be defined for Win32 and Win64, Win16 is not supported"
466 # endif
467
468 /*
469 define another standard symbol for Microsoft Visual C++: the standard
470 one (_MSC_VER) is also defined by Metrowerks compiler
471 */
472 # if defined(_MSC_VER) && !defined(__MWERKS__)
473 # define __VISUALC__ _MSC_VER
474 # elif defined(__BCPLUSPLUS__) && !defined(__BORLANDC__)
475 # define __BORLANDC__
476 # elif defined(__WATCOMC__)
477 # elif defined(__SC__)
478 # define __SYMANTECC__
479 # endif /* compiler */
480
481 /* size_t is the same as unsigned int for all Windows compilers we know, */
482 /* so define it if it hadn't been done by configure yet */
483 # if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG)
484 # define wxSIZE_T_IS_UINT
485 # endif
486 #endif /* OS */
487
488 /*
489 if we're on a Unix system but didn't use configure (so that setup.h didn't
490 define __UNIX__), do define __UNIX__ now
491 */
492 #if !defined(__UNIX__) && defined(__UNIX_LIKE__)
493 # define __UNIX__
494 #endif /* Unix */
495
496 #if defined(__WXMOTIF__) || defined(__WXX11__)
497 # define __X__
498 #endif
499
500 #ifdef __SC__
501 # ifdef __DMC__
502 # define __DIGITALMARS__
503 # else
504 # define __SYMANTEC__
505 # endif
506 #endif
507
508 /* Force linking against required libraries under Windows CE: */
509 #ifdef __WXWINCE__
510 # include "wx/msw/wince/libraries.h"
511 #endif
512
513 /* Force inclusion of main PalmOS header: */
514 #ifdef __WXPALMOS__
515 # include <PalmOS.h>
516 # undef Abs
517 #endif
518
519 /*
520 This macro can be used to test the gcc version and can be used like this:
521
522 # if wxCHECK_GCC_VERSION(3, 1)
523 ... we have gcc 3.1 or later ...
524 # else
525 ... no gcc at all or gcc < 3.1 ...
526 # endif
527 */
528 #define wxCHECK_GCC_VERSION( major, minor ) \
529 ( defined(__GNUC__) && defined(__GNUC_MINOR__) \
530 && ( ( __GNUC__ > (major) ) \
531 || ( __GNUC__ == (major) && __GNUC_MINOR__ >= (minor) ) ) )
532
533 /*
534 This macro can be used to check that the version of mingw32 compiler is
535 at least maj.min
536 */
537 #if ( defined( __GNUWIN32__ ) || defined( __MINGW32__ ) || \
538 defined( __CYGWIN__ ) || \
539 (defined(__WATCOMC__) && __WATCOMC__ >= 1200) ) && \
540 !defined(__DOS__) && \
541 !defined(__WXMOTIF__) && \
542 !defined(__WXGTK__) && \
543 !defined(__WXX11__) && \
544 !defined(__WXPALMOS__)
545 # include "wx/msw/gccpriv.h"
546 #else
547 # undef wxCHECK_W32API_VERSION
548 # define wxCHECK_W32API_VERSION(maj, min) (0)
549 #endif
550
551 #if defined (__WXMSW__)
552 # if !defined(__WATCOMC__)
553 # define wxHAVE_RAW_BITMAP
554 # endif
555 #endif
556
557 #if defined (__WXMAC__)
558 # ifndef WORDS_BIGENDIAN
559 # define WORDS_BIGENDIAN 1
560 # endif
561 #endif
562
563 /* Choose which method we will use for updating menus
564 * - in OnIdle, or when we receive a wxEVT_MENU_OPEN event.
565 * Presently, only Windows and GTK+ support wxEVT_MENU_OPEN.
566 */
567 #ifndef wxUSE_IDLEMENUUPDATES
568 # if (defined(__WXMSW__) || defined(__WXGTK__)) && !defined(__WXUNIVERSAL__)
569 # define wxUSE_IDLEMENUUPDATES 0
570 # else
571 # define wxUSE_IDLEMENUUPDATES 1
572 # endif
573 #endif
574
575 /*
576 * Define symbols that are not yet in
577 * configure or possibly some setup.h files.
578 * They will need to be added.
579 */
580
581 #ifndef wxUSE_FILECONFIG
582 # if wxUSE_CONFIG
583 # define wxUSE_FILECONFIG 1
584 # else
585 # define wxUSE_FILECONFIG 0
586 # endif
587 #endif
588
589 #ifndef wxUSE_HOTKEY
590 # define wxUSE_HOTKEY 0
591 #endif
592
593 #if !defined(wxUSE_WXDIB) && defined(__WXMSW__)
594 # define wxUSE_WXDIB 1
595 #endif
596
597 /*
598 We need AvailabilityMacros.h for ifdefing out things that don't exist on
599 OSX 10.2 and lower
600 FIXME: We need a better way to detect for 10.3 then including a system header
601 */
602 #ifdef __DARWIN__
603 #include <AvailabilityMacros.h>
604 #endif
605
606 #endif /* _WX_PLATFORM_H_ */
607