#ifndef _BASE_SHARED_HPP_ #define _BASE_SHARED_HPP_ // ------------------------------------------------------------------------------------------------ #include "SqBase.hpp" // ------------------------------------------------------------------------------------------------ #include #include // ------------------------------------------------------------------------------------------------ #include #include // ------------------------------------------------------------------------------------------------ namespace SqMod { // ------------------------------------------------------------------------------------------------ extern const SQChar * g_EmptyStr; /* ------------------------------------------------------------------------------------------------ * Proxies to communicate with the server. */ extern PluginFuncs* _Func; extern PluginCallbacks* _Clbk; extern PluginInfo* _Info; // ------------------------------------------------------------------------------------------------ template < typename T > struct NumLimit; /* ------------------------------------------------------------------------------------------------ * Basic minimum and maximum values for primitive numeric types. */ template <> struct NumLimit< char > { static const char Min, Max; }; template <> struct NumLimit< signed char > { static const signed char Min, Max; }; template <> struct NumLimit< unsigned char > { static const unsigned char Min, Max; }; template <> struct NumLimit< signed short > { static const signed short Min, Max; }; template <> struct NumLimit< unsigned short > { static const unsigned short Min, Max; }; template <> struct NumLimit< signed int > { static const signed int Min, Max; }; template <> struct NumLimit< unsigned int > { static const unsigned int Min, Max; }; template <> struct NumLimit< signed long > { static const signed long Min, Max; }; template <> struct NumLimit< unsigned long > { static const unsigned long Min, Max; }; template <> struct NumLimit< signed long long > { static const signed long long Min, Max; }; template <> struct NumLimit< unsigned long long > { static const unsigned long long Min, Max; }; template <> struct NumLimit< float > { static const float Min, Max; }; template <> struct NumLimit< double > { static const double Min, Max; }; template <> struct NumLimit< long double > { static const long double Min, Max; }; /* ------------------------------------------------------------------------------------------------ * Implements RAII to restore the VM stack to it's initial size on function exit. */ struct StackGuard { /* -------------------------------------------------------------------------------------------- * Base constructor. */ StackGuard(HSQUIRRELVM vm) : m_Top(sq_gettop(vm)), m_VM(vm) { /* ... */ } /* -------------------------------------------------------------------------------------------- * Copy constructor. (disabled) */ StackGuard(const StackGuard &) = delete; /* -------------------------------------------------------------------------------------------- * Move constructor. (disabled) */ StackGuard(StackGuard &&) = delete; /* -------------------------------------------------------------------------------------------- * Destructor. */ ~StackGuard() { sq_pop(m_VM, sq_gettop(m_VM) - m_Top); } /* -------------------------------------------------------------------------------------------- * Copy assignment operator. (disabled) */ StackGuard & operator = (const StackGuard &) = delete; /* -------------------------------------------------------------------------------------------- * Move assignment operator. (disabled) */ StackGuard & operator = (StackGuard &&) = delete; private: // -------------------------------------------------------------------------------------------- Int32 m_Top; /* The top of the stack when this instance was created. */ HSQUIRRELVM m_VM; /* The VM where the stack should be restored. */ }; /* ------------------------------------------------------------------------------------------------ * Perform an equality comparison between two values taking into account floating point issues. */ template< typename T > inline bool EpsEq(const T a, const T b) { return abs(a - b) <= 0; } template <> inline bool EpsEq(const Float32 a, const Float32 b) { return fabs(a - b) <= 0.000001f; } template <> inline bool EpsEq(const Float64 a, const Float64 b) { return fabs(a - b) <= 0.000000001d; } /* ------------------------------------------------------------------------------------------------ * Perform a less than comparison between two values taking into account floating point issues. */ template< typename T > inline bool EpsLt(const T a, const T b) { return !EpsEq(a, b) && (a < b); } template <> inline bool EpsLt(const Float32 a, const Float32 b) { return !EpsEq(a, b) && (a - b) < 0.000001f; } template <> inline bool EpsLt(const Float64 a, const Float64 b) { return !EpsEq(a, b) && (a - b) < 0.000000001d; } /* ------------------------------------------------------------------------------------------------ * Perform a greater than comparison between two values taking into account floating point issues. */ template< typename T > inline bool EpsGt(const T a, const T b) { return !EpsEq(a, b) && (a > b); } template <> inline bool EpsGt(const Float32 a, const Float32 b) { return !EpsEq(a, b) && (a - b) > 0.000001f; } template <> inline bool EpsGt(const Float64 a, const Float64 b) { return !EpsEq(a, b) && (a - b) > 0.000000001d; } /* ------------------------------------------------------------------------------------------------ * Perform a less than or equal comparison between two values taking into account * floating point issues. */ template< typename T > inline bool EpsLtEq(const T a, const T b) { return !EpsEq(a, b) || (a < b); } template <> inline bool EpsLtEq(const Float32 a, const Float32 b) { return !EpsEq(a, b) || (a - b) < 0.000001f; } template <> inline bool EpsLtEq(const Float64 a, const Float64 b) { return !EpsEq(a, b) || (a - b) < 0.000000001d; } /* ------------------------------------------------------------------------------------------------ * Perform a greater than or equal comparison between two values taking into account * floating point issues. */ template< typename T > inline bool EpsGtEq(const T a, const T b) { return !EpsEq(a, b) || (a > b); } template <> inline bool EpsGtEq(const Float32 a, const Float32 b) { return !EpsEq(a, b) || (a - b) > 0.000001f; } template <> inline bool EpsGtEq(const Float64 a, const Float64 b) { return !EpsEq(a, b) || (a - b) > 0.000000001d; } /* ------------------------------------------------------------------------------------------------ * Force a value to be within a certain range. */ template< typename T > inline T Clamp(T val, T min, T max) { return val < min ? min : (val > max ? max : val); } /* ------------------------------------------------------------------------------------------------ * Compute the next power of two for the specified number. */ inline Uint32 NextPow2(Uint32 num) { --num; num |= num >> 1; num |= num >> 2; num |= num >> 4; num |= num >> 8; num |= num >> 16; return ++num; } /* ------------------------------------------------------------------------------------------------ * Output a message only if the _DEBUG was defined. */ void OutputDebug(const char * msg, ...); /* ------------------------------------------------------------------------------------------------ * Output a formatted user message to the console. */ void OutputMessage(const char * msg, ...); /* ------------------------------------------------------------------------------------------------ * Output a formatted error message to the console. */ void OutputError(const char * msg, ...); /* ------------------------------------------------------------------------------------------------ * Retrieve a reference to a null script object. */ Object & NullObject(); /* ------------------------------------------------------------------------------------------------ * Retrieve a reference to a null/empty script array. */ Array & NullArray(); /* ------------------------------------------------------------------------------------------------ * Retrieve a reference to a null script function. */ Function & NullFunction(); /* ------------------------------------------------------------------------------------------------ * Create a script string object from a buffer. */ Object BufferToStrObj(const Buffer & b); /* ------------------------------------------------------------------------------------------------ * Create a script string object from a portion of a buffer. */ Object BufferToStrObj(const Buffer & b, Uint32 size); /* ------------------------------------------------------------------------------------------------ * Create a script object from the specified value on the default VM. */ template < typename T > Object MakeObject(const T & v) { PushVar< T >(DefaultVM::Get(), v); Var< Object > var(DefaultVM::Get(), -1); sq_pop(DefaultVM::Get(), 1); return var.value; } /* ------------------------------------------------------------------------------------------------ * Create a script object from the specified value on the specified VM. */ template < typename T > Object MakeObject(HSQUIRRELVM vm, const T & v) { PushVar< T >(vm, v); Var< Object > var(vm, -1); sq_pop(vm, 1); return var.value; } /* ------------------------------------------------------------------------------------------------ * Simple function to check whether the specified string can be considered as a boolean value */ bool SToB(CSStr str); /* ------------------------------------------------------------------------------------------------ * Generate a formatted string and throw it as a sqrat exception. */ void SqThrowF(CCStr fmt, ...); /* ------------------------------------------------------------------------------------------------ * Quickly generate a formatted string on a small static buffer without any memory allocations. */ CSStr ToStrF(CCStr fmt, ...); /* ------------------------------------------------------------------------------------------------ * Generate a formatted string on a temporary buffer and return the string but not the buffer. */ CSStr ToStringF(CCStr fmt, ...); /* ------------------------------------------------------------------------------------------------ * Obtain a randomly chosen color from a list of known colors. */ const Color3 & GetRandomColor(); /* ------------------------------------------------------------------------------------------------ * Attempt to identify the color in the specified name and return it. */ Color3 GetColor(CSStr name); /* ------------------------------------------------------------------------------------------------ * Extract the values for components of the AABB type from a string. */ const AABB & GetAABB(CSStr str, SQChar delim); /* ------------------------------------------------------------------------------------------------ * Extract the values for components of the Circle type from a string. */ const Circle & GetCircle(CSStr str, SQChar delim); /* ------------------------------------------------------------------------------------------------ * Extract the values for components of the Color3 type from a string. */ const Color3 & GetColor3(CSStr str, SQChar delim); /* ------------------------------------------------------------------------------------------------ * Extract the values for components of the Color4 type from a string. */ const Color4 & GetColor4(CSStr str, SQChar delim); /* ------------------------------------------------------------------------------------------------ * Extract the values for components of the Quaternion type from a string. */ const Quaternion & GetQuaternion(CSStr str, SQChar delim); /* ------------------------------------------------------------------------------------------------ * Extract the values for components of the Sphere type from a string. */ const Sphere & GetSphere(CSStr str, SQChar delim); /* ------------------------------------------------------------------------------------------------ * Extract the values for components of the Vector2 type from a string. */ const Vector2 & GetVector2(CSStr str, SQChar delim); /* ------------------------------------------------------------------------------------------------ * Extract the values for components of the Vector2i type from a string. */ const Vector2i & GetVector2i(CSStr str, SQChar delim); /* ------------------------------------------------------------------------------------------------ * Extract the values for components of the Vector3 type from a string. */ const Vector3 & GetVector3(CSStr str, SQChar delim); /* ------------------------------------------------------------------------------------------------ * Extract the values for components of the Vector4 type from a string. */ const Vector4 & GetVector4(CSStr str, SQChar delim); /* ------------------------------------------------------------------------------------------------ * Forward declarations of the logging functions to avoid including the logger everywhere. */ // ------------------------------------------------------------------------------------------------ void LogDbg(CCStr fmt, ...); void LogUsr(CCStr fmt, ...); void LogScs(CCStr fmt, ...); void LogInf(CCStr fmt, ...); void LogWrn(CCStr fmt, ...); void LogErr(CCStr fmt, ...); void LogFtl(CCStr fmt, ...); // ------------------------------------------------------------------------------------------------ void LogSDbg(CCStr fmt, ...); void LogSUsr(CCStr fmt, ...); void LogSScs(CCStr fmt, ...); void LogSInf(CCStr fmt, ...); void LogSWrn(CCStr fmt, ...); void LogSErr(CCStr fmt, ...); void LogSFtl(CCStr fmt, ...); // ------------------------------------------------------------------------------------------------ bool cLogDbg(bool cond, CCStr fmt, ...); bool cLogUsr(bool cond, CCStr fmt, ...); bool cLogScs(bool cond, CCStr fmt, ...); bool cLogInf(bool cond, CCStr fmt, ...); bool cLogWrn(bool cond, CCStr fmt, ...); bool cLogErr(bool cond, CCStr fmt, ...); bool cLogFtl(bool cond, CCStr fmt, ...); // ------------------------------------------------------------------------------------------------ bool cLogSDbg(bool cond, CCStr fmt, ...); bool cLogSUsr(bool cond, CCStr fmt, ...); bool cLogSScs(bool cond, CCStr fmt, ...); bool cLogSInf(bool cond, CCStr fmt, ...); bool cLogSWrn(bool cond, CCStr fmt, ...); bool cLogSErr(bool cond, CCStr fmt, ...); bool cLogSFtl(bool cond, CCStr fmt, ...); } // Namespace:: SqMod #endif // _BASE_SHARED_HPP_