mirror of
https://github.com/tribes2/engine.git
synced 2026-01-20 03:34:48 +00:00
496 lines
15 KiB
C++
496 lines
15 KiB
C++
//-----------------------------------------------------------------------------
|
|
// V12 Engine
|
|
//
|
|
// Copyright (c) 2001 GarageGames.Com
|
|
// Portions Copyright (c) 2001 by Sierra Online, Inc.
|
|
//-----------------------------------------------------------------------------
|
|
|
|
#ifndef _PLATFORM_H_
|
|
#define _PLATFORM_H_
|
|
|
|
#ifndef _TYPES_H_
|
|
#include "platform/types.h"
|
|
#endif
|
|
#ifndef _PLATFORMASSERT_H_
|
|
#include "platform/platformAssert.h"
|
|
#endif
|
|
|
|
//------------------------------------------------------------------------------
|
|
// Endian conversions
|
|
#ifdef PLATFORM_LITTLE_ENDIAN
|
|
|
|
inline U16 convertHostToLEndian(U16 i) { return i; }
|
|
inline U16 convertLEndianToHost(U16 i) { return i; }
|
|
inline U32 convertHostToLEndian(U32 i) { return i; }
|
|
inline U32 convertLEndianToHost(U32 i) { return i; }
|
|
inline S16 convertHostToLEndian(S16 i) { return i; }
|
|
inline S16 convertLEndianToHost(S16 i) { return i; }
|
|
inline S32 convertHostToLEndian(S32 i) { return i; }
|
|
inline S32 convertLEndianToHost(S32 i) { return i; }
|
|
|
|
inline F32 convertHostToLEndian(F32 i) { return i; }
|
|
inline F32 convertLEndianToHost(F32 i) { return i; }
|
|
|
|
inline U16 convertHostToBEndian(U16 i)
|
|
{
|
|
return U16((i << 8) | (i >> 8));
|
|
}
|
|
|
|
inline U16 convertBEndianToHost(U16 i)
|
|
{
|
|
return U16((i << 8) | (i >> 8));
|
|
}
|
|
|
|
inline S16 convertHostToBEndian(S16 i)
|
|
{
|
|
return S16(convertHostToBEndian(U16(i)));
|
|
}
|
|
|
|
inline S16 convertBEndianToHost(S16 i)
|
|
{
|
|
return S16(convertBEndianToHost(S16(i)));
|
|
}
|
|
|
|
inline U32 convertHostToBEndian(U32 i)
|
|
{
|
|
return ((i << 24) & 0xff000000) |
|
|
((i << 8) & 0x00ff0000) |
|
|
((i >> 8) & 0x0000ff00) |
|
|
((i >> 24) & 0x000000ff);
|
|
}
|
|
|
|
inline U32 convertBEndianToHost(U32 i)
|
|
{
|
|
return ((i << 24) & 0xff000000) |
|
|
((i << 8) & 0x00ff0000) |
|
|
((i >> 8) & 0x0000ff00) |
|
|
((i >> 24) & 0x000000ff);
|
|
}
|
|
|
|
inline S32 convertHostToBEndian(S32 i)
|
|
{
|
|
return S32(convertHostToBEndian(U32(i)));
|
|
}
|
|
|
|
inline S32 convertBEndianToHost(S32 i)
|
|
{
|
|
return S32(convertBEndianToHost(S32(i)));
|
|
}
|
|
|
|
|
|
#elif defined(PLATFORM_BIG_ENDIAN)
|
|
|
|
inline U16 convertHostToBEndian(U16 i) { return i; }
|
|
inline U16 convertBEndianToHost(U16 i) { return i; }
|
|
inline U32 convertHostToBEndian(U32 i) { return i; }
|
|
inline U32 convertBEndianToHost(U32 i) { return i; }
|
|
inline S16 convertHostToBEndian(S16 i) { return i; }
|
|
inline S16 convertBEndianToHost(S16 i) { return i; }
|
|
inline S32 convertHostToBEndian(S32 i) { return i; }
|
|
inline S32 convertBEndianToHost(S32 i) { return i; }
|
|
|
|
inline U16 convertHostToLEndian(U16 i)
|
|
{
|
|
return (i << 8) | (i >> 8);
|
|
}
|
|
inline U16 convertLEndianToHost(U16 i)
|
|
{
|
|
return (i << 8) | (i >> 8);
|
|
}
|
|
inline U32 convertHostToLEndian(U32 i)
|
|
{
|
|
return ((i << 24) & 0xff000000) |
|
|
((i << 8) & 0x00ff0000) |
|
|
((i >> 8) & 0x0000ff00) |
|
|
((i >> 24) & 0x000000ff);
|
|
}
|
|
inline U32 convertLEndianToHost(U32 i)
|
|
{
|
|
return ((i << 24) & 0xff000000) |
|
|
((i << 8) & 0x00ff0000) |
|
|
((i >> 8) & 0x0000ff00) |
|
|
((i >> 24) & 0x000000ff);
|
|
}
|
|
|
|
|
|
inline F32 convertHostToLEndian(F32 i)
|
|
{
|
|
U32 result = convertHostToLEndian( *reinterpret_cast<U32*>(&i) );
|
|
return *reinterpret_cast<F32*>(&result);
|
|
}
|
|
|
|
inline F32 convertLEndianToHost(F32 i)
|
|
{
|
|
U32 result = convertLEndianToHost( *reinterpret_cast<U32*>(&i) );
|
|
return *reinterpret_cast<F32*>(&result);
|
|
}
|
|
|
|
|
|
|
|
|
|
inline S16 convertHostToLEndian(S16 i) { return S16(convertHostToLEndian(U16(i))); }
|
|
inline S16 convertLEndianToHost(S16 i) { return S16(convertLEndianToHost(U16(i))); }
|
|
inline S32 convertHostToLEndian(S32 i) { return S32(convertHostToLEndian(U32(i))); }
|
|
inline S32 convertLEndianToHost(S32 i) { return S32(convertLEndianToHost(U32(i))); }
|
|
|
|
#else
|
|
#error "Endian define not set"
|
|
#endif
|
|
|
|
|
|
//------------------------------------------------------------------------------
|
|
// Input structures and functions - all input is pushed into the input event queue
|
|
template <class T> class Vector;
|
|
class Point2I;
|
|
|
|
|
|
// Theese emuns must be globally scoped so that they work
|
|
// with the inline assembly
|
|
enum ProcessorType
|
|
{ // x86
|
|
CPU_X86Compatible,
|
|
CPU_Intel_Unknown,
|
|
CPU_Intel_Pentium,
|
|
CPU_Intel_PentiumII,
|
|
CPU_Intel_PentiumIII,
|
|
CPU_AMD_K6,
|
|
CPU_AMD_K6_2,
|
|
CPU_AMD_K6_3,
|
|
CPU_AMD_K7,
|
|
CPU_AMD_Unknown,
|
|
CPU_Cyrix_6x86,
|
|
CPU_Cyrix_MediaGX,
|
|
CPU_Cyrix_6x86MX,
|
|
CPU_Cyrix_GXm, // Media GX w/ MMX
|
|
CPU_Cyrix_Unknown,
|
|
// PowerPC
|
|
CPU_PowerPC_G3
|
|
};
|
|
|
|
enum x86Properties
|
|
{ // x86 properties
|
|
CPU_PROP_C = (1<<0),
|
|
CPU_PROP_FPU = (1<<1),
|
|
CPU_PROP_MMX = (1<<2), // Integer-SIMD
|
|
CPU_PROP_3DNOW = (1<<3), // AMD Float-SIMD
|
|
CPU_PROP_SSE = (1<<4), // PentiumIII SIMD
|
|
CPU_PROP_RDTSC = (1<<5) // Read Time Stamp Counter
|
|
};
|
|
|
|
enum PPCProperties
|
|
{ // PowerPC properties
|
|
};
|
|
|
|
struct Platform
|
|
{
|
|
static void init();
|
|
static void shutdown();
|
|
static void process();
|
|
static bool doCDCheck();
|
|
static void initWindow(const Point2I &initialSize, const char *name);
|
|
static void enableKeyboardTranslation(void);
|
|
static void disableKeyboardTranslation(void);
|
|
static void setWindowLocked(bool locked);
|
|
static void minimizeWindow();
|
|
static bool excludeOtherInstances(const char *string);
|
|
|
|
static const Point2I &getWindowSize();
|
|
static void setWindowSize( U32 newWidth, U32 newHeight );
|
|
static float getRandom();
|
|
static void AlertOK(const char *windowTitle, const char *message);
|
|
static bool AlertOKCancel(const char *windowTitle, const char *message);
|
|
static bool AlertRetry(const char *windowTitle, const char *message);
|
|
|
|
struct LocalTime {
|
|
U8 sec; // seconds after minute (0-59)
|
|
U8 min; // Minutes after hour (0-59)
|
|
U8 hour; // Hours after midnight (0-23)
|
|
U8 month; // Month (0-11; 0=january)
|
|
U8 monthday; // Day of the month (1-31)
|
|
U8 weekday; // Day of the week (0-6, 6=sunday)
|
|
U16 year; // current year minus 1900
|
|
U16 yearday; // Day of year (0-365)
|
|
bool isdst; // true if daylight savings time is active
|
|
};
|
|
|
|
static void getLocalTime(LocalTime &);
|
|
|
|
struct FileInfo {
|
|
const char* pFullPath;
|
|
const char* pVirtPath;
|
|
const char* pFileName;
|
|
U32 fileSize;
|
|
};
|
|
static bool cdFileExists(const char *filePath, const char *volumeName, S32 serialNum);
|
|
static void fileToLocalTime(const FileTime &ft, LocalTime *lt);
|
|
// compare file times returns < 0 if a is earlier than b, >0 if b is earlier than a
|
|
static S32 compareFileTimes(const FileTime &a, const FileTime &b);
|
|
// Process control
|
|
public:
|
|
static void postQuitMessage(const U32 in_quitVal);
|
|
static void debugBreak();
|
|
static void forceShutdown(int returnValue);
|
|
|
|
static U32 getTime();
|
|
static U32 getVirtualMilliseconds();
|
|
static U32 getRealMilliseconds();
|
|
static void advanceTime(U32 delta);
|
|
|
|
// Directory functions. Dump path returns false iff the directory cannot be
|
|
// opened.
|
|
public:
|
|
static void getCurrentDirectory(char *out_pDirectory, const U32 in_bufferSize);
|
|
static bool dumpPath(const char *in_pBasePath, Vector<FileInfo>& out_rFileVector);
|
|
static bool getFileTimes(const char *filePath, FileTime *createTime, FileTime *modifyTime);
|
|
|
|
static bool createPath(const char *path); // create a directory path
|
|
static struct SystemInfo_struct
|
|
{
|
|
struct Processor
|
|
{
|
|
ProcessorType type;
|
|
const char *name;
|
|
U32 mhz;
|
|
U32 properties; // CPU type specific enum
|
|
}processor;
|
|
}SystemInfo;
|
|
|
|
// Web page launch function:
|
|
static bool openWebBrowser( const char* webAddress );
|
|
|
|
static const char* getLoginPassword();
|
|
static bool setLoginPassword( const char* password );
|
|
|
|
static const char* getClipboard();
|
|
static bool setClipboard(const char *text);
|
|
};
|
|
|
|
|
|
struct Processor
|
|
{
|
|
static void init();
|
|
};
|
|
|
|
|
|
//------------------------------------------------------------------------------
|
|
// time manager generates a ServerTimeEvent / ClientTimeEvent, FrameEvent combo
|
|
// every other time its process is called.
|
|
struct TimeManager
|
|
{
|
|
static void process();
|
|
};
|
|
|
|
// the entry point of the app is in the platform code...
|
|
// it calls out into game code at GameMain
|
|
|
|
// all input goes through the game input event queue
|
|
// whether or not it is used (replaying a journal, etc)
|
|
// is up to the game code. The game must copy the event data out.
|
|
|
|
struct Event;
|
|
|
|
//------------------------------------------------------------------------------
|
|
// String functions
|
|
|
|
extern char* dStrcat(char *dst, const char *src);
|
|
extern int dStrcmp(const char *str1, const char *str2);
|
|
extern int dStricmp(const char *str1, const char *str2);
|
|
extern int dStrncmp(const char *str1, const char *str2, U32 len);
|
|
extern int dStrnicmp(const char *str1, const char *str2, U32 len);
|
|
extern char* dStrcpy(char *dst, const char *src);
|
|
extern char* dStrncpy(char *dst, const char *src, U32 len);
|
|
extern U32 dStrlen(const char *str);
|
|
extern char* dStrupr(char *str);
|
|
extern char* dStrlwr(char *str);
|
|
extern char* dStrchr(char *str, int c);
|
|
extern const char* dStrchr(const char *str, int c);
|
|
extern char* dStrrchr(char *str, int c);
|
|
extern const char* dStrrchr(const char *str, int c);
|
|
extern U32 dStrspn(const char *str, const char *set);
|
|
extern U32 dStrcspn(const char *str, const char *set);
|
|
extern char* dStrstr(char *str1, char *str2);
|
|
extern const char* dStrstr(const char *str1, const char *str2);
|
|
|
|
extern char* dStrtok(char *str, const char *sep);
|
|
|
|
extern int dAtoi(const char *str);
|
|
extern float dAtof(const char *str);
|
|
extern bool dAtob(const char *str);
|
|
|
|
extern void dPrintf(const char *format, ...);
|
|
extern int dVprintf(const char *format, void *arglist);
|
|
extern int dSprintf(char *buffer, U32 bufferSize, const char *format, ...);
|
|
extern int dVsprintf(char *buffer, U32 bufferSize, const char *format, void *arglist);
|
|
extern int dSscanf(const char *buffer, const char *format, ...);
|
|
extern int dFflushStdout();
|
|
extern int dFflushStderr();
|
|
|
|
inline char dToupper(const char c) { if (c >= char('a') && c <= char('z')) return char(c + 'A' - 'a'); else return c; }
|
|
inline char dTolower(const char c) { if (c >= char('A') && c <= char('Z')) return char(c - 'A' + 'a'); else return c; }
|
|
|
|
extern bool dIsalnum(const char c);
|
|
extern bool dIsalpha(const char c);
|
|
extern bool dIsdigit(const char c);
|
|
extern bool dIsspace(const char c);
|
|
|
|
//------------------------------------------------------------------------------
|
|
// Misc StdLib functions
|
|
|
|
|
|
#define QSORT_CALLBACK FN_CDECL
|
|
void dQsort(void *base, U32 nelem, U32 width, int (QSORT_CALLBACK *fcmp)(const void *, const void *));
|
|
|
|
|
|
//------------------------------------------------------------------------------
|
|
// ConsoleObject GetClassNameFn
|
|
class ConsoleObject;
|
|
const char* __dyncreate_getNameFromType(ConsoleObject *);
|
|
|
|
|
|
//------------------------------------------------------------------------------
|
|
// Memory functions
|
|
|
|
namespace Memory {
|
|
U32 getMemoryUsed();
|
|
U32 getMemoryAllocated();
|
|
} // namespace Memory
|
|
|
|
extern void* FN_CDECL operator new(dsize_t size, void* ptr);
|
|
|
|
template <class T>
|
|
inline T* constructInPlace(T* p)
|
|
{
|
|
return new(p) T;
|
|
}
|
|
|
|
template <class T>
|
|
inline void destructInPlace(T* p)
|
|
{
|
|
p->~T();
|
|
}
|
|
|
|
#ifndef NO_MEMORY_MANAGER
|
|
extern void* FN_CDECL operator new(dsize_t size, const char*, const U32);
|
|
extern void* FN_CDECL operator new[](dsize_t size, const char*, const U32);
|
|
extern void FN_CDECL operator delete(void* ptr);
|
|
extern void FN_CDECL operator delete[](void* ptr);
|
|
#define new new(__FILE__, __LINE__)
|
|
#endif // #ifndef NO_MEMORY_MANAGER
|
|
|
|
#define placenew(x) new(x)
|
|
#define dMalloc(x) dMalloc_r(x, __FILE__, __LINE__)
|
|
#define dStrdup(x) dStrdup_r(x, __FILE__, __LINE__)
|
|
|
|
extern char* dStrdup_r(const char *src, const char*, U32);
|
|
|
|
extern void setBreakAlloc(U32);
|
|
extern void setMinimumAllocUnit(U32);
|
|
extern void* dMalloc_r(U32 in_size, const char*, const U32);
|
|
extern void dFree(void* in_pFree);
|
|
extern void* dRealloc(void* in_pResize, U32 in_size);
|
|
extern void* dRealMalloc(dsize_t);
|
|
extern void dRealFree(void*);
|
|
|
|
extern void* dMemcpy(void *dst, const void *src, unsigned size);
|
|
extern void* dMemmove(void *dst, const void *src, unsigned size);
|
|
extern void* dMemset(void *dst, int c, unsigned size);
|
|
extern int dMemcmp(const void *ptr1, const void *ptr2, unsigned size);
|
|
|
|
//------------------------------------------------------------------------------
|
|
// Graphics functions
|
|
|
|
class GFont;
|
|
extern GFont *createFont(const char *name, int size);
|
|
|
|
|
|
//------------------------------------------------------------------------------
|
|
// FileIO functions
|
|
typedef void* FILE_HANDLE;
|
|
enum DFILE_STATUS
|
|
{
|
|
DFILE_OK = 1
|
|
};
|
|
|
|
extern bool dFileDelete(const char *name);
|
|
extern bool dFileTouch(const char *name);
|
|
|
|
extern FILE_HANDLE dOpenFileRead(const char *name, DFILE_STATUS &error);
|
|
extern FILE_HANDLE dOpenFileReadWrite(const char *name, bool append, DFILE_STATUS &error);
|
|
extern int dFileRead(FILE_HANDLE handle, U32 bytes, char *dst, DFILE_STATUS &error);
|
|
extern int dFileWrite(FILE_HANDLE handle, U32 bytes, const char *dst, DFILE_STATUS &error);
|
|
extern void dFileClose(FILE_HANDLE handle);
|
|
|
|
|
|
//------------------------------------------------------------------------------
|
|
// Math
|
|
struct Math
|
|
{
|
|
static void init(U32 properties = 0); // 0 == detect available hardware
|
|
};
|
|
|
|
|
|
//------------------------------------------------------------------------------
|
|
// Networking
|
|
struct NetAddress;
|
|
|
|
typedef int NetSocket;
|
|
const NetSocket InvalidSocket = -1;
|
|
|
|
struct Net {
|
|
enum Error {
|
|
NoError,
|
|
WrongProtocolType,
|
|
InvalidPacketProtocol,
|
|
WouldBlock,
|
|
NotASocket,
|
|
UnknownError
|
|
};
|
|
enum Protocol {
|
|
UDPProtocol,
|
|
IPXProtocol,
|
|
TCPProtocol
|
|
};
|
|
static bool init();
|
|
static void shutdown();
|
|
|
|
// Unreliable net functions (UDP)
|
|
// sendto is for sending data
|
|
// all incoming data comes in on packetReceiveEventType
|
|
// App can only open one unreliable port... who needs more? ;)
|
|
static bool openPort(int connectPort);
|
|
static void closePort();
|
|
static Error sendto(const NetAddress *address, const U8 *buffer, int bufferSize);
|
|
|
|
// Reliable net functions (TCP)
|
|
// all incoming messages come in on the Connected* events
|
|
static NetSocket openListenPort(U16 port);
|
|
static NetSocket openConnectTo(const char *stringAddress); // does the DNS resolve etc.
|
|
static void closeConnectTo(NetSocket socket);
|
|
static Error sendTo(NetSocket socket, const U8 *buffer, int bufferSize);
|
|
|
|
static void process();
|
|
|
|
static bool compareAddresses(const NetAddress *a1, const NetAddress *a2);
|
|
static bool stringToAddress(const char *addressString, NetAddress *address);
|
|
static void addressToString(const NetAddress *address, char addressString[256]);
|
|
|
|
// lower level socked based network functions
|
|
static NetSocket openSocket();
|
|
static Error closeSocket(NetSocket socket);
|
|
|
|
static Error connect(NetSocket socket, const NetAddress *address);
|
|
static Error listen(NetSocket socket, int maxConcurrentListens);
|
|
static NetSocket accept(NetSocket acceptSocket, NetAddress *remoteAddress);
|
|
|
|
static Error bind(NetSocket socket, U16 port);
|
|
static Error setBufferSize(NetSocket socket, int bufferSize);
|
|
static Error setBroadcast(NetSocket socket, bool broadcastEnable);
|
|
static Error setBlocking(NetSocket socket, bool blockingIO);
|
|
|
|
static Error send(NetSocket socket, const U8 *buffer, int bufferSize);
|
|
static Error recv(NetSocket socket, U8 *buffer, int bufferSize, int *bytesRead);
|
|
};
|
|
|
|
|
|
#endif
|