Audio plugin host https://kx.studio/carla
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

327 lines
13KB

  1. /*
  2. * Carla common defines
  3. * Copyright (C) 2011-2021 Filipe Coelho <falktx@falktx.com>
  4. *
  5. * This program is free software; you can redistribute it and/or
  6. * modify it under the terms of the GNU General Public License as
  7. * published by the Free Software Foundation; either version 2 of
  8. * the License, or any later version.
  9. *
  10. * This program is distributed in the hope that it will be useful,
  11. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  13. * GNU General Public License for more details.
  14. *
  15. * For a full copy of the GNU General Public License see the doc/GPL.txt file.
  16. */
  17. #ifndef CARLA_DEFINES_H_INCLUDED
  18. #define CARLA_DEFINES_H_INCLUDED
  19. /* IDE Helper */
  20. #ifndef REAL_BUILD
  21. # include "config.h"
  22. #endif
  23. /* Compatibility with non-clang compilers */
  24. #ifndef __has_feature
  25. # define __has_feature(x) 0
  26. #endif
  27. #ifndef __has_extension
  28. # define __has_extension __has_feature
  29. #endif
  30. /* Set Version */
  31. #define CARLA_VERSION_HEX 0x020401
  32. #define CARLA_VERSION_STRING "2.4.1"
  33. #define CARLA_VERSION_STRMIN "2.4"
  34. /* Check OS */
  35. #if defined(WIN64) || defined(_WIN64) || defined(__WIN64__) || defined(_M_ARM64)
  36. # define CARLA_OS_WIN64
  37. #elif defined(WIN32) || defined(_WIN32) || defined(__WIN32__)
  38. # define CARLA_OS_WIN32
  39. #elif defined(__APPLE__)
  40. # define CARLA_OS_MAC
  41. #elif defined(__HAIKU__)
  42. # define CARLA_OS_HAIKU
  43. #elif defined(__linux__) || defined(__linux)
  44. # define CARLA_OS_LINUX
  45. #elif defined(__FreeBSD__) || defined(__NetBSD__) || defined(__OpenBSD__)
  46. # define CARLA_OS_BSD
  47. #elif defined(__GNU__)
  48. # define CARLA_OS_GNU_HURD
  49. #elif defined(__EMSCRIPTEN__)
  50. # define CARLA_OS_WASM
  51. #else
  52. # warning Unsupported platform!
  53. #endif
  54. #if defined(CARLA_OS_WIN32) || defined(CARLA_OS_WIN64)
  55. # define CARLA_OS_WIN
  56. #elif defined(CARLA_OS_BSD) || defined(CARLA_OS_GNU_HURD) || defined(CARLA_OS_LINUX) || defined(CARLA_OS_MAC)
  57. # define CARLA_OS_UNIX
  58. #endif
  59. #if defined(__LP64__) || defined(_LP64) || defined(__arm64__) || defined(__aarch64__) || defined(CARLA_OS_WIN64)
  60. # define CARLA_OS_64BIT
  61. #endif
  62. /* Check for C++11 support */
  63. #if defined(HAVE_CPP11_SUPPORT)
  64. # if HAVE_CPP11_SUPPORT
  65. # define CARLA_PROPER_CPP11_SUPPORT
  66. # endif
  67. #elif defined(__cplusplus)
  68. # if __cplusplus >= 201103L || (defined(__GNUC__) && (__GNUC__ * 100 + __GNUC_MINOR__) >= 405 && defined(__GXX_EXPERIMENTAL_CXX0X__)) || __has_extension(cxx_noexcept)
  69. # define CARLA_PROPER_CPP11_SUPPORT
  70. # if (defined(__GNUC__) && (__GNUC__ * 100 + __GNUC_MINOR__) < 407 && ! defined(__clang__)) || (defined(__clang__) && ! __has_extension(cxx_override_control))
  71. # define override // gcc4.7+ only
  72. # define final // gcc4.7+ only
  73. # endif
  74. # endif
  75. #endif
  76. #if defined(__cplusplus) && ! defined(CARLA_PROPER_CPP11_SUPPORT)
  77. # define noexcept throw()
  78. # define override
  79. # define final
  80. # define nullptr NULL
  81. #endif
  82. /* Common includes */
  83. #ifdef __cplusplus
  84. # include <cstddef>
  85. #else
  86. # include <stdbool.h>
  87. # include <stddef.h>
  88. #endif
  89. /* Define various string format types */
  90. #if defined(CARLA_OS_WIN64)
  91. # define P_INT64 "%lli"
  92. # define P_UINT64 "%llu"
  93. # define P_INTPTR "%lli"
  94. # define P_UINTPTR "%llx"
  95. # define P_SIZE "%llu"
  96. # define P_SSIZE "%lli"
  97. #elif defined(CARLA_OS_WIN32)
  98. # define P_INT64 "%lli"
  99. # define P_UINT64 "%llu"
  100. # define P_INTPTR "%i"
  101. # define P_UINTPTR "%x"
  102. # define P_SIZE "%u"
  103. # define P_SSIZE "%i"
  104. #elif defined(CARLA_OS_MAC)
  105. # define P_INT64 "%lli"
  106. # define P_UINT64 "%llu"
  107. # define P_INTPTR "%li"
  108. # define P_UINTPTR "%lx"
  109. # define P_SIZE "%lu"
  110. # define P_SSIZE "%li"
  111. #elif (defined(__WORDSIZE) && __WORDSIZE == 64) || \
  112. (defined(__SIZE_WIDTH__) && __SIZE_WIDTH__ == 64) || \
  113. (defined(CARLA_OS_HAIKU) && defined(CARLA_OS_64BIT))
  114. # define P_INT64 "%li"
  115. # define P_UINT64 "%lu"
  116. # define P_INTPTR "%li"
  117. # define P_UINTPTR "%lx"
  118. # define P_SIZE "%lu"
  119. # define P_SSIZE "%li"
  120. #else
  121. # define P_INT64 "%lli"
  122. # define P_UINT64 "%llu"
  123. # define P_INTPTR "%i"
  124. # define P_UINTPTR "%x"
  125. # define P_SIZE "%u"
  126. # define P_SSIZE "%i"
  127. #endif
  128. /* Define BINARY_NATIVE */
  129. #if defined(CARLA_OS_WIN)
  130. # ifdef CARLA_OS_WIN64
  131. # define BINARY_NATIVE BINARY_WIN64
  132. # else
  133. # define BINARY_NATIVE BINARY_WIN32
  134. # endif
  135. #else
  136. # ifdef CARLA_OS_64BIT
  137. # define BINARY_NATIVE BINARY_POSIX64
  138. # else
  139. # define BINARY_NATIVE BINARY_POSIX32
  140. # endif
  141. #endif
  142. /* Define CARLA_ASSERT* */
  143. #if defined(CARLA_NO_ASSERTS)
  144. # define CARLA_ASSERT(cond)
  145. # define CARLA_ASSERT_INT(cond, value)
  146. # define CARLA_ASSERT_INT2(cond, v1, v2)
  147. #elif defined(NDEBUG)
  148. # define CARLA_ASSERT CARLA_SAFE_ASSERT
  149. # define CARLA_ASSERT_INT CARLA_SAFE_ASSERT_INT
  150. # define CARLA_ASSERT_INT2 CARLA_SAFE_ASSERT_INT2
  151. #else
  152. # define CARLA_ASSERT(cond) assert(cond)
  153. # define CARLA_ASSERT_INT(cond, value) assert(cond)
  154. # define CARLA_ASSERT_INT2(cond, v1, v2) assert(cond)
  155. #endif
  156. /* Define CARLA_SAFE_ASSERT* */
  157. #define CARLA_SAFE_ASSERT(cond) if (! (cond)) carla_safe_assert (#cond, __FILE__, __LINE__);
  158. #define CARLA_SAFE_ASSERT_INT(cond, value) if (! (cond)) carla_safe_assert_int (#cond, __FILE__, __LINE__, static_cast<int>(value));
  159. #define CARLA_SAFE_ASSERT_INT2(cond, v1, v2) if (! (cond)) carla_safe_assert_int2 (#cond, __FILE__, __LINE__, static_cast<int>(v1), static_cast<int>(v2));
  160. #define CARLA_SAFE_ASSERT_UINT(cond, value) if (! (cond)) carla_safe_assert_uint (#cond, __FILE__, __LINE__, static_cast<uint>(value));
  161. #define CARLA_SAFE_ASSERT_UINT2(cond, v1, v2) if (! (cond)) carla_safe_assert_uint2(#cond, __FILE__, __LINE__, static_cast<uint>(v1), static_cast<uint>(v2));
  162. #define CARLA_SAFE_ASSERT_BREAK(cond) if (! (cond)) { carla_safe_assert(#cond, __FILE__, __LINE__); break; }
  163. #define CARLA_SAFE_ASSERT_CONTINUE(cond) if (! (cond)) { carla_safe_assert(#cond, __FILE__, __LINE__); continue; }
  164. #define CARLA_SAFE_ASSERT_RETURN(cond, ret) if (! (cond)) { carla_safe_assert(#cond, __FILE__, __LINE__); return ret; }
  165. #define CARLA_CUSTOM_SAFE_ASSERT(msg, cond) if (! (cond)) carla_custom_safe_assert(msg, #cond, __FILE__, __LINE__);
  166. #define CARLA_CUSTOM_SAFE_ASSERT_BREAK(msg, cond) if (! (cond)) { carla_custom_safe_assert(msg, #cond, __FILE__, __LINE__); break; }
  167. #define CARLA_CUSTOM_SAFE_ASSERT_CONTINUE(msg, cond) if (! (cond)) { carla_custom_safe_assert(msg, #cond, __FILE__, __LINE__); continue; }
  168. #define CARLA_CUSTOM_SAFE_ASSERT_RETURN(msg, cond, ret) if (! (cond)) { carla_custom_safe_assert(msg, #cond, __FILE__, __LINE__); return ret; }
  169. #define CARLA_CUSTOM_SAFE_ASSERT_ONCE_BREAK(msg, cond) if (! (cond)) { static bool _p; if (!_p) { _p = true; carla_custom_safe_assert(msg, #cond, __FILE__, __LINE__); } break; }
  170. #define CARLA_CUSTOM_SAFE_ASSERT_ONCE_CONTINUE(msg, cond) if (! (cond)) { static bool _p; if (!_p) { _p = true; carla_custom_safe_assert(msg, #cond, __FILE__, __LINE__); } continue; }
  171. #define CARLA_CUSTOM_SAFE_ASSERT_ONCE_RETURN(msg, cond, ret) if (! (cond)) { static bool _p; if (!_p) { _p = true; carla_custom_safe_assert(msg, #cond, __FILE__, __LINE__); } return ret; }
  172. #define CARLA_SAFE_ASSERT_INT_BREAK(cond, value) if (! (cond)) { carla_safe_assert_int(#cond, __FILE__, __LINE__, static_cast<int>(value); break; }
  173. #define CARLA_SAFE_ASSERT_INT_CONTINUE(cond, value) if (! (cond)) { carla_safe_assert_int(#cond, __FILE__, __LINE__, static_cast<int>(value)); continue; }
  174. #define CARLA_SAFE_ASSERT_INT_RETURN(cond, value, ret) if (! (cond)) { carla_safe_assert_int(#cond, __FILE__, __LINE__, static_cast<int>(value)); return ret; }
  175. #define CARLA_SAFE_ASSERT_INT2_BREAK(cond, v1, v2) if (! (cond)) { carla_safe_assert_int2(#cond, __FILE__, __LINE__, static_cast<int>(v1), static_cast<int>(v2)); break; }
  176. #define CARLA_SAFE_ASSERT_INT2_CONTINUE(cond, v1, v2) if (! (cond)) { carla_safe_assert_int2(#cond, __FILE__, __LINE__, static_cast<int>(v1), static_cast<int>(v2)); continue; }
  177. #define CARLA_SAFE_ASSERT_INT2_RETURN(cond, v1, v2, ret) if (! (cond)) { carla_safe_assert_int2(#cond, __FILE__, __LINE__, static_cast<int>(v1), static_cast<int>(v2)); return ret; }
  178. #define CARLA_SAFE_ASSERT_UINT_BREAK(cond, value) if (! (cond)) { carla_safe_assert_uint(#cond, __FILE__, __LINE__, static_cast<uint>(value); break; }
  179. #define CARLA_SAFE_ASSERT_UINT_CONTINUE(cond, value) if (! (cond)) { carla_safe_assert_uint(#cond, __FILE__, __LINE__, static_cast<uint>(value)); continue; }
  180. #define CARLA_SAFE_ASSERT_UINT_RETURN(cond, value, ret) if (! (cond)) { carla_safe_assert_uint(#cond, __FILE__, __LINE__, static_cast<uint>(value)); return ret; }
  181. #define CARLA_SAFE_ASSERT_UINT2_BREAK(cond, v1, v2) if (! (cond)) { carla_safe_assert_uint2(#cond, __FILE__, __LINE__, static_cast<uint>(v1), static_cast<uint>(v2)); break; }
  182. #define CARLA_SAFE_ASSERT_UINT2_CONTINUE(cond, v1, v2) if (! (cond)) { carla_safe_assert_uint2(#cond, __FILE__, __LINE__, static_cast<uint>(v1), static_cast<uint>(v2)); continue; }
  183. #define CARLA_SAFE_ASSERT_UINT2_RETURN(cond, v1, v2, ret) if (! (cond)) { carla_safe_assert_uint2(#cond, __FILE__, __LINE__, static_cast<uint>(v1), static_cast<uint>(v2)); return ret; }
  184. #if defined(__GNUC__) && defined(CARLA_PROPER_CPP11_SUPPORT) && ! defined(__clang__)
  185. # define CARLA_CATCH_UNWIND catch (abi::__forced_unwind&) { throw; }
  186. # if __GNUC__ >= 6
  187. # pragma GCC diagnostic push
  188. # pragma GCC diagnostic ignored "-Wterminate"
  189. # endif
  190. #else
  191. # define CARLA_CATCH_UNWIND
  192. #endif
  193. /* Define CARLA_SAFE_EXCEPTION */
  194. #define CARLA_SAFE_EXCEPTION(msg) CARLA_CATCH_UNWIND catch(...) { carla_safe_exception(msg, __FILE__, __LINE__); }
  195. #define CARLA_SAFE_EXCEPTION_BREAK(msg) CARLA_CATCH_UNWIND catch(...) { carla_safe_exception(msg, __FILE__, __LINE__); break; }
  196. #define CARLA_SAFE_EXCEPTION_CONTINUE(msg) CARLA_CATCH_UNWIND catch(...) { carla_safe_exception(msg, __FILE__, __LINE__); continue; }
  197. #define CARLA_SAFE_EXCEPTION_RETURN(msg, ret) CARLA_CATCH_UNWIND catch(...) { carla_safe_exception(msg, __FILE__, __LINE__); return ret; }
  198. /* Define CARLA_DECLARE_NON_COPY_CLASS */
  199. #ifdef CARLA_PROPER_CPP11_SUPPORT
  200. # define CARLA_DECLARE_NON_COPY_CLASS(ClassName) \
  201. private: \
  202. ClassName(ClassName&) = delete; \
  203. ClassName(const ClassName&) = delete; \
  204. ClassName& operator=(ClassName&) = delete; \
  205. ClassName& operator=(const ClassName&) = delete;
  206. #else
  207. # define CARLA_DECLARE_NON_COPY_CLASS(ClassName) \
  208. private: \
  209. ClassName(ClassName&); \
  210. ClassName(const ClassName&); \
  211. ClassName& operator=(ClassName&); \
  212. ClassName& operator=(const ClassName&);
  213. #endif
  214. /* Define CARLA_DECLARE_NON_COPY_STRUCT */
  215. #ifdef CARLA_PROPER_CPP11_SUPPORT
  216. # define CARLA_DECLARE_NON_COPY_STRUCT(StructName) \
  217. StructName(StructName&) = delete; \
  218. StructName(const StructName&) = delete; \
  219. StructName& operator=(StructName&) = delete; \
  220. StructName& operator=(const StructName&) = delete;
  221. #else
  222. # define CARLA_DECLARE_NON_COPY_STRUCT(StructName)
  223. #endif
  224. /* Define CARLA_PREVENT_HEAP_ALLOCATION */
  225. #ifdef CARLA_PROPER_CPP11_SUPPORT
  226. # define CARLA_PREVENT_HEAP_ALLOCATION \
  227. private: \
  228. static void* operator new(std::size_t) = delete; \
  229. static void operator delete(void*) = delete;
  230. #else
  231. # define CARLA_PREVENT_HEAP_ALLOCATION \
  232. private: \
  233. static void* operator new(std::size_t); \
  234. static void operator delete(void*);
  235. #endif
  236. /* Define CARLA_PREVENT_VIRTUAL_HEAP_ALLOCATION */
  237. #ifdef CARLA_PROPER_CPP11_SUPPORT
  238. # define CARLA_PREVENT_VIRTUAL_HEAP_ALLOCATION \
  239. private: \
  240. static void* operator new(std::size_t) = delete;
  241. #else
  242. # define CARLA_PREVENT_VIRTUAL_HEAP_ALLOCATION \
  243. private: \
  244. static void* operator new(std::size_t);
  245. #endif
  246. /* Define CARLA_API */
  247. #if defined(BUILD_BRIDGE) || defined(STATIC_PLUGIN_TARGET)
  248. # define CARLA_API
  249. #else
  250. # if defined(CARLA_OS_WIN) && ! defined(__WINE__)
  251. # ifdef BUILDING_CARLA
  252. # define CARLA_API __declspec (dllexport)
  253. # else
  254. # define CARLA_API __declspec (dllimport)
  255. # endif
  256. # else
  257. # define CARLA_API __attribute__ ((visibility("default")))
  258. # endif
  259. #endif
  260. /* Define CARLA_EXTERN_C */
  261. #ifdef __cplusplus
  262. # define CARLA_EXTERN_C extern "C"
  263. #else
  264. # define CARLA_EXTERN_C
  265. #endif
  266. /* Define CARLA_EXPORT */
  267. #ifdef BUILD_BRIDGE
  268. # define CARLA_EXPORT CARLA_EXTERN_C
  269. #else
  270. # if defined(CARLA_OS_WIN) && ! defined(__WINE__)
  271. # define CARLA_EXPORT CARLA_EXTERN_C CARLA_API
  272. # else
  273. # define CARLA_EXPORT CARLA_EXTERN_C CARLA_API
  274. # endif
  275. #endif
  276. /* Define CARLA_OS_SEP */
  277. #ifdef CARLA_OS_WIN
  278. # define CARLA_OS_SEP '\\'
  279. # define CARLA_OS_SEP_STR "\\"
  280. # define CARLA_OS_SPLIT ';'
  281. # define CARLA_OS_SPLIT_STR ";"
  282. #else
  283. # define CARLA_OS_SEP '/'
  284. # define CARLA_OS_SEP_STR "/"
  285. # define CARLA_OS_SPLIT ':'
  286. # define CARLA_OS_SPLIT_STR ":"
  287. #endif
  288. /* Useful typedefs */
  289. typedef unsigned char uchar;
  290. typedef unsigned long int ulong;
  291. typedef unsigned short int ushort;
  292. typedef unsigned int uint;
  293. #endif /* CARLA_DEFINES_H_INCLUDED */