#pragma once #include #include namespace rack { /** Abstraction of byte-aligned values for SIMD CPU acceleration. */ namespace simd { /** Generic class for vector types. This class is designed to be used just like you use scalars, with extra features for handling bitwise logic, conditions, loading, and storing. Usage example: float a[4], b[4]; float_4 a = float_4::load(in); float_4 b = 2.f * a / (1 - a); b *= sin(2 * M_PI * a); b.store(out); */ template struct Vector; /** Wrapper for `__m128` representing an aligned vector of 4 single-precision float values. */ template <> struct Vector { typedef float type; constexpr static int size = 4; union { __m128 v; /** Accessing this array of scalars is slow and defeats the purpose of vectorizing. */ float s[4]; }; /** Constructs an uninitialized vector. */ Vector() = default; /** Constructs a vector from a native `__m128` type. */ Vector(__m128 v) : v(v) {} /** Constructs a vector with all elements set to `x`. */ Vector(float x) { v = _mm_set1_ps(x); } /** Constructs a vector from four scalars. */ Vector(float x1, float x2, float x3, float x4) { v = _mm_setr_ps(x1, x2, x3, x4); } /** Returns a vector initialized to zero. */ static Vector zero() { return Vector(); } /** Returns a vector with all 1 bits. */ static Vector mask() { return _mm_castsi128_ps(_mm_cmpeq_epi32(_mm_setzero_si128(), _mm_setzero_si128())); } /** Reads an array of 4 values. On little-endian machines (e.g. x86), the order is reversed, so `x[0]` corresponds to `vector.s[3]`. */ static Vector load(const float* x) { /* My benchmarks show that _mm_loadu_ps() performs equally as fast as _mm_load_ps() when data is actually aligned. This post seems to agree. https://stackoverflow.com/a/20265193/272642 So use _mm_loadu_ps() for generality, so you can load unaligned arrays using the same function (although it will be slower). */ return Vector(_mm_loadu_ps(x)); } /** Writes an array of 4 values. On little-endian machines (e.g. x86), the order is reversed, so `x[0]` corresponds to `vector.s[3]`. */ void store(float* x) { _mm_storeu_ps(x, v); } float& operator[](int i) { return s[i]; } const float& operator[](int i) const { return s[i]; } // Conversions Vector(Vector a); // Casts static Vector cast(Vector a); }; template <> struct Vector { typedef int32_t type; constexpr static int size = 4; union { __m128i v; int32_t s[4]; }; Vector() = default; Vector(__m128i v) : v(v) {} Vector(int32_t x) { v = _mm_set1_epi32(x); } Vector(int32_t x1, int32_t x2, int32_t x3, int32_t x4) { v = _mm_setr_epi32(x1, x2, x3, x4); } static Vector zero() { return Vector(); } static Vector mask() { return Vector(_mm_cmpeq_epi32(_mm_setzero_si128(), _mm_setzero_si128())); } static Vector load(const int32_t* x) { // HACK // Use _mm_loadu_si128() because GCC doesn't support _mm_loadu_si32() return Vector(_mm_loadu_si128((__m128i*) x)); } void store(int32_t* x) { // HACK // Use _mm_storeu_si128() because GCC doesn't support _mm_storeu_si32() _mm_storeu_si128((__m128i*) x, v); } int32_t& operator[](int i) { return s[i]; } const int32_t& operator[](int i) const { return s[i]; } Vector(Vector a); static Vector cast(Vector a); }; // Conversions and casts inline Vector::Vector(Vector a) { v = _mm_cvtepi32_ps(a.v); } inline Vector::Vector(Vector a) { v = _mm_cvtps_epi32(a.v); } inline Vector Vector::cast(Vector a) { return Vector(_mm_castsi128_ps(a.v)); } inline Vector Vector::cast(Vector a) { return Vector(_mm_castps_si128(a.v)); } // Instructions not available as operators /** `~a & b` */ inline Vector andnot(const Vector& a, const Vector& b) { return Vector(_mm_andnot_ps(a.v, b.v)); } /** Returns an integer with each bit corresponding to the most significant bit of each element. For example, `movemask(float_4::mask())` returns 0xf. */ inline int movemask(const Vector& a) { return _mm_movemask_ps(a.v); } /** Returns an integer with each bit corresponding to the most significant bit of each byte. For example, `movemask(int32_4::mask())` returns 0xffff. */ inline int movemask(const Vector& a) { return _mm_movemask_epi8(a.v); } // Operator overloads /** `a @ b` */ #define DECLARE_VECTOR_OPERATOR_INFIX(t, s, operator, func) \ inline Vector operator(const Vector &a, const Vector &b) { \ return Vector(func(a.v, b.v)); \ } /** `a @= b` */ #define DECLARE_VECTOR_OPERATOR_INCREMENT(t, s, operator, opfunc) \ inline Vector &operator(Vector &a, const Vector &b) { \ a = opfunc(a, b); \ return a; \ } DECLARE_VECTOR_OPERATOR_INFIX(float, 4, operator+, _mm_add_ps) DECLARE_VECTOR_OPERATOR_INFIX(int32_t, 4, operator+, _mm_add_epi32) DECLARE_VECTOR_OPERATOR_INFIX(float, 4, operator-, _mm_sub_ps) DECLARE_VECTOR_OPERATOR_INFIX(int32_t, 4, operator-, _mm_sub_epi32) DECLARE_VECTOR_OPERATOR_INFIX(float, 4, operator*, _mm_mul_ps) // DECLARE_VECTOR_OPERATOR_INFIX(int32_t, 4, operator*, NOT AVAILABLE IN SSE3) DECLARE_VECTOR_OPERATOR_INFIX(float, 4, operator/, _mm_div_ps) // DECLARE_VECTOR_OPERATOR_INFIX(int32_t, 4, operator/, NOT AVAILABLE IN SSE3) /* Use these to apply logic, bit masks, and conditions to elements. Boolean operators on vectors give 0x00000000 for false and 0xffffffff for true, for each vector element. Examples: Subtract 1 from value if greater than or equal to 1. x -= (x >= 1.f) & 1.f; */ DECLARE_VECTOR_OPERATOR_INFIX(float, 4, operator^, _mm_xor_ps) DECLARE_VECTOR_OPERATOR_INFIX(int32_t, 4, operator^, _mm_xor_si128) DECLARE_VECTOR_OPERATOR_INFIX(float, 4, operator&, _mm_and_ps) DECLARE_VECTOR_OPERATOR_INFIX(int32_t, 4, operator&, _mm_and_si128) DECLARE_VECTOR_OPERATOR_INFIX(float, 4, operator|, _mm_or_ps) DECLARE_VECTOR_OPERATOR_INFIX(int32_t, 4, operator|, _mm_or_si128) DECLARE_VECTOR_OPERATOR_INCREMENT(float, 4, operator+=, operator+) DECLARE_VECTOR_OPERATOR_INCREMENT(int32_t, 4, operator+=, operator+) DECLARE_VECTOR_OPERATOR_INCREMENT(float, 4, operator-=, operator-) DECLARE_VECTOR_OPERATOR_INCREMENT(int32_t, 4, operator-=, operator-) DECLARE_VECTOR_OPERATOR_INCREMENT(float, 4, operator*=, operator*) // DECLARE_VECTOR_OPERATOR_INCREMENT(int32_t, 4, operator*=, NOT AVAILABLE IN SSE3) DECLARE_VECTOR_OPERATOR_INCREMENT(float, 4, operator/=, operator/) // DECLARE_VECTOR_OPERATOR_INCREMENT(int32_t, 4, operator/=, NOT AVAILABLE IN SSE3) DECLARE_VECTOR_OPERATOR_INCREMENT(float, 4, operator^=, operator^) DECLARE_VECTOR_OPERATOR_INCREMENT(int32_t, 4, operator^=, operator^) DECLARE_VECTOR_OPERATOR_INCREMENT(float, 4, operator&=, operator&) DECLARE_VECTOR_OPERATOR_INCREMENT(int32_t, 4, operator&=, operator&) DECLARE_VECTOR_OPERATOR_INCREMENT(float, 4, operator|=, operator|) DECLARE_VECTOR_OPERATOR_INCREMENT(int32_t, 4, operator|=, operator|) DECLARE_VECTOR_OPERATOR_INFIX(float, 4, operator==, _mm_cmpeq_ps) DECLARE_VECTOR_OPERATOR_INFIX(int32_t, 4, operator==, _mm_cmpeq_epi32) DECLARE_VECTOR_OPERATOR_INFIX(float, 4, operator>=, _mm_cmpge_ps) inline Vector operator>=(const Vector& a, const Vector& b) { return Vector(_mm_cmpgt_epi32(a.v, b.v)) ^ Vector::mask(); } DECLARE_VECTOR_OPERATOR_INFIX(float, 4, operator>, _mm_cmpgt_ps) DECLARE_VECTOR_OPERATOR_INFIX(int32_t, 4, operator>, _mm_cmpgt_epi32) DECLARE_VECTOR_OPERATOR_INFIX(float, 4, operator<=, _mm_cmple_ps) inline Vector operator<=(const Vector& a, const Vector& b) { return Vector(_mm_cmplt_epi32(a.v, b.v)) ^ Vector::mask(); } DECLARE_VECTOR_OPERATOR_INFIX(float, 4, operator<, _mm_cmplt_ps) DECLARE_VECTOR_OPERATOR_INFIX(int32_t, 4, operator<, _mm_cmplt_epi32) DECLARE_VECTOR_OPERATOR_INFIX(float, 4, operator!=, _mm_cmpneq_ps) inline Vector operator!=(const Vector& a, const Vector& b) { return Vector(_mm_cmpeq_epi32(a.v, b.v)) ^ Vector::mask(); } /** `+a` */ inline Vector operator+(const Vector& a) { return a; } inline Vector operator+(const Vector& a) { return a; } /** `-a` */ inline Vector operator-(const Vector& a) { return 0.f - a; } inline Vector operator-(const Vector& a) { return 0 - a; } /** `++a` */ inline Vector& operator++(Vector& a) { a += 1.f; return a; } inline Vector& operator++(Vector& a) { a += 1; return a; } /** `--a` */ inline Vector& operator--(Vector& a) { a -= 1.f; return a; } inline Vector& operator--(Vector& a) { a -= 1; return a; } /** `a++` */ inline Vector operator++(Vector& a, int) { Vector b = a; ++a; return b; } inline Vector operator++(Vector& a, int) { Vector b = a; ++a; return b; } /** `a--` */ inline Vector operator--(Vector& a, int) { Vector b = a; --a; return b; } inline Vector operator--(Vector& a, int) { Vector b = a; --a; return b; } /** `~a` */ inline Vector operator~(const Vector& a) { return a ^ Vector::mask(); } inline Vector operator~(const Vector& a) { return a ^ Vector::mask(); } // Typedefs typedef Vector float_4; typedef Vector int32_4; } // namespace simd } // namespace rack