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 /*
 263    adjust the Unicode setting: wxUSE_UNICODE should be defined as 0 or 1
 264    and is used by wxWidgets, _UNICODE and/or UNICODE may be defined or used by
 265    the system headers so bring these settings in sync
 266  */
 267
 268 /* set wxUSE_UNICODE to 1 if UNICODE or _UNICODE is defined */
 269 #if defined(_UNICODE) || defined(UNICODE)
 270 #   undef wxUSE_UNICODE
 271 #   define wxUSE_UNICODE 1
 272 #else /* !UNICODE */
 273 #   ifndef wxUSE_UNICODE
 274 #       define wxUSE_UNICODE 0
 275 #   endif
 276 #endif /* UNICODE/!UNICODE */
 277
 278 /* and vice versa: define UNICODE and _UNICODE if wxUSE_UNICODE is 1 */
 279 #if wxUSE_UNICODE
 280 #   ifndef _UNICODE
 281 #       define _UNICODE
 282 #   endif
 283 #   ifndef UNICODE
 284 #       define UNICODE
 285 #   endif
 286 #endif /* wxUSE_UNICODE */
 287
 288 #if defined( __MWERKS__ ) && !defined(__INTEL__)
 289 // otherwise MSL headers bring in WIN32 dependant APIs
 290 #undef UNICODE
 291 #endif
 292
 293
 294 /*
 295    check the consistency of the settings in setup.h: note that this must be
 296    done after setting wxUSE_UNICODE correctly as it is used in wx/chkconf.h
 297  */
 298 #include "wx/chkconf.h"
 299
 300
 301 /*
 302    some compilers don't support iostream.h any longer, while some of theme
 303    are not updated with <iostream> yet, so override the users setting here
 304    in such case.
 305  */
 306 #if defined(_MSC_VER) && (_MSC_VER >= 1310)
 307 #    undef wxUSE_IOSTREAMH
 308 #    define wxUSE_IOSTREAMH 0
 309 #elif defined(__DMC__) || defined(__WATCOMC__)
 310 #    undef wxUSE_IOSTREAMH
 311 #    define wxUSE_IOSTREAMH 1
 312 #elif defined(__MINGW32__)
 313 #    undef wxUSE_IOSTREAMH
 314 #    define wxUSE_IOSTREAMH 0
 315 #endif /* compilers with/without iostream.h */
 316
 317 /*
 318    old C++ headers (like <iostream.h>) declare classes in the global namespace
 319    while the new, standard ones (like <iostream>) do it in std:: namespace,
 320    unless it's an old gcc version.
 321
 322    using this macro allows constuctions like "wxSTD iostream" to work in
 323    either case
 324  */
 325 #if !wxUSE_IOSTREAMH && (!defined(__GNUC__) || ( __GNUC__ > 2 ) || (__GNUC__ == 2 && __GNUC_MINOR__ >= 95))
 326 #    define wxSTD std::
 327 #else
 328 #    define wxSTD
 329 #endif
 330
 331 /*
 332    OS: first of all, test for MS-DOS platform. We must do this before testing
 333        for Unix, because DJGPP compiler defines __unix__ under MS-DOS
 334  */
 335 #if defined(__GO32__) || defined(__DJGPP__) || defined(__DOS__)
 336 #    ifndef __DOS__
 337 #        define __DOS__
 338 #    endif
 339     /* size_t is the same as unsigned int for Watcom 11 compiler, */
 340     /* so define it if it hadn't been done by configure yet */
 341 #    if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG)
 342 #        ifdef __WATCOMC__
 343 #            define wxSIZE_T_IS_UINT
 344 #        endif
 345 #        ifdef __DJGPP__
 346 #            define wxSIZE_T_IS_ULONG
 347 #        endif
 348 #    endif
 349
 350 /*
 351    OS: then test for generic Unix defines, then for particular flavours and
 352        finally for Unix-like systems
 353  */
 354 #elif defined(__UNIX__) || defined(__unix) || defined(__unix__) || \
 355       defined(____SVR4____) || defined(__LINUX__) || defined(__sgi) || \
 356       defined(__hpux) || defined(sun) || defined(__SUN__) || defined(_AIX) || \
 357       defined(__EMX__) || defined(__VMS) || defined(__BEOS__)
 358
 359 #    define __UNIX_LIKE__
 360
 361     /* Helps SGI compilation, apparently */
 362 #    ifdef __SGI__
 363 #        ifdef __GNUG__
 364 #            define __need_wchar_t
 365 #        else /* !gcc */
 366             /*
 367                Note I use the term __SGI_CC__ for both cc and CC, its not a good
 368                idea to mix gcc and cc/CC, the name mangling is different
 369              */
 370 #            define __SGI_CC__
 371 #        endif /* gcc/!gcc */
 372 #    endif  /* SGI */
 373
 374 #    if defined(sun) || defined(__SUN__)
 375 #        ifndef __GNUG__
 376 #            ifndef __SUNCC__
 377 #                define __SUNCC__
 378 #            endif /* Sun CC */
 379 #        endif
 380 #    endif /* Sun */
 381
 382 #    ifdef __EMX__
 383 #        define OS2EMX_PLAIN_CHAR
 384 #    endif
 385
 386     /* define __HPUX__ for HP-UX where standard macro is __hpux */
 387 #    if defined(__hpux) && !defined(__HPUX__)
 388 #        define __HPUX__
 389 #    endif /* HP-UX */
 390
 391 #    if defined(__CYGWIN__) || defined(__WINE__)
 392 #        if !defined(wxSIZE_T_IS_UINT)
 393 #            define wxSIZE_T_IS_UINT
 394 #        endif
 395 #    endif
 396 #elif defined(applec) || \
 397       defined(THINK_C) || \
 398       (defined(__MWERKS__) && !defined(__INTEL__))
 399       /* MacOS */
 400 #    if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG)
 401 #        define wxSIZE_T_IS_ULONG
 402 #    endif
 403 #elif defined(__WXMAC__) && defined(__APPLE__)
 404     /* Mac OS X */
 405 #    define __UNIX_LIKE__
 406
 407     /*
 408       These defines are needed when compiling using Project Builder
 409       with a non generated setup0.h
 410     */
 411 #    ifndef __UNIX__
 412 #        define __UNIX__ 1
 413 #    endif
 414 #    ifndef __BSD__
 415 #        define __BSD__ 1
 416 #    endif
 417 #    ifndef __DARWIN__
 418 #        define __DARWIN__ 1
 419 #    endif
 420 #    ifndef __POWERPC__
 421 #        define __POWERPC__ 1
 422 #    endif
 423 #    ifndef TARGET_CARBON
 424 #        define TARGET_CARBON 1
 425 #    endif
 426
 427 #    if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG)
 428 #        define wxSIZE_T_IS_ULONG
 429 #    endif
 430     /*
 431        Some code has been added to workaround defects(?) in the
 432        bundled gcc compiler. These corrections are identified by
 433        __DARWIN__ for Darwin related corrections (wxMac, wxMotif)
 434      */
 435 #elif defined(__OS2__)
 436 #    if defined(__IBMCPP__)
 437 #        define __VISAGEAVER__ __IBMCPP__
 438 #    endif
 439 #    ifndef __WXOS2__
 440 #        define __WXOS2__
 441 #    endif
 442 #    ifndef __WXPM__
 443 #        define __WXPM__
 444 #    endif
 445
 446     /* Place other OS/2 compiler environment defines here */
 447 #    if defined(__VISAGECPP__)
 448         /* VisualAge is the only thing that understands _Optlink */
 449 #        define LINKAGEMODE _Optlink
 450 #    endif
 451 #    define wxSIZE_T_IS_UINT
 452
 453 #elif defined(__PALMOS__)
 454 #    ifdef __WIN32__
 455 #        error "__WIN32__ should not be defined for PalmOS"
 456 #    endif
 457 #    ifdef __WINDOWS__
 458 #        error "__WINDOWS__ should not be defined for PalmOS"
 459 #    endif
 460 #    ifdef __WXMSW__
 461 #        error "__WXMSW__ should not be defined for PalmOS"
 462 #    endif
 463
 464 #else   /* Windows */
 465 #    ifndef __WINDOWS__
 466 #        define __WINDOWS__
 467 #    endif  /* Windows */
 468
 469     /* to be changed for Win64! */
 470 #    ifndef __WIN32__
 471 #        error "__WIN32__ should be defined for Win32 and Win64, Win16 is not supported"
 472 #    endif
 473
 474     /*
 475        define another standard symbol for Microsoft Visual C++: the standard
 476        one (_MSC_VER) is also defined by Metrowerks compiler
 477      */
 478 #    if defined(_MSC_VER) && !defined(__MWERKS__)
 479 #        define __VISUALC__ _MSC_VER
 480 #    elif defined(__BCPLUSPLUS__) && !defined(__BORLANDC__)
 481 #        define __BORLANDC__
 482 #      elif defined(__WATCOMC__)
 483 #    elif defined(__SC__)
 484 #        define __SYMANTECC__
 485 #    endif  /* compiler */
 486
 487     /* size_t is the same as unsigned int for all Windows compilers we know, */
 488     /* so define it if it hadn't been done by configure yet */
 489 #    if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG)
 490 #        define wxSIZE_T_IS_UINT
 491 #    endif
 492 #endif  /* OS */
 493
 494 /*
 495    if we're on a Unix system but didn't use configure (so that setup.h didn't
 496    define __UNIX__), do define __UNIX__ now
 497  */
 498 #if !defined(__UNIX__) && defined(__UNIX_LIKE__)
 499 #    define __UNIX__
 500 #endif /* Unix */
 501
 502 #if defined(__WXMOTIF__) || defined(__WXX11__)
 503 #    define __X__
 504 #endif
 505
 506 #ifdef __SC__
 507 #    ifdef __DMC__
 508 #         define __DIGITALMARS__
 509 #    else
 510 #         define __SYMANTEC__
 511 #    endif
 512 #endif
 513
 514 /* Force linking against required libraries under Windows CE: */
 515 #ifdef __WXWINCE__
 516 #   include "wx/msw/wince/libraries.h"
 517 #endif
 518
 519 /* Force inclusion of main PalmOS header: */
 520 #ifdef __WXPALMOS__
 521 #   include <PalmOS.h>
 522 #   undef Abs
 523 #endif
 524
 525 /*
 526    This macro can be used to test the gcc version and can be used like this:
 527
 528 #    if wxCHECK_GCC_VERSION(3, 1)
 529         ... we have gcc 3.1 or later ...
 530 #    else
 531         ... no gcc at all or gcc < 3.1 ...
 532 #    endif
 533 */
 534 #define wxCHECK_GCC_VERSION( major, minor ) \
 535     ( defined(__GNUC__) && defined(__GNUC_MINOR__) \
 536     && ( ( __GNUC__ > (major) ) \
 537         || ( __GNUC__ == (major) && __GNUC_MINOR__ >= (minor) ) ) )
 538
 539 /*
 540    This macro can be used to check that the version of mingw32 compiler is
 541    at least maj.min
 542  */
 543 #if ( defined( __GNUWIN32__ ) || defined( __MINGW32__ ) || \
 544     defined( __CYGWIN__ ) || \
 545       (defined(__WATCOMC__) && __WATCOMC__ >= 1200) ) && \
 546     !defined(__DOS__) && \
 547     !defined(__WXMOTIF__) && \
 548     !defined(__WXGTK__) && \
 549     !defined(__WXX11__) && \
 550     !defined(__WXPALMOS__)
 551 #    include "wx/msw/gccpriv.h"
 552 #else
 553 #    undef wxCHECK_W32API_VERSION
 554 #    define wxCHECK_W32API_VERSION(maj, min) (0)
 555 #endif
 556
 557 #if defined (__WXMSW__)
 558 #    if !defined(__WATCOMC__)
 559 #        define wxHAVE_RAW_BITMAP
 560 #    endif
 561 #endif
 562
 563 #if defined (__WXMAC__)
 564 #    if !defined(WORDS_BIGENDIAN) && ( !defined(__MACH__) || ( defined(__BIG_ENDIAN__) && __BIG_ENDIAN__ ) )
 565 #        define WORDS_BIGENDIAN 1
 566 #    endif
 567 #endif
 568
 569 /* Choose which method we will use for updating menus
 570  * - in OnIdle, or when we receive a wxEVT_MENU_OPEN event.
 571  * Presently, only Windows and GTK+ support wxEVT_MENU_OPEN.
 572  */
 573 #ifndef wxUSE_IDLEMENUUPDATES
 574 #    if (defined(__WXMSW__) || defined(__WXGTK__)) && !defined(__WXUNIVERSAL__)
 575 #        define wxUSE_IDLEMENUUPDATES 0
 576 #    else
 577 #        define wxUSE_IDLEMENUUPDATES 1
 578 #    endif
 579 #endif
 580
 581 /*
 582  * Define symbols that are not yet in
 583  * configure or possibly some setup.h files.
 584  * They will need to be added.
 585  */
 586
 587 #ifndef wxUSE_FILECONFIG
 588 #    if wxUSE_CONFIG
 589 #        define wxUSE_FILECONFIG 1
 590 #    else
 591 #        define wxUSE_FILECONFIG 0
 592 #    endif
 593 #endif
 594
 595 #ifndef wxUSE_HOTKEY
 596 #    define wxUSE_HOTKEY 0
 597 #endif
 598
 599 #if !defined(wxUSE_WXDIB) && defined(__WXMSW__)
 600 #    define wxUSE_WXDIB 1
 601 #endif
 602
 603 /*
 604     We need AvailabilityMacros.h for ifdefing out things that don't exist on
 605     OSX 10.2 and lower
 606     FIXME:  We need a better way to detect for 10.3 then including a system header
 607 */
 608 #ifdef __DARWIN__
 609     #include <AvailabilityMacros.h>
 610 #endif
 611
 612 #endif /* _WX_PLATFORM_H_ */
 613