/******************************************************************************** * * * D o u b l e - P r e c i s i o n 3 - E l e m e n t V e c t o r * * * ********************************************************************************* * Copyright (C) 1994,2024 by Jeroen van der Zijp. All Rights Reserved. * ********************************************************************************* * This library 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 Foundation; either version 3 of the License, or * * (at your option) any later version. * * * * This library 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 Lesser General Public License for more details. * * * * You should have received a copy of the GNU Lesser General Public License * * along with this program. If not, see * ********************************************************************************/ #ifndef FXVEC3D_H #define FXVEC3D_H namespace FX { /// Double-precision 3-element vector class FXAPI FXVec3d { public: FXdouble x; FXdouble y; FXdouble z; public: /// Default constructor; value is not initialized FXVec3d(){} /// Initialize from 2-vector FXVec3d(const FXVec2d& v,FXdouble s=0.0):x(v.x),y(v.y),z(s){} /// Initialize from another vector FXVec3d(const FXVec3d& v):x(v.x),y(v.y),z(v.z){} /// Initialize from array of doubles FXVec3d(const FXdouble v[]):x(v[0]),y(v[1]),z(v[2]){} /// Initialize from components FXVec3d(FXdouble xx,FXdouble yy,FXdouble zz):x(xx),y(yy),z(zz){} /// Return a non-const reference to the ith element FXdouble& operator[](FXint i){return (&x)[i];} /// Return a const reference to the ith element const FXdouble& operator[](FXint i) const {return (&x)[i];} /// Assignment FXVec3d& operator=(const FXVec3d& v){x=v.x;y=v.y;z=v.z;return *this;} /// Assignment from array of doubles FXVec3d& operator=(const FXdouble v[]){x=v[0];y=v[1];z=v[2];return *this;} /// Set value from another vector FXVec3d& set(const FXVec3d& v){x=v.x;y=v.y;z=v.z;return *this;} /// Set from array of doubles FXVec3d& set(const FXdouble v[]){x=v[0];y=v[1];z=v[2];return *this;} /// Set value from components FXVec3d& set(FXdouble xx,FXdouble yy,FXdouble zz){x=xx;y=yy;z=zz;return *this;} /// Assigning operators FXVec3d& operator*=(FXdouble n){ return set(x*n,y*n,z*n); } FXVec3d& operator/=(FXdouble n){ return set(x/n,y/n,z/n); } /// Element-wise assigning operators FXVec3d& operator+=(const FXVec3d& v){ return set(x+v.x,y+v.y,z+v.z); } FXVec3d& operator-=(const FXVec3d& v){ return set(x-v.x,y-v.y,z-v.z); } FXVec3d& operator%=(const FXVec3d& v){ return set(x*v.x,y*v.y,z*v.z); } /// Cross product assigning operator FXVec3d& operator^=(const FXVec3d& v){ return set(y*v.z-z*v.y,z*v.x-x*v.z,x*v.y-y*v.x); } /// Conversions operator FXdouble*(){return &x;} operator const FXdouble*() const {return &x;} operator FXVec2d&(){return *reinterpret_cast(this);} operator const FXVec2d&() const {return *reinterpret_cast(this);} /// Test if zero FXbool operator!() const { return x==0.0 && y==0.0 && z==0.0; } /// Unary FXVec3d operator+() const { return *this; } FXVec3d operator-() const { return FXVec3d(-x,-y,-z); } /// Length and square of length FXdouble length2() const { return z*z+y*y+x*x; } FXdouble length() const { return Math::sqrt(length2()); } /// Destructor ~FXVec3d(){} }; /// Dot product static inline FXdouble operator*(const FXVec3d& a,const FXVec3d& b){ return a.x*b.x+a.y*b.y+a.z*b.z; } /// Cross product static inline FXVec3d operator^(const FXVec3d& a,const FXVec3d& b){ return FXVec3d(a.y*b.z-a.z*b.y, a.z*b.x-a.x*b.z, a.x*b.y-a.y*b.x); } /// Scaling static inline FXVec3d operator*(const FXVec3d& a,FXdouble n){return FXVec3d(a.x*n,a.y*n,a.z*n);} static inline FXVec3d operator*(FXdouble n,const FXVec3d& a){return FXVec3d(n*a.x,n*a.y,n*a.z);} static inline FXVec3d operator/(const FXVec3d& a,FXdouble n){return FXVec3d(a.x/n,a.y/n,a.z/n);} static inline FXVec3d operator/(FXdouble n,const FXVec3d& a){return FXVec3d(n/a.x,n/a.y,n/a.z);} /// Vector and vector addition static inline FXVec3d operator+(const FXVec3d& a,const FXVec3d& b){ return FXVec3d(a.x+b.x,a.y+b.y,a.z+b.z); } static inline FXVec3d operator-(const FXVec3d& a,const FXVec3d& b){ return FXVec3d(a.x-b.x,a.y-b.y,a.z-b.z); } /// Element-wise multiply and divide static inline FXVec3d operator%(const FXVec3d& a,const FXVec3d& b){ return FXVec3d(a.x*b.x,a.y*b.y,a.z*b.z); } static inline FXVec3d operator/(const FXVec3d& a,const FXVec3d& b){ return FXVec3d(a.x/b.x,a.y/b.y,a.z/b.z); } /// Equality tests static inline FXbool operator==(const FXVec3d& a,FXdouble n){return a.x==n && a.y==n && a.z==n;} static inline FXbool operator!=(const FXVec3d& a,FXdouble n){return a.x!=n || a.y!=n || a.z!=n;} static inline FXbool operator==(FXdouble n,const FXVec3d& a){return n==a.x && n==a.y && n==a.z;} static inline FXbool operator!=(FXdouble n,const FXVec3d& a){return n!=a.x || n!=a.y || n!=a.z;} /// Equality tests static inline FXbool operator==(const FXVec3d& a,const FXVec3d& b){ return a.x==b.x && a.y==b.y && a.z==b.z; } static inline FXbool operator!=(const FXVec3d& a,const FXVec3d& b){ return a.x!=b.x || a.y!=b.y || a.z!=b.z; } /// Inequality tests static inline FXbool operator<(const FXVec3d& a,FXdouble n){return a.x(const FXVec3d& a,FXdouble n){return a.x>n && a.y>n && a.z>n;} static inline FXbool operator>=(const FXVec3d& a,FXdouble n){return a.x>=n && a.y>=n && a.z>=n;} /// Inequality tests static inline FXbool operator<(FXdouble n,const FXVec3d& a){return n(FXdouble n,const FXVec3d& a){return n>a.x && n>a.y && n>a.z;} static inline FXbool operator>=(FXdouble n,const FXVec3d& a){return n>=a.x && n>=a.y && n>=a.z;} /// Inequality tests static inline FXbool operator<(const FXVec3d& a,const FXVec3d& b){ return a.x(const FXVec3d& a,const FXVec3d& b){ return a.x>b.x && a.y>b.y && a.z>b.z; } static inline FXbool operator>=(const FXVec3d& a,const FXVec3d& b){ return a.x>=b.x && a.y>=b.y && a.z>=b.z; } /// Lowest components static inline FXVec3d lo(const FXVec3d& a,const FXVec3d& b){return FXVec3d(Math::fmin(a.x,b.x),Math::fmin(a.y,b.y),Math::fmin(a.z,b.z));} static inline FXVec3d lo(const FXVec3d& a,FXdouble n){return FXVec3d(Math::fmin(a.x,n),Math::fmin(a.y,n),Math::fmin(a.z,n));} static inline FXVec3d lo(FXdouble n,const FXVec3d& b){return FXVec3d(Math::fmin(n,b.x),Math::fmin(n,b.y),Math::fmin(n,b.z));} /// Highest components static inline FXVec3d hi(const FXVec3d& a,const FXVec3d& b){return FXVec3d(Math::fmax(a.x,b.x),Math::fmax(a.y,b.y),Math::fmax(a.z,b.z));} static inline FXVec3d hi(const FXVec3d& a,FXdouble n){return FXVec3d(Math::fmax(a.x,n),Math::fmax(a.y,n),Math::fmax(a.z,n));} static inline FXVec3d hi(FXdouble n,const FXVec3d& b){return FXVec3d(Math::fmax(n,b.x),Math::fmax(n,b.y),Math::fmax(n,b.z));} /// Clamp components of vector between lower and upper limits static inline FXVec3d clamp(FXdouble lower,const FXVec3d& x,FXdouble upper){return hi(lo(x,upper),lower);} /// Clamp components of vector to [-limit...limit] static inline FXVec3d clamp(const FXVec3d& x,FXdouble limit){return hi(lo(x,limit),-limit);} /// Clamp components of vector between lower corner and upper corner static inline FXVec3d clamp(const FXVec3d& lower,const FXVec3d& x,const FXVec3d& upper){return hi(lo(x,upper),lower);} /// Clamp components of vector to [-limit...limit] corners static inline FXVec3d clamp(const FXVec3d& x,const FXVec3d& limit){return hi(lo(x,limit),-limit);} /// Return vector of absolute value of each element static inline FXVec3d abs(const FXVec3d& a){return FXVec3d(Math::fabs(a.x),Math::fabs(a.y),Math::fabs(a.z));} /// Return maximum component of vector static inline FXdouble max(const FXVec3d& a){ return Math::fmax(Math::fmax(a.x,a.y),a.z); } /// Return minimum component of vector static inline FXdouble min(const FXVec3d& a){ return Math::fmin(Math::fmin(a.x,a.y),a.z); } /// Linearly interpolate static inline FXVec3d lerp(const FXVec3d& u,const FXVec3d& v,FXdouble f){return (v-u)*f+u;} /// Convert vector to color extern FXAPI FXColor colorFromVec3d(const FXVec3d& vec); /// Convert color to vector extern FXAPI FXVec3d colorToVec3d(FXColor clr); /// Compute normal from three points a,b,c extern FXAPI FXVec3d normal(const FXVec3d& a,const FXVec3d& b,const FXVec3d& c); /// Compute approximate normal from four points a,b,c,d extern FXAPI FXVec3d normal(const FXVec3d& a,const FXVec3d& b,const FXVec3d& c,const FXVec3d& d); /// Normalize vector extern FXAPI FXVec3d normalize(const FXVec3d& v); /// Return vector orthogonal to v extern FXAPI FXVec3d orthogonal(const FXVec3d& v); /// Rotate vector vec by unit-length axis about angle specified as (ca,sa) extern FXAPI FXVec3d rotate(const FXVec3d& vec,const FXVec3d& axis,FXdouble ca,FXdouble sa); /// Rotate vector vec by unit-length axis about angle ang extern FXAPI FXVec3d rotate(const FXVec3d& vec,const FXVec3d& axis,FXdouble ang); /// Compute distance of point pnt from ray from org along direction dir extern FXAPI FXdouble distFromRay(const FXVec3d& org,const FXVec3d& dir,const FXVec3d& pnt); /// Save vector to a stream extern FXAPI FXStream& operator<<(FXStream& store,const FXVec3d& v); /// Load vector from a stream extern FXAPI FXStream& operator>>(FXStream& store,FXVec3d& v); } #endif