/////////////////////////////////////////////////////////////////////////////// // Name: wx/platinfo.h // Purpose: declaration of the wxPlatformInfo class // Author: Francesco Montorsi // Modified by: // Created: 07.07.2006 (based on wxToolkitInfo) // Copyright: (c) 2006 Francesco Montorsi // Licence: wxWindows licence /////////////////////////////////////////////////////////////////////////////// #ifndef _WX_PLATINFO_H_ #define _WX_PLATINFO_H_ #include "wx/string.h" // ---------------------------------------------------------------------------- // wxPlatformInfo enums & structs // ---------------------------------------------------------------------------- // VERY IMPORTANT: when changing these enum values, also change the relative // string tables in src/common/platinfo.cpp // families & sub-families of operating systems enum wxOperatingSystemId { wxOS_UNKNOWN = 0, // returned on error wxOS_MAC_OS = 1 << 0, // Apple Mac OS 8/9/X with Mac paths wxOS_MAC_OSX_DARWIN = 1 << 1, // Apple Mac OS X with Unix paths wxOS_MAC = wxOS_MAC_OS|wxOS_MAC_OSX_DARWIN, wxOS_WINDOWS_9X = 1 << 2, // obsolete wxOS_WINDOWS_NT = 1 << 3, // obsolete wxOS_WINDOWS_MICRO = 1 << 4, // obsolete wxOS_WINDOWS_CE = 1 << 5, // obsolete wxOS_WINDOWS = wxOS_WINDOWS_9X | wxOS_WINDOWS_NT | wxOS_WINDOWS_MICRO | wxOS_WINDOWS_CE, wxOS_UNIX_LINUX = 1 << 6, // Linux wxOS_UNIX_FREEBSD = 1 << 7, // FreeBSD wxOS_UNIX_OPENBSD = 1 << 8, // OpenBSD wxOS_UNIX_NETBSD = 1 << 9, // NetBSD wxOS_UNIX_SOLARIS = 1 << 10, // SunOS wxOS_UNIX_AIX = 1 << 11, // AIX wxOS_UNIX_HPUX = 1 << 12, // HP/UX wxOS_UNIX = wxOS_UNIX_LINUX | wxOS_UNIX_FREEBSD | wxOS_UNIX_OPENBSD | wxOS_UNIX_NETBSD | wxOS_UNIX_SOLARIS | wxOS_UNIX_AIX | wxOS_UNIX_HPUX, // 1<<13 and 1<<14 available for other Unix flavours wxOS_DOS = 1 << 15, // obsolete wxOS_OS2 = 1 << 16 // obsolete }; // list of wxWidgets ports - some of them can be used with more than // a single toolkit. enum wxPortId { wxPORT_UNKNOWN = 0, // returned on error wxPORT_BASE = 1 << 0, // wxBase, no native toolkit used wxPORT_MSW = 1 << 1, // wxMSW, native toolkit is Windows API wxPORT_MOTIF = 1 << 2, // wxMotif, using [Open]Motif or Lesstif wxPORT_GTK = 1 << 3, // wxGTK, using GTK+ 1.x, 2.x, 3.x wxPORT_DFB = 1 << 4, // wxDFB, using wxUniversal wxPORT_X11 = 1 << 5, // wxX11, using wxUniversal wxPORT_PM = 1 << 6, // obsolete wxPORT_OS2 = wxPORT_PM, // obsolete wxPORT_MAC = 1 << 7, // wxOSX (former wxMac), using Cocoa or iPhone API wxPORT_OSX = wxPORT_MAC, // wxOSX, using Cocoa or iPhone API wxPORT_COCOA = 1 << 8, // wxCocoa, using Cocoa NextStep/Mac API wxPORT_WINCE = 1 << 9, // obsolete wxPORT_QT = 1 << 10 // wxQT, using Qt 5+ }; // architecture bitness of the operating system // (regardless of the build environment of wxWidgets library - see // wxIsPlatform64bit documentation for more info) enum wxBitness { wxBITNESS_INVALID = -1, // returned on error wxBITNESS_32, wxBITNESS_64, wxBITNESS_MAX }; typedef wxBitness wxArchitecture; const wxArchitecture wxARCH_INVALID = wxBITNESS_INVALID, wxARCH_32 = wxBITNESS_32, wxARCH_64 = wxBITNESS_64, wxARCH_MAX = wxBITNESS_MAX; // endian-ness of the machine enum wxEndianness { wxENDIAN_INVALID = -1, // returned on error wxENDIAN_BIG, // 4321 wxENDIAN_LITTLE, // 1234 wxENDIAN_PDP, // 3412 wxENDIAN_MAX }; // information about a linux distro returned by the lsb_release utility struct wxLinuxDistributionInfo { wxString Id; wxString Release; wxString CodeName; wxString Description; bool operator==(const wxLinuxDistributionInfo& ldi) const { return Id == ldi.Id && Release == ldi.Release && CodeName == ldi.CodeName && Description == ldi.Description; } bool operator!=(const wxLinuxDistributionInfo& ldi) const { return !(*this == ldi); } }; // Platform ID is a very broad platform categorization used in external files // (e.g. XRC), so the values here must remain stable and cannot be changed. class wxPlatformId { public: // Returns the preferred current platform name, use MatchesCurrent() to // check if the name is one of the possibly several names corresponding to // the current platform. static wxString GetCurrent() { #ifdef __WINDOWS__ return wxASCII_STR("msw"); #elif defined(__APPLE__) return wxASCII_STR("mac"); #elif defined(__UNIX__) return wxASCII_STR("unix"); #else return wxString(); #endif } // Returns true if the given string matches the current platform. static bool MatchesCurrent(const wxString& s) { // Under MSW we also support "win" platform name for compatibility with // the existing XRC files using it. #ifdef __WINDOWS__ if (s == wxASCII_STR("win")) return true; #endif // __WINDOWS__ return s == GetCurrent(); } }; // ---------------------------------------------------------------------------- // wxPlatformInfo // ---------------------------------------------------------------------------- // Information about the toolkit that the app is running under and some basic // platform and architecture bitness info class WXDLLIMPEXP_BASE wxPlatformInfo { public: wxPlatformInfo(); wxPlatformInfo(wxPortId pid, int tkMajor = -1, int tkMinor = -1, wxOperatingSystemId id = wxOS_UNKNOWN, int osMajor = -1, int osMinor = -1, wxBitness bitness = wxBITNESS_INVALID, wxEndianness endian = wxENDIAN_INVALID, bool usingUniversal = false); // default copy ctor, assignment operator and dtor are ok bool operator==(const wxPlatformInfo &t) const; bool operator!=(const wxPlatformInfo &t) const { return !(*this == t); } // Gets a wxPlatformInfo already initialized with the values for // the currently running platform. static const wxPlatformInfo& Get(); // string -> enum conversions // --------------------------------- static wxOperatingSystemId GetOperatingSystemId(const wxString &name); static wxPortId GetPortId(const wxString &portname); static wxBitness GetBitness(const wxString &bitness); wxDEPRECATED_MSG("Use GetBitness() instead") static wxArchitecture GetArch(const wxString &arch); static wxEndianness GetEndianness(const wxString &end); // enum -> string conversions // --------------------------------- static wxString GetOperatingSystemFamilyName(wxOperatingSystemId os); static wxString GetOperatingSystemIdName(wxOperatingSystemId os); static wxString GetPortIdName(wxPortId port, bool usingUniversal); static wxString GetPortIdShortName(wxPortId port, bool usingUniversal); static wxString GetBitnessName(wxBitness bitness); wxDEPRECATED_MSG("Use GetBitnessName() instead") static wxString GetArchName(wxArchitecture arch); static wxString GetEndiannessName(wxEndianness end); // getters // ----------------- int GetOSMajorVersion() const { return m_osVersionMajor; } int GetOSMinorVersion() const { return m_osVersionMinor; } int GetOSMicroVersion() const { return m_osVersionMicro; } // return true if the OS version >= major.minor bool CheckOSVersion(int major, int minor, int micro = 0) const; int GetToolkitMajorVersion() const { return m_tkVersionMajor; } int GetToolkitMinorVersion() const { return m_tkVersionMinor; } int GetToolkitMicroVersion() const { return m_tkVersionMicro; } bool CheckToolkitVersion(int major, int minor, int micro = 0) const { return DoCheckVersion(GetToolkitMajorVersion(), GetToolkitMinorVersion(), GetToolkitMicroVersion(), major, minor, micro); } bool IsUsingUniversalWidgets() const { return m_usingUniversal; } wxOperatingSystemId GetOperatingSystemId() const { return m_os; } wxLinuxDistributionInfo GetLinuxDistributionInfo() const { return m_ldi; } wxPortId GetPortId() const { return m_port; } wxBitness GetBitness() const { return m_bitness; } wxDEPRECATED_MSG("Use GetBitness() instead") wxArchitecture GetArchitecture() const { return GetBitness(); } wxEndianness GetEndianness() const { return m_endian; } // string getters // ----------------- wxString GetOperatingSystemFamilyName() const { return GetOperatingSystemFamilyName(m_os); } wxString GetOperatingSystemIdName() const { return GetOperatingSystemIdName(m_os); } wxString GetPortIdName() const { return GetPortIdName(m_port, m_usingUniversal); } wxString GetPortIdShortName() const { return GetPortIdShortName(m_port, m_usingUniversal); } wxString GetBitnessName() const { return GetBitnessName(m_bitness); } wxDEPRECATED_MSG("Use GetBitnessName() instead") wxString GetArchName() const { return GetBitnessName(); } wxString GetEndiannessName() const { return GetEndiannessName(m_endian); } wxString GetCpuArchitectureName() const { return m_cpuArch; } wxString GetOperatingSystemDescription() const { return m_osDesc; } wxString GetDesktopEnvironment() const { return m_desktopEnv; } static wxString GetOperatingSystemDirectory(); // doesn't make sense to store inside wxPlatformInfo the OS directory, // thus this function is static; note that this function simply calls // wxGetOSDirectory() and is here just to make it easier for the user to // find it that feature (global functions can be difficult to find in the docs) // setters // ----------------- void SetOSVersion(int major, int minor, int micro = 0) { m_osVersionMajor = major; m_osVersionMinor = minor; m_osVersionMicro = micro; } void SetToolkitVersion(int major, int minor, int micro = 0) { m_tkVersionMajor = major; m_tkVersionMinor = minor; m_tkVersionMicro = micro; } void SetOperatingSystemId(wxOperatingSystemId n) { m_os = n; } void SetOperatingSystemDescription(const wxString& desc) { m_osDesc = desc; } void SetPortId(wxPortId n) { m_port = n; } void SetBitness(wxBitness n) { m_bitness = n; } wxDEPRECATED_MSG("Use SetBitness() instead") void SetArchitecture(wxBitness n) { SetBitness(n); } void SetEndianness(wxEndianness n) { m_endian = n; } void SetCpuArchitectureName(const wxString& cpuArch) { m_cpuArch = cpuArch; } void SetDesktopEnvironment(const wxString& de) { m_desktopEnv = de; } void SetLinuxDistributionInfo(const wxLinuxDistributionInfo& di) { m_ldi = di; } // miscellaneous // ----------------- bool IsOk() const { return m_osVersionMajor != -1 && m_osVersionMinor != -1 && m_osVersionMicro != -1 && m_os != wxOS_UNKNOWN && !m_osDesc.IsEmpty() && m_tkVersionMajor != -1 && m_tkVersionMinor != -1 && m_tkVersionMicro != -1 && m_port != wxPORT_UNKNOWN && m_bitness != wxBITNESS_INVALID && m_endian != wxENDIAN_INVALID; // do not check linux-specific info; it's ok to have them empty } protected: static bool DoCheckVersion(int majorCur, int minorCur, int microCur, int major, int minor, int micro) { return majorCur > major || (majorCur == major && minorCur > minor) || (majorCur == major && minorCur == minor && microCur >= micro); } bool m_initializedForCurrentPlatform; void InitForCurrentPlatform(); // OS stuff // ----------------- // Version of the OS; valid if m_os != wxOS_UNKNOWN // (-1 means not initialized yet). int m_osVersionMajor, m_osVersionMinor, m_osVersionMicro; // Operating system ID. wxOperatingSystemId m_os; // Operating system description. wxString m_osDesc; // linux-specific // ----------------- wxString m_desktopEnv; wxLinuxDistributionInfo m_ldi; // toolkit // ----------------- // Version of the underlying toolkit // (-1 means not initialized yet; zero means no toolkit). int m_tkVersionMajor, m_tkVersionMinor, m_tkVersionMicro; // name of the wxWidgets port wxPortId m_port; // is using wxUniversal widgets? bool m_usingUniversal; // others // ----------------- // architecture bitness of the OS/machine wxBitness m_bitness; // endianness of the machine wxEndianness m_endian; // CPU architecture family name, possibly empty if unknown wxString m_cpuArch; }; // Returns true only for MSW programs running under Wine. #ifdef __WINDOWS__ WXDLLIMPEXP_BASE bool wxIsRunningUnderWine(); #else // !__WINDOWS__ inline bool wxIsRunningUnderWine() { return false; } #endif // __WINDOWS__/!__WINDOWS__ #endif // _WX_PLATINFO_H_