/* Simple Plugin API * * Copyright © 2018 Wim Taymans * * Permission is hereby granted, free of charge, to any person obtaining a * copy of this software and associated documentation files (the "Software"), * to deal in the Software without restriction, including without limitation * the rights to use, copy, modify, merge, publish, distribute, sublicense, * and/or sell copies of the Software, and to permit persons to whom the * Software is furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice (including the next * paragraph) shall be included in all copies or substantial portions of the * Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER * DEALINGS IN THE SOFTWARE. */ #ifndef SPA_UTILS_DEFS_H #define SPA_UTILS_DEFS_H #ifdef __cplusplus extern "C" { #else #include #endif #include #include #include #include #include #define SPA_FLAG_MASK(field,mask,flag) (((field) & (mask)) == (flag)) #define SPA_FLAG_CHECK(field,flag) SPA_FLAG_MASK(field,flag,flag) #define SPA_FLAG_SET(field,flag) ((field) |= (flag)) #define SPA_FLAG_UNSET(field,flag) ((field) &= ~(flag)) enum spa_direction { SPA_DIRECTION_INPUT = 0, SPA_DIRECTION_OUTPUT = 1, }; #define SPA_DIRECTION_REVERSE(d) ((d) ^ 1) #define SPA_RECTANGLE(width,height) (struct spa_rectangle){ width, height } struct spa_rectangle { uint32_t width; uint32_t height; }; #define SPA_POINT(x,y) (struct spa_point){ x, y } struct spa_point { int32_t x; int32_t y; }; #define SPA_REGION(x,y,width,height) (struct spa_region){ SPA_POINT(x,y), SPA_RECTANGLE(width,height) } struct spa_region { struct spa_point position; struct spa_rectangle size; }; #define SPA_FRACTION(num,denom) (struct spa_fraction){ num, denom } struct spa_fraction { uint32_t num; uint32_t denom; }; struct spa_param_info { uint32_t id; #define SPA_PARAM_INFO_SERIAL (1<<0) /**< bit to signal update even when the * read/write flags don't change */ #define SPA_PARAM_INFO_READ (1<<1) #define SPA_PARAM_INFO_WRITE (1<<2) #define SPA_PARAM_INFO_READWRITE (SPA_PARAM_INFO_WRITE|SPA_PARAM_INFO_READ) uint32_t flags; uint32_t padding[6]; }; #define SPA_PARAM_INFO(id,flags) (struct spa_param_info){ (id), (flags) } #define SPA_N_ELEMENTS(arr) (sizeof(arr) / sizeof((arr)[0])) #define SPA_MIN(a,b) \ ({ \ __typeof__(a) _a = (a); \ __typeof__(b) _b = (b); \ SPA_LIKELY(_a < _b) ? _a : _b; \ }) #define SPA_MAX(a,b) \ ({ \ __typeof__(a) _a = (a); \ __typeof__(b) _b = (b); \ SPA_LIKELY(_a > _b) ? _a : _b; \ }) #define SPA_CLAMP(v,low,high) \ ({ \ __typeof__(v) _v = (v); \ __typeof__(low) _low = (low); \ __typeof__(high) _high = (high); \ SPA_MIN(SPA_MAX(_v, _low), _high); \ }) #define SPA_SWAP(a,b) \ ({ \ __typeof__(a) _t = (a); \ a = b; b = _t; \ }) #define SPA_TYPECHECK(type,x) \ ({ type _dummy; \ typeof(x) _dummy2; \ (void)(&_dummy == &_dummy2); \ x; \ }) #define SPA_MEMBER(b,o,t) ((t*)((uint8_t*)(b) + (int)(o))) #define SPA_MEMBER_ALIGN(b,o,a,t) SPA_PTR_ALIGN(SPA_MEMBER(b,o,t),a,t) #define SPA_CONTAINER_OF(p,t,m) (t*)((uint8_t*)p - offsetof (t,m)) #define SPA_PTRDIFF(p1,p2) ((uint8_t*)(p1) - (uint8_t*)(p2)) #define SPA_PTR_TO_INT(p) ((int) ((intptr_t) (p))) #define SPA_INT_TO_PTR(u) ((void*) ((intptr_t) (u))) #define SPA_PTR_TO_UINT32(p) ((uint32_t) ((uintptr_t) (p))) #define SPA_UINT32_TO_PTR(u) ((void*) ((uintptr_t) (u))) #define SPA_TIME_INVALID ((int64_t)INT64_MIN) #define SPA_IDX_INVALID ((unsigned int)-1) #define SPA_ID_INVALID ((uint32_t)0xffffffff) #define SPA_NSEC_PER_SEC (1000000000ll) #define SPA_NSEC_PER_MSEC (1000000ll) #define SPA_NSEC_PER_USEC (1000ll) #define SPA_USEC_PER_SEC (1000000ll) #define SPA_USEC_PER_MSEC (1000ll) #define SPA_MSEC_PER_SEC (1000ll) #define SPA_TIMESPEC_TO_NSEC(ts) ((ts)->tv_sec * SPA_NSEC_PER_SEC + (ts)->tv_nsec) #define SPA_TIMESPEC_TO_USEC(ts) ((ts)->tv_sec * SPA_USEC_PER_SEC + (ts)->tv_nsec / SPA_NSEC_PER_USEC) #define SPA_TIMEVAL_TO_NSEC(tv) ((tv)->tv_sec * SPA_NSEC_PER_SEC + (tv)->tv_usec * SPA_NSEC_PER_USEC) #define SPA_TIMEVAL_TO_USEC(tv) ((tv)->tv_sec * SPA_USEC_PER_SEC + (tv)->tv_usec) #ifdef __GNUC__ #define SPA_PRINTF_FUNC(fmt, arg1) __attribute__((format(printf, fmt, arg1))) #define SPA_ALIGNED(align) __attribute__((aligned(align))) #define SPA_DEPRECATED __attribute__ ((deprecated)) #define SPA_EXPORT __attribute__((visibility("default"))) #define SPA_SENTINEL __attribute__((__sentinel__)) #else #define SPA_PRINTF_FUNC(fmt, arg1) #define SPA_ALIGNED(align) #define SPA_DEPRECATED #define SPA_EXPORT #define SPA_SENTINEL #endif #if defined(__STDC_VERSION__) && __STDC_VERSION__ >= 199901L #define SPA_RESTRICT restrict #elif defined(__GNUC__) && __GNUC__ >= 4 #define SPA_RESTRICT __restrict__ #else #define SPA_RESTRICT #endif #define SPA_ROUND_DOWN_N(num,align) ((num) & ~((align) - 1)) #define SPA_ROUND_UP_N(num,align) SPA_ROUND_DOWN_N((num) + ((align) - 1),align) #define SPA_PTR_ALIGNMENT(p,align) ((intptr_t)(p) & ((align)-1)) #define SPA_IS_ALIGNED(p,align) (SPA_PTR_ALIGNMENT(p,align) == 0) #define SPA_PTR_ALIGN(p,align,type) (type*)SPA_ROUND_UP_N((intptr_t)(p), (intptr_t)(align)) #ifndef SPA_LIKELY #ifdef __GNUC__ #define SPA_LIKELY(x) (__builtin_expect(!!(x),1)) #define SPA_UNLIKELY(x) (__builtin_expect(!!(x),0)) #else #define SPA_LIKELY(x) (x) #define SPA_UNLIKELY(x) (x) #endif #endif #define SPA_STRINGIFY_1(x...) #x #define SPA_STRINGIFY(x...) SPA_STRINGIFY_1(x) #define spa_return_if_fail(expr) \ do { \ if (SPA_UNLIKELY(!(expr))) \ return; \ } while(false) #define spa_return_val_if_fail(expr, val) \ do { \ if (SPA_UNLIKELY(!(expr))) \ return (val); \ } while(false) /* spa_assert_se() is an assert which guarantees side effects of x, * i.e. is never optimized away, regardless of NDEBUG or FASTPATH. */ #define spa_assert_se(expr) \ do { \ if (SPA_UNLIKELY(!(expr))) \ fprintf(stderr, "'%s' failed at %s:%u %s()", \ #expr , __FILE__, __LINE__, __func__); \ abort(); \ } while (false) #define spa_assert(expr) \ do { \ if (SPA_UNLIKELY(!(expr))) { \ fprintf(stderr, "'%s' failed at %s:%u %s()", \ #expr , __FILE__, __LINE__, __func__); \ abort(); \ } \ } while (false) #define spa_assert_not_reached() \ do { \ fprintf(stderr, "Code should not be reached at %s:%u %s()", \ __FILE__, __LINE__, __func__); \ abort(); \ } while (false) /* Does exactly nothing */ #define spa_nop() do {} while (false) #define spa_memzero(x,l) (memset((x), 0, (l))) #define spa_zero(x) (spa_memzero(&(x), sizeof(x))) #define spa_strerror(err) \ ({ \ int _err = -err; \ if (SPA_RESULT_IS_ASYNC(err)) \ _err = EINPROGRESS; \ strerror(_err); \ }) #ifdef SPA_DEBUG_MEMCPY #define spa_memcpy(d,s,n) \ ({ \ fprintf(stderr, "%s:%u %s() memcpy(%p, %p, %zd)\n", \ __FILE__, __LINE__, __func__, (d), (s), (size_t)(n)); \ memcpy(d,s,n); \ }) #else #define spa_memcpy(d,s,n) memcpy(d,s,n) #endif #ifdef __cplusplus } /* extern "C" */ #endif #endif /* SPA_UTILS_DEFS_H */