include/wx/platinfo.h

   1 ///////////////////////////////////////////////////////////////////////////////
   2 // Name:        wx/platinfo.h
   3 // Purpose:     declaration of the wxPlatformInfo class
   4 // Author:      Francesco Montorsi
   5 // Modified by:
   6 // Created:     07.07.2006 (based on wxToolkitInfo)
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) 2006 Francesco Montorsi
   9 // License:     wxWindows license
  10 ///////////////////////////////////////////////////////////////////////////////
  11
  12 #ifndef _WX_PLATINFO_H_
  13 #define _WX_PLATINFO_H_
  14
  15 #include "wx/string.h"
  16
  17 // ----------------------------------------------------------------------------
  18 // wxPlatformInfo
  19 // ----------------------------------------------------------------------------
  20
  21 // VERY IMPORTANT: when changing these enum values, also change the relative
  22 //                 string tables in src/common/platinfo.cpp
  23
  24
  25 // families & sub-families of operating systems
  26 enum wxOperatingSystemId
  27 {
  28     wxOS_UNKNOWN = 0,                 // returned on error
  29
  30     wxOS_MAC_OS         = 1 << 0,     // Apple Mac OS 8/9/X with Mac paths
  31     wxOS_MAC_OSX_DARWIN = 1 << 1,     // Apple Mac OS X with Unix paths
  32     wxOS_MAC = wxOS_MAC_OS|wxOS_MAC_OSX_DARWIN,
  33
  34     wxOS_WINDOWS_9X     = 1 << 2,     // Windows 9x family (95/98/ME)
  35     wxOS_WINDOWS_NT     = 1 << 3,     // Windows NT family (NT/2000/XP)
  36     wxOS_WINDOWS_MICRO  = 1 << 4,     // MicroWindows
  37     wxOS_WINDOWS_CE     = 1 << 5,     // Windows CE (Window Mobile)
  38     wxOS_WINDOWS = wxOS_WINDOWS_9X      |
  39                    wxOS_WINDOWS_NT      |
  40                    wxOS_WINDOWS_MICRO   |
  41                    wxOS_WINDOWS_CE,
  42
  43     wxOS_UNIX_LINUX     = 1 << 6,       // Linux
  44     wxOS_UNIX_FREEBSD   = 1 << 7,       // FreeBSD
  45     wxOS_UNIX_OPENBSD   = 1 << 8,       // OpenBSD
  46     wxOS_UNIX_NETBSD    = 1 << 9,       // NetBSD
  47     wxOS_UNIX_SOLARIS   = 1 << 10,      // SunOS
  48     wxOS_UNIX_AIX       = 1 << 11,      // AIX
  49     wxOS_UNIX_HPUX      = 1 << 12,      // HP/UX
  50     wxOS_UNIX = wxOS_UNIX_LINUX     |
  51                 wxOS_UNIX_FREEBSD   |
  52                 wxOS_UNIX_OPENBSD   |
  53                 wxOS_UNIX_NETBSD    |
  54                 wxOS_UNIX_SOLARIS   |
  55                 wxOS_UNIX_AIX       |
  56                 wxOS_UNIX_HPUX,
  57
  58     // 1<<13 and 1<<14 available for other Unix flavours
  59
  60     wxOS_DOS            = 1 << 15,      // Microsoft DOS
  61     wxOS_OS2            = 1 << 16       // OS/2
  62 };
  63
  64 // list of wxWidgets ports - some of them can be used with more than
  65 // a single toolkit.
  66 enum wxPortId
  67 {
  68     wxPORT_UNKNOWN  = 0,            // returned on error
  69
  70     wxPORT_BASE     = 1 << 0,       // wxBase, no native toolkit used
  71
  72     wxPORT_MSW      = 1 << 1,       // wxMSW, native toolkit is Windows API
  73     wxPORT_MOTIF    = 1 << 2,       // wxMotif, using [Open]Motif or Lesstif
  74     wxPORT_GTK      = 1 << 3,       // wxGTK, using GTK+ 1.x, 2.x, GPE or Maemo
  75     wxPORT_MGL      = 1 << 4,       // wxMGL, using wxUniversal
  76     wxPORT_X11      = 1 << 5,       // wxX11, using wxUniversal
  77     wxPORT_OS2      = 1 << 6,       // wxOS2, using OS/2 Presentation Manager
  78     wxPORT_MAC      = 1 << 7,       // wxMac, using Carbon or Classic Mac API
  79     wxPORT_COCOA    = 1 << 8,       // wxCocoa, using Cocoa NextStep/Mac API
  80     wxPORT_WINCE    = 1 << 9,       // wxWinCE, toolkit is WinCE SDK API
  81     wxPORT_PALMOS   = 1 << 10       // wxPalmOS, toolkit is PalmOS API
  82 };
  83
  84 // architecture of the operating system
  85 // (regardless of the build environment of wxWidgets library - see
  86 // wxIsPlatform64bit documentation for more info)
  87 enum wxArchitecture
  88 {
  89     wxARCH_INVALID = -1,        // returned on error
  90
  91     wxARCH_32,                  // 32 bit
  92     wxARCH_64,
  93
  94     wxARCH_MAX
  95 };
  96
  97
  98 // endian-ness of the machine
  99 enum wxEndianness
 100 {
 101     wxENDIAN_INVALID = -1,      // returned on error
 102
 103     wxENDIAN_BIG,               // 4321
 104     wxENDIAN_LITTLE,            // 1234
 105     wxENDIAN_PDP,               // 3412
 106
 107     wxENDIAN_MAX
 108 };
 109
 110 // Information about the toolkit that the app is running under and some basic
 111 // platform and architecture info
 112 class WXDLLIMPEXP_BASE wxPlatformInfo
 113 {
 114 public:
 115     wxPlatformInfo();
 116     wxPlatformInfo(wxPortId pid,
 117                    int tkMajor = -1, int tkMinor = -1,
 118                    wxOperatingSystemId id = wxOS_UNKNOWN,
 119                    int osMajor = -1, int osMinor = -1,
 120                    wxArchitecture arch = wxARCH_INVALID,
 121                    wxEndianness endian = wxENDIAN_INVALID);
 122
 123     // default copy ctor, assignment operator and dtor are ok
 124
 125     bool operator==(const wxPlatformInfo &t) const;
 126
 127     bool operator!=(const wxPlatformInfo &t) const
 128         { return !(*this == t); }
 129
 130
 131     // string -> enum conversions
 132     // ---------------------------------
 133
 134     static wxOperatingSystemId GetOperatingSystemId(const wxString &name);
 135     static wxPortId GetPortId(const wxString &portname);
 136
 137     static wxArchitecture GetArch(const wxString &arch);
 138     static wxEndianness GetEndianness(const wxString &end);
 139
 140     // enum -> string conversions
 141     // ---------------------------------
 142
 143     static wxString GetOperatingSystemFamilyName(wxOperatingSystemId os);
 144     static wxString GetOperatingSystemIdName(wxOperatingSystemId os);
 145     static wxString GetPortIdName(wxPortId port);
 146     static wxString GetPortIdShortName(wxPortId port);
 147
 148     static wxString GetArchName(wxArchitecture arch);
 149     static wxString GetEndiannessName(wxEndianness end);
 150
 151     // getters
 152     // -----------------
 153
 154     int GetOSMajorVersion() const
 155         { return m_osVersionMajor; }
 156     int GetOSMinorVersion() const
 157         { return m_osVersionMinor; }
 158
 159     int GetToolkitMajorVersion() const
 160         { return m_tkVersionMajor; }
 161     int GetToolkitMinorVersion() const
 162         { return m_tkVersionMinor; }
 163
 164     wxOperatingSystemId GetOperatingSystemId() const
 165         { return m_os; }
 166     wxPortId GetPortId() const
 167         { return m_port; }
 168     wxArchitecture GetArchitecture() const
 169         { return m_arch; }
 170     wxEndianness GetEndianness() const
 171         { return m_endian; }
 172
 173
 174     // string getters
 175     // -----------------
 176
 177     wxString GetOperatingSystemFamilyName() const
 178         { return GetOperatingSystemFamilyName(m_os); }
 179     wxString GetOperatingSystemIdName() const
 180         { return GetOperatingSystemIdName(m_os); }
 181     wxString GetPortIdName() const
 182         { return GetPortIdName(m_port); }
 183     wxString GetPortIdShortName() const
 184         { return GetPortIdShortName(m_port); }
 185     wxString GetArchName() const
 186         { return GetArchName(m_arch); }
 187     wxString GetEndiannessName() const
 188         { return GetEndiannessName(m_endian); }
 189
 190     // setters
 191     // -----------------
 192
 193     void SetOSVersion(int major, int minor)
 194         { m_osVersionMajor=major; m_osVersionMinor=minor; }
 195     void SetToolkitVersion(int major, int minor)
 196         { m_tkVersionMajor=major; m_tkVersionMinor=minor; }
 197
 198     void SetOperatingSystemId(wxOperatingSystemId n)
 199         { m_os=n; }
 200     void SetPortId(wxPortId n)
 201         { m_port=n; }
 202     void SetArchitecture(wxArchitecture n)
 203         { m_arch=n; }
 204     void SetEndianness(wxEndianness n)
 205         { m_endian=n; }
 206
 207     // miscellaneous
 208     // -----------------
 209
 210     bool IsOk() const
 211     {
 212         return m_osVersionMajor != -1 && m_osVersionMinor != -1 &&
 213                m_os != wxOS_UNKNOWN &&
 214                m_tkVersionMajor != -1 && m_tkVersionMinor != -1 &&
 215                m_port != wxPORT_UNKNOWN &&
 216                m_arch != wxARCH_INVALID && m_endian != wxENDIAN_INVALID;
 217     }
 218
 219     static bool IsUsingUniversalWidgets()
 220     {
 221     #ifdef __WXUNIVERSAL__
 222         return true;
 223     #else
 224         return false;
 225     #endif
 226     }
 227
 228
 229 protected:
 230     // OS stuff
 231     // -----------------
 232
 233     // Version of the OS; valid if m_os != wxOS_UNKNOWN
 234     // (-1 means not initialized yet).
 235     int m_osVersionMajor, m_osVersionMinor;
 236
 237     // Operating system ID.
 238     wxOperatingSystemId m_os;
 239
 240
 241     // toolkit
 242     // -----------------
 243
 244     // Version of the underlying toolkit
 245     // (-1 means not initialized yet; zero means no toolkit).
 246     int m_tkVersionMajor, m_tkVersionMinor;
 247
 248     // name of the wxWidgets port
 249     wxPortId m_port;
 250
 251
 252     // others
 253     // -----------------
 254
 255     // architecture of the OS
 256     wxArchitecture m_arch;
 257
 258     // endianness of the machine
 259     wxEndianness m_endian;
 260 };
 261
 262
 263 #if WXWIN_COMPATIBILITY_2_6
 264     #define wxUNKNOWN_PLATFORM      wxOS_UNKNOWN
 265     #define wxUnix                  wxOS_UNIX
 266     #define wxWin95                 wxOS_WINDOWS_9X
 267     #define wxWIN95                 wxOS_WINDOWS_9X
 268     #define wxWINDOWS_NT            wxOS_WINDOWS_NT
 269     #define wxMSW                   wxOS_WINDOWS
 270     #define wxWinCE                 wxOS_WINDOWS_CE
 271     #define wxWIN32S                wxOS_WINDOWS_9X
 272
 273     #define wxPalmOS                wxPORT_PALMOS
 274     #define wxOS2                   wxPORT_OS2
 275     #define wxMGL                   wxPORT_MGL
 276     #define wxCocoa                 wxPORT_MAC
 277     #define wxMac                   wxPORT_MAC
 278     #define wxMotif                 wxPORT_MOTIF
 279     #define wxGTK                   wxPORT_GTK
 280 #endif // WXWIN_COMPATIBILITY_2_6
 281
 282 #endif // _WX_PLATINFO_H_