diff options
Diffstat (limited to 'dep/g3dlite/include/G3D/System.h')
| -rw-r--r-- | dep/g3dlite/include/G3D/System.h | 185 |
1 files changed, 113 insertions, 72 deletions
diff --git a/dep/g3dlite/include/G3D/System.h b/dep/g3dlite/include/G3D/System.h index 45aef1549b6..4624dd91647 100644 --- a/dep/g3dlite/include/G3D/System.h +++ b/dep/g3dlite/include/G3D/System.h @@ -1,14 +1,14 @@ /** - @file System.h + \file System.h - @maintainer Morgan McGuire, http://graphics.cs.williams.edu + \maintainer Morgan McGuire, http://graphics.cs.williams.edu - @cite Rob Wyatt http://www.gamasutra.com/features/wyatts_world/19990709/processor_detection_01.htm - @cite Benjamin Jurke http://www.flipcode.com/cgi-bin/msg.cgi?showThread=COTD-ProcessorDetectionClass&forum=cotd&id=-1 - @cite Michael Herf http://www.stereopsis.com/memcpy.html + \cite Rob Wyatt http://www.gamasutra.com/features/wyatts_world/19990709/processor_detection_01.htm + \cite Benjamin Jurke http://www.flipcode.com/cgi-bin/msg.cgi?showThread=COTD-ProcessorDetectionClass&forum=cotd&id=-1 + \cite Michael Herf http://www.stereopsis.com/memcpy.html - @created 2003-01-25 - @edited 2008-10-14 + \created 2003-01-25 + \edited 2012-10-02 */ #ifndef G3D_System_h @@ -18,28 +18,16 @@ #include "G3D/g3dmath.h" #include "G3D/G3DGameUnits.h" #include "G3D/BinaryFormat.h" +#include "G3D/FileNotFound.h" #include <string> -#ifdef G3D_LINUX -# include <sys/socket.h> -#endif #ifdef G3D_OSX +#define Zone OSX_Zone # include <CoreServices/CoreServices.h> #endif namespace G3D { - -/** - Routine used by the demos to find the data. Searches in - ../data, ../../data, etc. up to 5 levels back. Checks - common locations like \verbatim c:\libraries\g3d-<version>\data \endverbatim - and some hard-coded paths on the Brown University file - system. - - @deprecated - */ -std::string demoFindData(bool errorIfNotFound = true); - + /** G3D, SDL, and IJG libraries require license documentation to be distributed with your program. This generates the string that must appear in your documentation. @@ -118,7 +106,7 @@ private: std::string m_cpuArch; std::string m_operatingSystem; -# ifdef G3D_WIN32 +# ifdef G3D_WINDOWS /** Used by getTick() for timing */ LARGE_INTEGER m_start; LARGE_INTEGER m_counterFrequency; @@ -167,7 +155,6 @@ private: */ static void cpuid(CPUIDFunction func, uint32& areg, uint32& breg, uint32& creg, uint32& dreg); - void init(); /** Called from init() */ void getStandardProcessorExtensions(); @@ -175,7 +162,12 @@ private: /** Called from init() */ void initTime(); + void init(); + public: + + /** atexit handling code invoked from G3DCleanupHook. */ + static void cleanup(); /** Returns the speed of processor 0 in MHz. Always returns 0 on linux.*/ @@ -243,16 +235,13 @@ public: */ static std::string currentDateString(); - /** - Guarantees that the start of the array is aligned to the - specified number of bytes. - */ - static void* alignedMalloc(size_t bytes, size_t alignment); - + /** Returns the current 24-hour local time as a string in the form HH:MM:SS */ + static std::string currentTimeString(); + /** Uses pooled storage to optimize small allocations (1 byte to 5 - kilobytes). Can be 10x to 100x faster than calling ::malloc or - new. + kilobytes). Can be 10x to 100x faster than calling \c malloc or + \c new. The result must be freed with free. @@ -289,6 +278,12 @@ public: static void free(void* p); /** + Guarantees that the start of the array is aligned to the + specified number of bytes. + */ + static void* alignedMalloc(size_t bytes, size_t alignment); + + /** Frees memory allocated with alignedMalloc. */ static void alignedFree(void* ptr); @@ -370,6 +365,7 @@ public: /** To count the number of cycles a given operation takes: + \htmlonly <PRE> unsigned long count; System::beginCycleCount(count); @@ -377,11 +373,12 @@ public: System::endCycleCount(count); // count now contains the cycle count for the intervening operation. </PRE> + \endhtmlonly */ - /* static void beginCycleCount(uint64& cycleCount); + static void beginCycleCount(uint64& cycleCount); static void endCycleCount(uint64& cycleCount); - static uint64 getCycleCount(); */ + static uint64 getCycleCount(); inline static void setOutOfMemoryCallback(OutOfMemoryCallback c) { instance().m_outOfMemoryCallback = c; @@ -404,7 +401,7 @@ public: /** Set an environment variable for the current process */ static void setEnv(const std::string& name, const std::string& value); - + /** Get an environment variable for the current process. Returns NULL if the variable doesn't exist. */ static const char* getEnv(const std::string& name); @@ -412,25 +409,53 @@ public: Prints a human-readable description of this machine to the text output stream. Either argument may be NULL. */ - static void describeSystem( - class TextOutput& t); + static void describeSystem + (class TextOutput& t); - static void describeSystem( - std::string& s); - - /** On Win32, returns the clipboard text contents. Does nothing on other - platforms (yet) */ - static std::string getClipboardText(); - - /** Copies the text to the clipboard on Win32. */ - static void setClipboardText(const std::string& s); + static void describeSystem + (std::string& s); /** Tries to locate the resource by looking in related directories. If found, returns the full path to the resource, otherwise returns the empty string. + + Looks in: + + - Literal interpretation of full (i.e., if it contains a fully-qualified name) + - Last directory in which a file was found + - Current directory + - System::appDataDir (which is usually GApp::Settings.dataDir, which defaults to the directory containing the program binary) + - $G3D9DATA directory + - System::appDataDir() + "data/" (note that this may be a zipfile named "data" with no extension) + - System::appDataDir() + "data.zip/" + - ../data-files/ (windows) + - ../../data-files/ (windows) + - ../../../data-files/ (windows) + + Plus the following subdirectories of those: + + - cubemap + - gui + - font + - icon + - models + - image + - sky + - md2 + - md3 + - ifs + - 3ds + + \param exceptionIfNotFound If true and the file is not found, throws G3D::FileNotFound. */ - static std::string findDataFile(const std::string& full, bool errorIfNotFound = true); + static std::string findDataFile(const std::string& full, bool exceptionIfNotFound = true, bool caseSensitive = +#ifdef G3D_WINDOWS + false +#else + true +#endif + ); /** Sets the path that the application is using as its data directory. @@ -441,22 +466,33 @@ public: }; -/* don't need that for MaNGOS, not portable to Win64... -#ifdef _MSC_VER - inline uint64 System::getCycleCount() { - uint32 timehi, timelo; - // Use the assembly instruction rdtsc, which gets the current - // cycle count (since the process started) and puts it in edx:eax. - __asm - { - rdtsc; - mov timehi, edx; - mov timelo, eax; - } - - return ((uint64)timehi << 32) + (uint64)timelo; - } +#ifdef _MSC_VER +# ifdef _M_IX86 + // 32-bit + inline uint64 System::getCycleCount() { + uint32 timehi, timelo; + + // Use the assembly instruction rdtsc, which gets the current + // cycle count (since the process started) and puts it in edx:eax. + __asm + { + rdtsc; + mov timehi, edx; + mov timelo, eax; + } + + return ((uint64)timehi << 32) + (uint64)timelo; + } +# else + // 64-bit + inline uint64 System::getCycleCount() { + LARGE_INTEGER now; + QueryPerformanceCounter(&now); + return now.QuadPart; + } + +# endif #elif defined(G3D_LINUX) @@ -475,13 +511,13 @@ public: #elif defined(G3D_OSX) inline uint64 System::getCycleCount() { - //Note: To put off extra processing until the end, this does not - //return the actual clock cycle count. It is a bus cycle count. - //When endCycleCount() is called, it converts the two into a difference - //of clock cycles - + //Note: To put off extra processing until the end, this does not + //return the actual clock cycle count. It is a bus cycle count. + //When endCycleCount() is called, it converts the two into a difference + //of clock cycles + return (uint64) UnsignedWideToUInt64(UpTime()); - //return (uint64) mach_absolute_time(); + //return (uint64) mach_absolute_time(); } #endif @@ -496,15 +532,20 @@ inline void System::endCycleCount(uint64& cycleCount) { cycleCount = getCycleCount() - cycleCount; #else AbsoluteTime end = UpTime(); - Nanoseconds diffNS = + Nanoseconds diffNS = AbsoluteDeltaToNanoseconds(end, UInt64ToUnsignedWide(cycleCount)); - cycleCount = - (uint64) ((double) (instance().m_OSXCPUSpeed) * + cycleCount = + (uint64) ((double) (instance().m_OSXCPUSpeed) * (double) UnsignedWideToUInt64(diffNS) * instance().m_secondsPerNS); #endif } - */ + } // namespace + +#ifdef G3D_OSX +#undef Zone +#endif + #endif |