/* * Global.h, part of VCMI engine * * Authors: listed in file AUTHORS in main folder * * License: GNU General Public License v2.0 or later * Full text of license available in license.txt file, in main folder * */ #pragma once /* ---------------------------------------------------------------------------- */ /* Compiler detection */ /* ---------------------------------------------------------------------------- */ // Fixed width bool data type is important for serialization static_assert(sizeof(bool) == 1, "Bool needs to be 1 byte in size."); /* ---------------------------------------------------------------------------- */ /* System detection. */ /* ---------------------------------------------------------------------------- */ // Based on: http://sourceforge.net/p/predef/wiki/OperatingSystems/ // and on: http://stackoverflow.com/questions/5919996/how-to-detect-reliably-mac-os-x-ios-linux-windows-in-c-preprocessor // TODO?: Should be moved to vstd\os_detect.h (and then included by Global.h) #ifdef _WIN16 // Defined for 16-bit environments # error "16-bit Windows isn't supported" #elif defined(_WIN64) // Defined for 64-bit environments # define VCMI_WINDOWS # define VCMI_WINDOWS_64 #elif defined(_WIN32) // Defined for both 32-bit and 64-bit environments # define VCMI_WINDOWS # define VCMI_WINDOWS_32 #elif defined(_WIN32_WCE) # error "Windows CE isn't supported" #elif defined(__linux__) || defined(__gnu_linux__) || defined(linux) || defined(__linux) # define VCMI_UNIX # define VCMI_XDG # if defined(__ANDROID__) || defined(ANDROID) # define VCMI_ANDROID # endif #elif defined(__FreeBSD_kernel__) || defined(__FreeBSD__) # define VCMI_UNIX # define VCMI_XDG # define VCMI_FREEBSD #elif defined(__OpenBSD__) # define VCMI_UNIX # define VCMI_XDG # define VCMI_OPENBSD #elif defined(__HAIKU__) # define VCMI_UNIX # define VCMI_XDG # define VCMI_HAIKU #elif defined(__GNU__) || defined(__gnu_hurd__) || (defined(__MACH__) && !defined(__APPLE__)) # define VCMI_UNIX # define VCMI_XDG # define VCMI_HURD #elif defined(__APPLE__) && defined(__MACH__) # define VCMI_UNIX # define VCMI_APPLE # include "TargetConditionals.h" # if TARGET_OS_SIMULATOR || TARGET_IPHONE_SIMULATOR # define VCMI_IOS # define VCMI_IOS_SIM # elif TARGET_OS_IPHONE # define VCMI_IOS # elif TARGET_OS_MAC # define VCMI_MAC # else //# warning "Unknown Apple target."? # endif #else # error "This platform isn't supported" #endif #if defined(VCMI_ANDROID) || defined(VCMI_IOS) #define VCMI_MOBILE #endif /* ---------------------------------------------------------------------------- */ /* Commonly used C++, Boost headers */ /* ---------------------------------------------------------------------------- */ #ifdef VCMI_WINDOWS # ifndef WIN32_LEAN_AND_MEAN # define WIN32_LEAN_AND_MEAN // Exclude rarely-used stuff from Windows headers - delete this line if something is missing. # endif # ifndef NOMINMAX # define NOMINMAX // Exclude min/max macros from . Use std::[min/max] from instead. # endif # ifndef _NO_W32_PSEUDO_MODIFIERS # define _NO_W32_PSEUDO_MODIFIERS // Exclude more macros for compiling with MinGW on Linux. # endif #endif /* ---------------------------------------------------------------------------- */ /* A macro to force inlining some of our functions */ /* ---------------------------------------------------------------------------- */ // Compiler (at least MSVC) is not so smart here-> without that displaying is MUCH slower #ifdef _MSC_VER # define STRONG_INLINE __forceinline #elif __GNUC__ # define STRONG_INLINE inline __attribute__((always_inline)) #else # define STRONG_INLINE inline #endif #define _USE_MATH_DEFINES #ifndef NDEBUG // Enable additional debug checks from glibc / libstdc++ when building with enabled assertions // Since these defines must be declared BEFORE including glibc header we can not check for __GLIBCXX__ macro to detect that glibc is in use # define _GLIBCXX_ASSERTIONS #endif #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include //The only available version is 3, as of Boost 1.50 #include #define BOOST_FILESYSTEM_VERSION 3 #if BOOST_VERSION > 105000 # define BOOST_THREAD_VERSION 3 #endif #define BOOST_THREAD_DONT_PROVIDE_THREAD_DESTRUCTOR_CALLS_TERMINATE_IF_JOINABLE 1 //need to link boost thread dynamically to avoid https://stackoverflow.com/questions/35978572/boost-thread-interupt-does-not-work-when-crossing-a-dll-boundary #define BOOST_THREAD_USE_DLL //for example VCAI::finish() may freeze on thread join after interrupt when linking this statically #define BOOST_BIND_NO_PLACEHOLDERS #if BOOST_VERSION >= 106600 #define BOOST_ASIO_ENABLE_OLD_SERVICES #endif #include #include #include #include #include #include #include #include #include #include #include #include #ifdef VCMI_WINDOWS #include #endif #include #include #include #include #include #include #include #include #include #ifndef M_PI # define M_PI 3.14159265358979323846 #endif /* ---------------------------------------------------------------------------- */ /* Usings */ /* ---------------------------------------------------------------------------- */ using namespace std::placeholders; namespace range = boost::range; /* ---------------------------------------------------------------------------- */ /* Typedefs */ /* ---------------------------------------------------------------------------- */ // Integral data types typedef uint64_t ui64; //unsigned int 64 bits (8 bytes) typedef uint32_t ui32; //unsigned int 32 bits (4 bytes) typedef uint16_t ui16; //unsigned int 16 bits (2 bytes) typedef uint8_t ui8; //unsigned int 8 bits (1 byte) typedef int64_t si64; //signed int 64 bits (8 bytes) typedef int32_t si32; //signed int 32 bits (4 bytes) typedef int16_t si16; //signed int 16 bits (2 bytes) typedef int8_t si8; //signed int 8 bits (1 byte) // Lock typedefs using TLockGuard = std::lock_guard; using TLockGuardRec = std::lock_guard; /* ---------------------------------------------------------------------------- */ /* Macros */ /* ---------------------------------------------------------------------------- */ // Import + Export macro declarations #ifdef VCMI_WINDOWS #ifdef VCMI_DLL_STATIC # define DLL_IMPORT # define DLL_EXPORT #elif defined(__GNUC__) # define DLL_IMPORT __attribute__((dllimport)) # define DLL_EXPORT __attribute__((dllexport)) # else # define DLL_IMPORT __declspec(dllimport) # define DLL_EXPORT __declspec(dllexport) # endif # define ELF_VISIBILITY #else # ifdef __GNUC__ # define DLL_IMPORT __attribute__ ((visibility("default"))) # define DLL_EXPORT __attribute__ ((visibility("default"))) # define ELF_VISIBILITY __attribute__ ((visibility("default"))) # endif #endif #ifdef VCMI_DLL # define DLL_LINKAGE DLL_EXPORT #else # define DLL_LINKAGE DLL_IMPORT #endif #define THROW_FORMAT(message, formatting_elems) throw std::runtime_error(boost::str(boost::format(message) % formatting_elems)) // old iOS SDKs compatibility #ifdef VCMI_IOS #include #ifndef __IPHONE_13_0 #define __IPHONE_13_0 130000 #endif #endif // VCMI_IOS // single-process build makes 2 copies of the main lib by wrapping it in a namespace #ifdef VCMI_LIB_NAMESPACE #define VCMI_LIB_NAMESPACE_BEGIN namespace VCMI_LIB_NAMESPACE { #define VCMI_LIB_NAMESPACE_END } #define VCMI_LIB_USING_NAMESPACE using namespace VCMI_LIB_NAMESPACE; #define VCMI_LIB_WRAP_NAMESPACE(x) VCMI_LIB_NAMESPACE::x #else #define VCMI_LIB_NAMESPACE_BEGIN #define VCMI_LIB_NAMESPACE_END #define VCMI_LIB_USING_NAMESPACE #define VCMI_LIB_WRAP_NAMESPACE(x) ::x #endif /* ---------------------------------------------------------------------------- */ /* VCMI standard library */ /* ---------------------------------------------------------------------------- */ #include VCMI_LIB_NAMESPACE_BEGIN namespace vstd { // combine hashes. Present in boost but not in std template inline void hash_combine(std::size_t& seed, const T& v) { std::hash hasher; seed ^= hasher(v) + 0x9e3779b9 + (seed<<6) + (seed>>2); } //returns true if container c contains item i template bool contains(const Container & c, const Item &i) { return std::find(std::begin(c), std::end(c),i) != std::end(c); } //returns true if container c contains item i template bool contains_if(const Container & c, Pred p) { return std::find_if(std::begin(c), std::end(c), p) != std::end(c); } //returns true if map c contains item i template bool contains(const std::map & c, const Item2 &i) { return c.find(i)!=c.end(); } //returns true if unordered set c contains item i template bool contains(const std::unordered_set & c, const Item &i) { return c.find(i)!=c.end(); } template bool contains(const std::unordered_map & c, const Item2 &i) { return c.find(i)!=c.end(); } //returns position of first element in vector c equal to s, if there is no such element, -1 is returned template int find_pos(const Container & c, const T2 &s) { int i=0; for (auto iter = std::begin(c); iter != std::end(c); iter++, i++) if(*iter == s) return i; return -1; } //Func f tells if element matches template int find_pos_if(const Container & c, const Func &f) { auto ret = boost::range::find_if(c, f); if(ret != std::end(c)) return std::distance(std::begin(c), ret); return -1; } //returns iterator to the given element if present in container, end() if not template typename Container::iterator find(Container & c, const Item &i) { return std::find(c.begin(),c.end(),i); } //returns const iterator to the given element if present in container, end() if not template typename Container::const_iterator find(const Container & c, const Item &i) { return std::find(c.begin(),c.end(),i); } //returns first key that maps to given value if present, returns success via found if provided template Key findKey(const std::map & map, const T & value, bool * found = nullptr) { for(auto iter = map.cbegin(); iter != map.cend(); iter++) { if(iter->second == value) { if(found) *found = true; return iter->first; } } if(found) *found = false; return Key(); } //removes element i from container c, returns false if c does not contain i template typename Container::size_type operator-=(Container &c, const Item &i) { typename Container::iterator itr = find(c,i); if(itr == c.end()) return false; c.erase(itr); return true; } //assigns greater of (a, b) to a and returns maximum of (a, b) template t1 &amax(t1 &a, const t2 &b) { if(a >= (t1)b) return a; else { a = t1(b); return a; } } //assigns smaller of (a, b) to a and returns minimum of (a, b) template t1 &amin(t1 &a, const t2 &b) { if(a <= (t1)b) return a; else { a = t1(b); return a; } } //makes a to fit the range template void abetween(T &value, const T &min, const T &max) { value = std::clamp(value, min, max); } //checks if a is between b and c template bool isbetween(const t1 &value, const t2 &min, const t3 &max) { return value > (t1)min && value < (t1)max; } //checks if a is within b and c template bool iswithin(const t1 &value, const t2 &min, const t3 &max) { return value >= (t1)min && value <= (t1)max; } template struct assigner { public: t1 &op1; t2 op2; assigner(t1 &a1, const t2 & a2) :op1(a1), op2(a2) {} void operator()() { op1 = op2; } }; //deleted pointer and sets it to nullptr template void clear_pointer(T* &ptr) { delete ptr; ptr = nullptr; } template typename Container::const_reference circularAt(const Container &r, size_t index) { assert(r.size()); index %= r.size(); auto itr = std::begin(r); std::advance(itr, index); return *itr; } template void erase(Container &c, const Item &item) { c.erase(boost::remove(c, item), c.end()); } template void erase_if(Range &vec, Predicate pred) { vec.erase(boost::remove_if(vec, pred),vec.end()); } template void erase_if(std::set &setContainer, Predicate pred) { auto itr = setContainer.begin(); auto endItr = setContainer.end(); while(itr != endItr) { auto tmpItr = itr++; if(pred(*tmpItr)) setContainer.erase(tmpItr); } } template void erase_if(std::unordered_set &setContainer, Predicate pred) { auto itr = setContainer.begin(); auto endItr = setContainer.end(); while(itr != endItr) { auto tmpItr = itr++; if(pred(*tmpItr)) setContainer.erase(tmpItr); } } //works for map and std::map, maybe something else template void erase_if(std::map &container, Predicate pred) { auto itr = container.begin(); auto endItr = container.end(); while(itr != endItr) { auto tmpItr = itr++; if(pred(*tmpItr)) container.erase(tmpItr); } } //works for std::unordered_map, maybe something else template void erase_if(std::unordered_map & container, Predicate pred) { auto itr = container.begin(); auto endItr = container.end(); while(itr != endItr) { auto tmpItr = itr++; if(pred(*tmpItr)) container.erase(tmpItr); } } template OutputIterator copy_if(const InputRange &input, OutputIterator result, Predicate pred) { return std::copy_if(std::cbegin(input), std::end(input), result, pred); } template std::insert_iterator set_inserter(Container &c) { return std::inserter(c, c.end()); } //Returns iterator to the element for which the value of ValueFunction is minimal template auto minElementByFun(const ForwardRange& rng, ValueFunction vf) -> decltype(std::begin(rng)) { /* Clang crashes when instantiating this function template and having PCH compilation enabled. * There is a bug report here: http://llvm.org/bugs/show_bug.cgi?id=18744 * Current bugfix is to don't use a typedef for decltype(*std::begin(rng)) and to use decltype * directly for both function parameters. */ return boost::min_element(rng, [&] (decltype(*std::begin(rng)) lhs, decltype(*std::begin(rng)) rhs) -> bool { return vf(lhs) < vf(rhs); }); } //Returns iterator to the element for which the value of ValueFunction is maximal template auto maxElementByFun(const ForwardRange& rng, ValueFunction vf) -> decltype(std::begin(rng)) { /* Clang crashes when instantiating this function template and having PCH compilation enabled. * There is a bug report here: http://llvm.org/bugs/show_bug.cgi?id=18744 * Current bugfix is to don't use a typedef for decltype(*std::begin(rng)) and to use decltype * directly for both function parameters. */ return boost::max_element(rng, [&] (decltype(*std::begin(rng)) lhs, decltype(*std::begin(rng)) rhs) -> bool { return vf(lhs) < vf(rhs); }); } /// Increments value by specific delta /// similar to std::next but works with other types, e.g. enum class template T next(const T &obj, int change) { return static_cast(static_cast(obj) + change); } template typename Container::value_type backOrNull(const Container &c) //returns last element of container or nullptr if it is empty (to be used with containers of pointers) { if(c.size()) return c.back(); else return typename Container::value_type(); } template typename Container::value_type frontOrNull(const Container &c) //returns first element of container or nullptr if it is empty (to be used with containers of pointers) { if(c.size()) return c.front(); else return nullptr; } template bool isValidIndex(const Container &c, Index i) { return i >= 0 && i < c.size(); } template typename Container::const_reference atOrDefault(const Container &r, size_t index, const typename Container::const_reference &defaultValue) { if(index < r.size()) return r[index]; return defaultValue; } template bool erase_if_present(Container &c, const Item &item) { auto i = std::find(c.begin(), c.end(), item); if (i != c.end()) { c.erase(i); return true; } return false; } template bool erase_if_present(std::map & c, const Item2 &item) { auto i = c.find(item); if (i != c.end()) { c.erase(i); return true; } return false; } template void removeDuplicates(std::vector &vec) { std::sort(vec.begin(), vec.end()); vec.erase(std::unique(vec.begin(), vec.end()), vec.end()); } template void concatenate(std::vector &dest, const std::vector &src) { dest.reserve(dest.size() + src.size()); dest.insert(dest.end(), src.begin(), src.end()); } template std::vector intersection(std::vector &v1, std::vector &v2) { std::vector v3; std::sort(v1.begin(), v1.end()); std::sort(v2.begin(), v2.end()); std::set_intersection(v1.begin(), v1.end(), v2.begin(), v2.end(), std::back_inserter(v3)); return v3; } template std::set difference(const std::set &s1, const std::set s2) { std::set s3; std::set_difference(s1.begin(), s1.end(), s2.begin(), s2.end(), std::inserter(s3, s3.end())); return s3; } template bool containsMapping(const std::multimap & map, const std::pair & mapping) { auto range = map.equal_range(mapping.first); for(auto contained = range.first; contained != range.second; contained++) { if(mapping.second == contained->second) return true; } return false; } template typename M::mapped_type & getOrCompute(M & m, const Key & k, F f) { typedef typename M::mapped_type V; std::pair r = m.insert(typename M::value_type(k, V())); V & v = r.first->second; if(r.second) f(v); return v; } //c++20 feature template Arithmetic lerp(const Arithmetic & a, const Arithmetic & b, const Floating & f) { return a + (b - a) * f; } template bool isAlmostZero(const Floating & value) { constexpr Floating epsilon(0.00001); return std::abs(value) <= epsilon; } template bool isAlmostEqual(const Floating1 & left, const Floating2 & right) { using Floating = decltype(left + right); constexpr Floating epsilon(0.00001); const Floating relativeEpsilon = std::max(std::abs(left), std::abs(right)) * epsilon; const Floating value = std::abs(left - right); return value <= relativeEpsilon; } ///compile-time version of std::abs for ints for int3, in clang++15 std::abs is constexpr static constexpr int abs(int i) { if(i < 0) return -i; return i; } ///C++23 template< class Enum > constexpr std::underlying_type_t to_underlying( Enum e ) noexcept { return static_cast>(e); } } using vstd::operator-=; VCMI_LIB_NAMESPACE_END