/* PCSX2 - PS2 Emulator for PCs * Copyright (C) 2002-2010 PCSX2 Dev Team * * PCSX2 is free software: you can redistribute it and/or modify it under the terms * of the GNU Lesser General Public License as published by the Free Software Found- * ation, either version 3 of the License, or (at your option) any later version. * * PCSX2 is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR * PURPOSE. See the GNU General Public License for more details. * * You should have received a copy of the GNU General Public License along with PCSX2. * If not, see . */ #pragma once // clang-format off #ifdef __CYGWIN__ #define __linux__ #endif // make sure __POSIX__ is defined for all systems where we assume POSIX // compliance #if defined(__linux__) || defined(__APPLE__) || defined(__unix__) || defined(__CYGWIN__) || defined(__LINUX__) #ifndef __POSIX__ #define __POSIX__ 1 #endif #endif #include "Pcsx2Types.h" #include #include #include "common/emitter/x86_intrin.h" // The C++ standard doesn't allow `offsetof` to be used on non-constant values (e.g. `offsetof(class, field[i])`) // Use this in those situations #define OFFSETOF(a, b) (reinterpret_cast(&(static_cast(0)->b))) // -------------------------------------------------------------------------------------- // Dev / Debug conditionals - Consts for using if() statements instead of uglier #ifdef. // -------------------------------------------------------------------------------------- // Note: Using if() optimizes nicely in Devel and Release builds, but will generate extra // code overhead in debug builds (since debug neither inlines, nor optimizes out const- // level conditionals). Normally not a concern, but if you stick if( IsDevbuild ) in // some tight loops it will likely make debug builds unusably slow. // #ifdef PCSX2_DEVBUILD static const bool IsDevBuild = true; #else static const bool IsDevBuild = false; #endif #ifdef PCSX2_DEBUG static const bool IsDebugBuild = true; #else static const bool IsDebugBuild = false; #endif #ifdef PCSX2_DEBUG #define pxDebugCode(code) code #else #define pxDebugCode(code) #endif #ifdef PCSX2_DEVBUILD #define pxDevelCode(code) code #else #define pxDevelCode(code) #endif #if defined(PCSX2_DEBUG) || defined(PCSX2_DEVBUILD) #define pxReleaseCode(code) #define pxNonReleaseCode(code) code #else #define pxReleaseCode(code) code #define pxNonReleaseCode(code) #endif // Defines the memory page size for the target platform at compilation. All supported platforms // (which means Intel only right now) have a 4k granularity. static constexpr unsigned int __pagesize = 0x1000; static constexpr unsigned int __pageshift = 12; static constexpr unsigned int __pagemask = __pagesize - 1; // -------------------------------------------------------------------------------------- // Microsoft Visual Studio // -------------------------------------------------------------------------------------- #ifdef _MSC_VER #define __noinline __declspec(noinline) #define __noreturn __declspec(noreturn) // Don't know if there are Visual C++ equivalents of these. #define likely(x) (!!(x)) #define unlikely(x) (!!(x)) #define CALLBACK __stdcall #else // -------------------------------------------------------------------------------------- // GCC / Intel Compilers Section // -------------------------------------------------------------------------------------- #define __assume(cond) do { if (!(cond)) __builtin_unreachable(); } while(0) // SysV ABI passes vector parameters through registers unconditionally. #ifndef _WIN32 #define __vectorcall #define CALLBACK #else #define CALLBACK __attribute__((stdcall)) #endif // Inlining note: GCC needs ((unused)) attributes defined on inlined functions to suppress // warnings when a static inlined function isn't used in the scope of a single file (which // happens *by design* like all the friggen time >_<) #define _inline __inline__ __attribute__((unused)) #ifdef NDEBUG #define __forceinline __attribute__((always_inline, unused)) #else #define __forceinline __attribute__((unused)) #endif #ifndef __noinline #define __noinline __attribute__((noinline)) #endif #ifndef __noreturn #define __noreturn __attribute__((noreturn)) #endif #define likely(x) __builtin_expect(!!(x), 1) #define unlikely(x) __builtin_expect(!!(x), 0) #endif // -------------------------------------------------------------------------------------- // __releaseinline / __ri -- a forceinline macro that is enabled for RELEASE/PUBLIC builds ONLY. // -------------------------------------------------------------------------------------- // This is useful because forceinline can make certain types of debugging problematic since // functions that look like they should be called won't breakpoint since their code is // inlined, and it can make stack traces confusing or near useless. // // Use __releaseinline for things which are generally large functions where trace debugging // from Devel builds is likely useful; but which should be inlined in an optimized Release // environment. // #ifdef PCSX2_DEVBUILD #define __releaseinline #else #define __releaseinline __forceinline #endif #define __ri __releaseinline #define __fi __forceinline // Makes sure that if anyone includes xbyak, it doesn't do anything bad #define XBYAK_ENABLE_OMITTED_OPERAND #if defined(__x86_64__) && !defined(_M_AMD64) #define _M_AMD64 #endif #ifndef RESTRICT #ifdef __INTEL_COMPILER #define RESTRICT restrict #elif defined(_MSC_VER) #define RESTRICT __restrict #elif defined(__GNUC__) #define RESTRICT __restrict__ #else #define RESTRICT #endif #endif #ifndef __has_attribute #define __has_attribute(x) 0 #endif #ifndef __has_builtin #define __has_builtin(x) 0 #endif #ifdef __cpp_constinit #define CONSTINIT constinit #elif __has_attribute(require_constant_initialization) #define CONSTINIT __attribute__((require_constant_initialization)) #else #define CONSTINIT #endif #define ASSERT assert ////////////////////////////////////////////////////////////////////////////////////////// // Safe deallocation macros -- checks pointer validity (non-null) when needed, and sets // pointer to null after deallocation. #define safe_delete(ptr) \ ((void)(delete (ptr)), (ptr) = NULL) #define safe_delete_array(ptr) \ ((void)(delete[](ptr)), (ptr) = NULL) // No checks for NULL. #define safe_free(ptr) \ ((void)(free(ptr), !!0), (ptr) = NULL) //((void) (( ( (ptr) != NULL ) && (free( ptr ), !!0) ), (ptr) = NULL)) #define safe_fclose(ptr) \ ((void)((((ptr) != NULL) && (fclose(ptr), !!0)), (ptr) = NULL)) // -------------------------------------------------------------------------------------- // ImplementEnumOperators (macro) // -------------------------------------------------------------------------------------- // This macro implements ++/-- operators for any conforming enumeration. In order for an // enum to conform, it must have _FIRST and _COUNT members defined, and must have a full // compliment of sequential members (no custom assignments) --- looking like so: // // enum Dummy { // Dummy_FIRST, // Dummy_Item = Dummy_FIRST, // Dummy_Crap, // Dummy_COUNT // }; // // The macro also defines utility functions for bounds checking enumerations: // EnumIsValid(value); // returns TRUE if the enum value is between FIRST and COUNT. // EnumAssert(value); // // It also defines a *prototype* for converting the enumeration to a string. Note that this // method is not implemented! You must implement it yourself if you want to use it: // EnumToString(value); // #define ImplementEnumOperators(enumName) \ static __fi enumName& operator++(enumName& src) \ { \ src = (enumName)((int)src + 1); \ return src; \ } \ \ static __fi enumName& operator--(enumName& src) \ { \ src = (enumName)((int)src - 1); \ return src; \ } \ \ static __fi enumName operator++(enumName& src, int) \ { \ enumName orig = src; \ src = (enumName)((int)src + 1); \ return orig; \ } \ \ static __fi enumName operator--(enumName& src, int) \ { \ enumName orig = src; \ src = (enumName)((int)src - 1); \ return orig; \ } \ \ static __fi bool operator<(const enumName& left, const pxEnumEnd_t&) { return (int)left < enumName##_COUNT; } \ static __fi bool operator!=(const enumName& left, const pxEnumEnd_t&) { return (int)left != enumName##_COUNT; } \ static __fi bool operator==(const enumName& left, const pxEnumEnd_t&) { return (int)left == enumName##_COUNT; } \ \ static __fi bool EnumIsValid(enumName id) \ { \ return ((int)id >= enumName##_FIRST) && ((int)id < enumName##_COUNT); \ } \ \ extern const char* EnumToString(enumName id) class pxEnumEnd_t { }; static const pxEnumEnd_t pxEnumEnd = {}; // -------------------------------------------------------------------------------------- // DeclareNoncopyableObject // -------------------------------------------------------------------------------------- // This macro provides an easy and clean method for ensuring objects are not copyable. // Simply add the macro to the head or tail of your class declaration, and attempts to // copy the class will give you a moderately obtuse compiler error. // #ifndef DeclareNoncopyableObject #define DeclareNoncopyableObject(classname) \ public: \ classname(const classname&) = delete; \ classname& operator=(const classname&) = delete #endif // -------------------------------------------------------------------------------------- // Handy Human-readable constants for common immediate values (_16kb -> _4gb) static constexpr sptr _1kb = 1024 * 1; static constexpr sptr _4kb = _1kb * 4; static constexpr sptr _16kb = _1kb * 16; static constexpr sptr _32kb = _1kb * 32; static constexpr sptr _64kb = _1kb * 64; static constexpr sptr _128kb = _1kb * 128; static constexpr sptr _256kb = _1kb * 256; static constexpr s64 _1mb = 1024 * 1024; static constexpr s64 _8mb = _1mb * 8; static constexpr s64 _16mb = _1mb * 16; static constexpr s64 _32mb = _1mb * 32; static constexpr s64 _64mb = _1mb * 64; static constexpr s64 _256mb = _1mb * 256; static constexpr s64 _1gb = _1mb * 1024; static constexpr s64 _4gb = _1gb * 4; // Disable some spammy warnings which wx appeared to disable. // We probably should fix these at some point. #ifdef _MSC_VER #pragma warning(disable: 4244) // warning C4244: 'initializing': conversion from 'uptr' to 'uint', possible loss of data #pragma warning(disable: 4267) // warning C4267: 'initializing': conversion from 'size_t' to 'uint', possible loss of data #endif