// // Copyright (c) 2002-2014 The ANGLE Project Authors. All rights reserved. // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. // // angleutils.h: Common ANGLE utilities. #ifndef COMMON_ANGLEUTILS_H_ #define COMMON_ANGLEUTILS_H_ #include "common/platform.h" #include #include #include #include #include #include #include // A helper class to disallow copy and assignment operators namespace angle { #if defined(ANGLE_ENABLE_D3D9) || defined(ANGLE_ENABLE_D3D11) using Microsoft::WRL::ComPtr; #endif // defined(ANGLE_ENABLE_D3D9) || defined(ANGLE_ENABLE_D3D11) class NonCopyable { protected: NonCopyable() = default; ~NonCopyable() = default; private: NonCopyable(const NonCopyable&) = delete; void operator=(const NonCopyable&) = delete; }; extern const uintptr_t DirtyPointer; } // namespace angle template constexpr inline size_t ArraySize(T (&)[N]) { return N; } template class WrappedArray final : angle::NonCopyable { public: template constexpr WrappedArray(const T (&data)[N]) : mArray(&data[0]), mSize(N) { } constexpr WrappedArray() : mArray(nullptr), mSize(0) {} constexpr WrappedArray(const T *data, size_t size) : mArray(data), mSize(size) {} WrappedArray(WrappedArray &&other) : WrappedArray() { std::swap(mArray, other.mArray); std::swap(mSize, other.mSize); } ~WrappedArray() {} constexpr const T *get() const { return mArray; } constexpr size_t size() const { return mSize; } private: const T *mArray; size_t mSize; }; template void SafeRelease(T (&resourceBlock)[N]) { for (unsigned int i = 0; i < N; i++) { SafeRelease(resourceBlock[i]); } } template void SafeRelease(T& resource) { if (resource) { resource->Release(); resource = nullptr; } } template void SafeDelete(T *&resource) { delete resource; resource = nullptr; } template void SafeDeleteContainer(T& resource) { for (auto &element : resource) { SafeDelete(element); } resource.clear(); } template void SafeDeleteArray(T*& resource) { delete[] resource; resource = nullptr; } // Provide a less-than function for comparing structs // Note: struct memory must be initialized to zero, because of packing gaps template inline bool StructLessThan(const T &a, const T &b) { return (memcmp(&a, &b, sizeof(T)) < 0); } // Provide a less-than function for comparing structs // Note: struct memory must be initialized to zero, because of packing gaps template inline bool StructEquals(const T &a, const T &b) { return (memcmp(&a, &b, sizeof(T)) == 0); } template inline void StructZero(T *obj) { memset(obj, 0, sizeof(T)); } template inline bool IsMaskFlagSet(T mask, T flag) { // Handles multibit flags as well return (mask & flag) == flag; } inline const char* MakeStaticString(const std::string &str) { static std::set strings; std::set::iterator it = strings.find(str); if (it != strings.end()) { return it->c_str(); } return strings.insert(str).first->c_str(); } std::string ArrayString(unsigned int i); // Indices are stored in vectors with the outermost index in the back. In the output of the function // the indices are reversed. std::string ArrayIndexString(const std::vector &indices); inline std::string Str(int i) { std::stringstream strstr; strstr << i; return strstr.str(); } size_t FormatStringIntoVector(const char *fmt, va_list vararg, std::vector& buffer); std::string FormatString(const char *fmt, va_list vararg); std::string FormatString(const char *fmt, ...); template std::string ToString(const T &value) { std::ostringstream o; o << value; return o.str(); } // snprintf is not defined with MSVC prior to to msvc14 #if defined(_MSC_VER) && _MSC_VER < 1900 #define snprintf _snprintf #endif #define GL_BGRX8_ANGLEX 0x6ABA #define GL_BGR565_ANGLEX 0x6ABB #define GL_BGRA4_ANGLEX 0x6ABC #define GL_BGR5_A1_ANGLEX 0x6ABD #define GL_INT_64_ANGLEX 0x6ABE #define GL_UINT_64_ANGLEX 0x6ABF #define GL_BGRA8_SRGB_ANGLEX 0x6AC0 // Hidden enum for the NULL D3D device type. #define EGL_PLATFORM_ANGLE_DEVICE_TYPE_NULL_ANGLE 0x6AC0 // TODO(jmadill): Clean this up at some point. #define EGL_PLATFORM_ANGLE_PLATFORM_METHODS_ANGLEX 0x9999 #define ANGLE_TRY_CHECKED_MATH(result) \ if (!result.IsValid()) \ { \ return gl::InternalError() << "Integer overflow."; \ } // The below inlining code lifted from V8. #if defined(__clang__) || (defined(__GNUC__) && defined(__has_attribute)) #define ANGLE_HAS_ATTRIBUTE_ALWAYS_INLINE (__has_attribute(always_inline)) #define ANGLE_HAS___FORCEINLINE 0 #elif defined(_MSC_VER) #define ANGLE_HAS_ATTRIBUTE_ALWAYS_INLINE 0 #define ANGLE_HAS___FORCEINLINE 1 #else #define ANGLE_HAS_ATTRIBUTE_ALWAYS_INLINE 0 #define ANGLE_HAS___FORCEINLINE 0 #endif #if defined(NDEBUG) && ANGLE_HAS_ATTRIBUTE_ALWAYS_INLINE #define ANGLE_INLINE inline __attribute__((always_inline)) #elif defined(NDEBUG) && ANGLE_HAS___FORCEINLINE #define ANGLE_INLINE __forceinline #else #define ANGLE_INLINE inline #endif #ifndef ANGLE_STRINGIFY #define ANGLE_STRINGIFY(x) #x #endif #ifndef ANGLE_MACRO_STRINGIFY #define ANGLE_MACRO_STRINGIFY(x) ANGLE_STRINGIFY(x) #endif // Detect support for C++17 [[nodiscard]] #if !defined(__has_cpp_attribute) #define __has_cpp_attribute(name) 0 #endif // !defined(__has_cpp_attribute) #if __has_cpp_attribute(nodiscard) #define ANGLE_NO_DISCARD [[nodiscard]] #else #define ANGLE_NO_DISCARD #endif // __has_cpp_attribute(nodiscard) #endif // COMMON_ANGLEUTILS_H_