diff --git a/modules/juce_opengl/geometry/juce_Vector3D.h b/modules/juce_opengl/geometry/juce_Vector3D.h index 75fe11315193..34bff43f6022 100644 --- a/modules/juce_opengl/geometry/juce_Vector3D.h +++ b/modules/juce_opengl/geometry/juce_Vector3D.h @@ -37,56 +37,62 @@ namespace juce //============================================================================== /** - A three-coordinate vector. +A three-coordinate vector. - @tags{OpenGL} +@tags{OpenGL} */ template class Vector3D { public: - Vector3D() noexcept : x(), y(), z() {} - Vector3D (Type xValue, Type yValue, Type zValue) noexcept : x (xValue), y (yValue), z (zValue) {} - Vector3D (const Vector3D& other) noexcept : x (other.x), y (other.y), z (other.z) {} - Vector3D& operator= (Vector3D other) noexcept { x = other.x; y = other.y; z = other.z; return *this; } - - /** Returns a vector that lies along the X axis. */ - static Vector3D xAxis() noexcept { return { (Type) 1, 0, 0 }; } - /** Returns a vector that lies along the Y axis. */ - static Vector3D yAxis() noexcept { return { 0, (Type) 1, 0 }; } - /** Returns a vector that lies along the Z axis. */ - static Vector3D zAxis() noexcept { return { 0, 0, (Type) 1 }; } - - Vector3D& operator+= (Vector3D other) noexcept { x += other.x; y += other.y; z += other.z; return *this; } - Vector3D& operator-= (Vector3D other) noexcept { x -= other.x; y -= other.y; z -= other.z; return *this; } - Vector3D& operator*= (Type scaleFactor) noexcept { x *= scaleFactor; y *= scaleFactor; z *= scaleFactor; return *this; } - Vector3D& operator/= (Type scaleFactor) noexcept { x /= scaleFactor; y /= scaleFactor; z /= scaleFactor; return *this; } - - Vector3D operator+ (Vector3D other) const noexcept { return { x + other.x, y + other.y, z + other.z }; } - Vector3D operator- (Vector3D other) const noexcept { return { x - other.x, y - other.y, z - other.z }; } - Vector3D operator* (Type scaleFactor) const noexcept { return { x * scaleFactor, y * scaleFactor, z * scaleFactor }; } - Vector3D operator/ (Type scaleFactor) const noexcept { return { x / scaleFactor, y / scaleFactor, z / scaleFactor }; } - Vector3D operator-() const noexcept { return { -x, -y, -z }; } - - /** Returns the dot-product of these two vectors. */ - Type operator* (Vector3D other) const noexcept { return x * other.x + y * other.y + z * other.z; } - - /** Returns the cross-product of these two vectors. */ - Vector3D operator^ (Vector3D other) const noexcept { return { y * other.z - z * other.y, z * other.x - x * other.z, x * other.y - y * other.x }; } - - Type length() const noexcept { return std::sqrt (lengthSquared()); } - Type lengthSquared() const noexcept { return x * x + y * y + z * z; } - - Vector3D normalised() const noexcept { return *this / length(); } - - /** Returns true if the vector is practically equal to the origin. */ - bool lengthIsBelowEpsilon() const noexcept - { - auto epsilon = std::numeric_limits::epsilon(); - return ! (x < -epsilon || x > epsilon || y < -epsilon || y > epsilon || z < -epsilon || z > epsilon); - } - - Type x, y, z; + Vector3D() noexcept : x(), y(), z() {} + Vector3D(Type xValue, Type yValue, Type zValue) noexcept : x(xValue), y(yValue), z(zValue) {} + Vector3D(const Vector3D& other) noexcept : x(other.x), y(other.y), z(other.z) {} + Vector3D& operator= (Vector3D other) noexcept { x = other.x; y = other.y; z = other.z; return *this; } + + /** Returns a vector that lies along the X axis. */ + static Vector3D xAxis() noexcept { return { (Type)1, 0, 0 }; } + /** Returns a vector that lies along the Y axis. */ + static Vector3D yAxis() noexcept { return { 0, (Type)1, 0 }; } + /** Returns a vector that lies along the Z axis. */ + static Vector3D zAxis() noexcept { return { 0, 0, (Type)1 }; } + + Vector3D& operator+= (Vector3D other) noexcept { x += other.x; y += other.y; z += other.z; return *this; } + Vector3D& operator-= (Vector3D other) noexcept { x -= other.x; y -= other.y; z -= other.z; return *this; } + Vector3D& operator*= (Type scaleFactor) noexcept { x *= scaleFactor; y *= scaleFactor; z *= scaleFactor; return *this; } + Vector3D& operator/= (Type scaleFactor) noexcept { x /= scaleFactor; y /= scaleFactor; z /= scaleFactor; return *this; } + + Vector3D operator+ (Vector3D other) const noexcept { return { x + other.x, y + other.y, z + other.z }; } + Vector3D operator- (Vector3D other) const noexcept { return { x - other.x, y - other.y, z - other.z }; } + Vector3D operator* (Type scaleFactor) const noexcept { return { x * scaleFactor, y * scaleFactor, z * scaleFactor }; } + Vector3D operator/ (Type scaleFactor) const noexcept { return { x / scaleFactor, y / scaleFactor, z / scaleFactor }; } + Vector3D operator-() const noexcept { return { -x, -y, -z }; } + + /*Multiply and divide in method to avoid using * and / operators (* is used for dot product) */ + void multiply(Vector3D other) const noexcept { x *= other.x; y *= other.y, z *= other.z; } + Vector3D multiplied(Vector3D other) const noexcept { return { x * other.x, y * other.y, z * other.z }; } + void divide(Vector3D other) const noexcept { x /= other.x; y /= other.y; z /= other.z; }; + Vector3D divided(Vector3D other) const noexcept { return { x / other.x, y / other.y, z / other.z }; } + + /** Returns the dot-product of these two vectors. */ + Type operator* (Vector3D other) const noexcept { return x * other.x + y * other.y + z * other.z; } + + /** Returns the cross-product of these two vectors. */ + Vector3D operator^ (Vector3D other) const noexcept { return { y * other.z - z * other.y, z * other.x - x * other.z, x * other.y - y * other.x }; } + + Type length() const noexcept { return std::sqrt(lengthSquared()); } + Type lengthSquared() const noexcept { return x * x + y * y + z * z; } + + Vector3D normalised() const noexcept { return *this / length(); } + + /** Returns true if the vector is practically equal to the origin. */ + bool lengthIsBelowEpsilon() const noexcept + { + auto epsilon = std::numeric_limits::epsilon(); + return !(x < -epsilon || x > epsilon || y < -epsilon || y > epsilon || z < -epsilon || z > epsilon); + } + + Type x, y, z; }; } // namespace juce