<泛> C++3D数学库设计详解 向量篇

// 注：本内容为作者原创，禁止在其他网站复述内容以及用于商业盈利，如需引用，请标明出处：http://www.cnblogs.com/lv_anchoret/

 

Preface

　　为了支持光线追踪的学习，决定写一个3D泛型数学库。

　　我采用的是windows平台以及C++Template技术

　　

　　我的库文件组织目录如下

　　--lvgm

　　----test

　　------testVec.cpp

　　----type_vec

　　------lv_vec2.h

　　------lv_vec3.h

　　------type_vec.h

　　------vec_inout.h

　　----lv_precision.h

　　----lvgm.h

Ready

　　这一篇，需要您了解C++Template的基本语法

　　　　　　需要您了解向量的运算

　　该向量库文件解释：

　　　　　　二维向量模板类

　　　　　　三维向量模板类

　　　　　　数据精度设定

　　　　　　本库提供的向量相关的默认输出形式设置文件

　　该向量库文件暂时没有四元组lv_vec4，我将在之后添加并单独写一篇进行陈述

　　该向量库能为您提供的功能：

　　　　　　对向量内部数据方便自由地调取和设定

　　　　　　向量的正负

　　　　　　向量的加减乘除

　　　　　　向量的自增自减

　　　　　　向量的索引

　　　　　　向量判等

　　　　　　向量的赋值以及复合运算赋值

　　　　　　向量的范数

　　　　　　向量的范数平方

　　　　　　向量的自身单位化

　　　　　　返回该向量的高精度单位化向量

　　　　　　向量的内积和外积运算（·、×）

　　　　　　向量判空

Design

　　由于二维和三维的设计相仿，故此处以三维为例进行描述

<1>类型相关

本类中公开定义数据值类型为模板参T，范数精度类型为经外部宏设定的类型——precision， 默认为double

　　设计问题：一开始我们可能想到在模板类里面利用宏控制数据存储精度，但你可能会遇到问题。例如：

#    ifdef HIGHPRECISION        //set the high precision 
using norm_t = long double;

#    elif(defined LOWPRECISION)    //set the low preciion
using norm_t = float;

#    else
using norm_t = double;                //default precision

#    endif                        //set precision

假设我现在有一个int的三维向量，我想要返回一个实数精度（norm_t）的单位化向量，于是我们写了一个成员函数vec3 ret_unit()const,我们在主函数中需要创建一个vec3去接收ret_unit的返回值

那么，我们两手一摊，无可奈何你可能这样做：

    vec3<？？> normal = intV.ret_unit();

你可能做不到，？？可能是vec3::norm_t 吗，显然不是，vec3是一个模板，只能先将vec3中的T特化。突然觉得，模板类中公开公布了精度类型norm_t，但是却用不上？？

　　解决方案

综合考量到其他类可能也需要精度设定，所以干脆把这设置部分代码单独出来，然后将norm_t 改名为precision，于是问题就解决了

模板类中只需要提前预处理precision文件即可进行如下简单定义：

        using norm_t = precision;

而主函数中也方便多了

    vec3 normal = intV.ret_unit();

 

<2>参数类型

我看过glm数学库的源码有一类函数是这么实现的

template 
template 
    GLM_FUNC_QUALIFIER tvec3 & tvec3::operator+=(tvec3 const & v)
    {
        this->x += static_cast(v.x);
        this->y += static_cast(v.y);
        this->z += static_cast(v.z);
        return *this;
    }

其实，意思就是它允许+=另外一种类型的向量，然后我都强转到自身类型T之后进行运算

　　解决方案

个人有一拙见，我是下面这样实现的，如果有什么漏洞请邮件或者评论留言。

我可以通过“重载”static_cast，或者进行一些操作使得vec3模板类能够实现类似内置整型之间的隐式自动类型转换

那么，我就不需要设定多个模板参在内部static_cast了。

好，我们这么做就可以了：

        template
        vec3(const vec3& vec);        //static_cast

 

我在定义构造函数的时候支持其他类型的vec3，哪里需要vec3值传递，我就调用它。

 

<3>对数据进行方便自由的操作

很多数学库貌似可以直接v.x  v.y ，很多C-struct设计，但作为C++党，用C++语言写代码，要严格遵守数据隐藏，在不失语言原则的情况下做到最方便。

1）很多库支持 v.x = 3;

于是我定义：

        inline T& x()        { return _x; }

但我还是重载了常量版本

        inline const T& x()const    { return _x; }

我希望对内部数据的修改的禁止令可以通过参数来实现，比如：

template
        inline vec3 operator/(const vec3& v1, const vec3& v2)
            {
            //the operator of / ,example 3 * 5 -> 15 , (1,2,3) * (2,3,4) -> (1/2,2/3,3/4)
            assert(v2.isnull());
            return operator/ (v1, v2);
            }

所以，我仅仅去重载v.x()的const版本，而不去禁止x()可修改

 

2）GLSL中还支持这种骚操作：v.rgb = v.gbr; or v.rg = v1.rg

我看了glm库，它暂时没有实现上述的操作支持

而GLSL库我还没研读

所以，凭着自身粗浅的技术，只能实现获取数据元组，而不能实现修改：

inline vec2 xy() { return vec2{_x, _y}; }

 

<4>运算符设计

按照C++operator普遍的设计原则，依旧是将单目和（复合）赋值运算符重载定义为成员函数，而将双目运算符定义为友元或者外部函数，在本库中采用STL设计原则，定义为命名空间内的类外函数，为了不破坏C++类的封装性

++、--等单目运算符请参见我的另外一篇专门解说运算符重载的文章

此处，我只陈述与vec3类相关的设计细节

 

关于加减法，从数学角度讲，一个向量加减一个标量是非法的，所以，本库中不支持向量和标量的加减法，对于将每一个元素加同一个值，请用偏移向量进行。

而乘法和除法则支持与标量进行运算，因为一个标量乘以一个向量，只是把向量长度延伸了，在数学上也是合法的。

 

除此之外，考虑到两个vec3对象进行乘除法，如果this是int其他是另外一个是实数的话，我觉得还是进行精度提升的好，所以有专门的重载，且应用了C++11的自动追踪返回值类型技术

 

关于%以及%=，从数学角度讲，实数并不支持%运算，只有integer才有，而在图形运算过程中，大多是实数，尽管本库不全应用于图形计算，但是%合法运算在工程项目中占得也并不多，所以，如果需要，请自行将每一个元素进行%，库设计中不会因为极小部分的应用而使库变得臃肿

 

向量范数以及单位化（标准化）

一个类型设计点：利用用户设定精度类型norm_t定义范数的值类型以及返回的标准化向量模板参。

关于向量单位化，我写了两个，一个是自身单位化，此时遵循本身类型进行，意思就是int进行单位化仍然里面的元素是int。

另一个是返回单位化向量，这个时候是实数向量。

 

我想陈述的本库相关的设计原则基本完毕。

 

TEST

测试效果：

△--****************** CONSTRUCTOR TEST ******************

 ******* ivec3 test *********
there are two ivec3s as intV{ 1,-2,3 } and intV2{ 1, }, the value of which as follows

[ 1, -2, 3 ]

[ 1, 0, 0 ]

there is a ivec2 : _2ivec{1,2}, and a integer 7 to construct a ivec3 as follows

the vec2 in front of the integer of 7: [ 1, 2, 7 ]

the number of 7 in front of vec2: [ 7, 1, 2 ]



 ******* fvec3 test **********

there is a fvec3 as fV{ 1.f,2.1f, }, the value of which as follows

[ 1, 2.1, 0 ]

there is a fvec2 : t{1.2f,}, and a value 3 to construct a ivec3 as follows

f2to3 : [ 1.2, 0, 3 ]

△--******************* FUNCTIONS TEST ********************

there is a ivec3{1, -2, 3}
the operator + or - of ivec3 as follows:

+ : [ 1, -2, 3 ]
- :[ -1, 2, -3 ]

-----------------------------------------------------------

there is a ivec3{1, -2, 3}

++ivec3:        the val of expression:[ 2, -1, 4 ]      the val of ivec3:[ 2, -1, 4 ]

ivec3++:        the val of expression:[ 1, -2, 3 ]      the val of ivec3:[ 2, -1, 4 ]

the operator of -- is the same as above

-----------------------------------------------------------

the operator[] of ivec3 as follows:

the intV[2] is 4
-----------------------------------------------------------

there are two ivec3s as intV{ 1,-2,3 } and intV2{ 1, }, the value of which as follows

intV is not equ to intV2

the operator = such that: intV2 = intV; the result as follows:
intV2 is [ 2, -1, 4 ]
intV is equ to intV2


there are two ivec3s as intV{ 1,-2,3 } and intV2{ 1, }, the value of which as follows

the operator += such that: intV += intV2, the result of which as follows:

intV is: [ 3, -1, 4 ]

the operator -= such that: intV -= intV2, the result of which as follows:

intV is: [ 2, -1, 4 ]

the value of intV is to become the original value


there are two ivec3s as intV{ 1,-2,3 } and intV2{ 2,1,3 }, the value of which as follows

the operator *= such that: intV *= intV2, the result of which as follows:

intV is: [ 4, -1, 12 ]

the operator /= such that: intV /= intV2, the result of which as follows:

intV is: [ 2, -1, 4 ]

the value of intV is to become the original value

-----------------------------------------------------------

the operator *= (number)such that: intV *= 5, the result of which as follows:

intV is: [ 10, -5, 20 ]

the operator /= (number) such that: intV /= 5, the result of which as follows:

intV is: [ 2, -1, 4 ]

the value of intV is to become the original value

the operator + 、 -、 * 、/ (ivec3 or number) is the same as above

-----------------------------------------------------------

the operator* between ivec3 and fvec3 as follows:

there is a ivec3: intV{1,-2,3}, there is a fvec3: fV{1.1f,2.3f,3.8f}, and the result of ivec3*fvec3 as follows:

res is: [ 1.1, -4.6, 11.4 ]

the result of * is up to the higher precision of both

the operator* between ivec3 and float as follows:

there is a ivec3: intV{1,-2,3}, there is a float: 3.14, and the result of ivec3*3.14 as follows:

res2 is: [ 3, -6, 9 ]

the type of ivec3 * float is not fvec3 but ivec3, and the factor is just a factor that shouldn't change the vec's precision
if you need the result's type to become fvec3,you should use static_cast(intV) * float

res3 is: [ 3.14, -6.28, 9.42 ]

the operator/ between different type is the same as above

-----------------------------------------------------------

the normal() test as follows:

there is a ivec3: intV{1,-2,3}

the Norm of intV is: 3.74166

there is a fvec3: fV{ 1.1, 2.3, 3.5}

the Norm of fV is: 4.57602

-----------------------------------------------------------

there is a ivec3: intV{0, 4, 3}

the unitization of intV is: [ 0, 0.8, 0.6 ]

-----------------------------------------------------------

there is a ivec3: intV{1,-2,3}, there is a fvec3: fV{1.1f,2.3f,3.8f}, and the result of ivec3·fvec3 as follows:

the dotval is: 7.9

crossVec is: [ -14.5, -0.5, 4.5 ]

test result

 

#define LOWPRECISION        //开启低精度
#define VEC3_OUT            //开启vec3输出

#include 
#define stds std::
#define enter stds endl << stds endl

using lvgm::ivec2;
using lvgm::ivec3;
using lvgm::fvec3;
using lvgm::fvec2;

int main()
{
    ivec3 intV{ 1,-2,3 }, intV2{ 1, }, null;
    //null.self_unitization();
    ivec3 b;
    ivec2 _2ivec{ 1,2 };
    fvec3 fV{ 1.f,2.1f, };
    stds cout << "△--****************** CONSTRUCTOR TEST ******************" << enter;
    stds cout << " ******* ivec3 test *********" << stds endl;
    stds cout << "there are two ivec3s as intV{ 1,-2,3 } and intV2{ 1, }, the value of which as follows" << enter;
    stds cout << intV << enter;
    stds cout << intV2 << enter;
    stds cout << "there is a ivec2 : _2ivec{1,2}, and a integer 7 to construct a ivec3 as follows" << enter;
    ivec3 _2to3{ _2ivec, 7 };
    stds cout << "the vec2 in front of the integer of 7: " << _2to3 << enter;
    _2to3 = ivec3{ 7, _2ivec };
    stds cout << "the number of 7 in front of vec2: " << _2to3 << enter << enter;

    stds cout << " ******* fvec3 test **********" << enter;
    stds cout << "there is a fvec3 as fV{ 1.f,2.1f, }, the value of which as follows" << enter;
    stds cout << fV << enter;
    stds cout << "there is a fvec2 : t{1.2f,}, and a value 3 to construct a ivec3 as follows" << enter;
    fvec2 t{ 1.2f };
    fvec3 f2to3{ t,3 };
    stds cout << "f2to3 : " << f2to3 << enter;

    stds cout << "△--******************* FUNCTIONS TEST ********************" << enter;
    stds cout << "there is a ivec3{1, -2, 3}" << stds endl;
    stds cout << "the operator + or - of ivec3 as follows:" << enter;
    intV = +intV;
    stds cout << "+ : " << intV << stds endl;
    intV = -intV;
    stds cout << "- :" << intV << enter;
    intV = -intV;
    stds cout << "-----------------------------------------------------------" << enter;

    stds cout << "there is a ivec3{1, -2, 3}" << enter;
    auto re = ++intV;
    stds cout << "++ivec3:    the val of expression:" << re << "\tthe val of ivec3:" << intV << enter;
    --intV;
    re = intV++;
    stds cout << "ivec3++:    the val of expression:" << re << "\tthe val of ivec3:" << intV << enter;
    stds cout << "the operator of -- is the same as above" << enter;
    stds cout << "-----------------------------------------------------------" << enter;

    stds cout << "the operator[] of ivec3 as follows:" << enter;
    stds cout << "the intV[2] is " << intV[2] << stds endl;
    //stds cout << "the intV[4] is " << intV[4] << stds endl;
    stds cout << "-----------------------------------------------------------" << enter;

    stds cout << "there are two ivec3s as intV{ 1,-2,3 } and intV2{ 1, }, the value of which as follows" << enter;
    if (intV != intV2)stds cout << "intV is not equ to intV2" << enter;
    stds cout << "the operator = such that: intV2 = intV; the result as follows:" << stds endl;
    intV2 = intV;
    stds cout << "intV2 is " << intV2 << stds endl;
    if (intV2 == intV)stds cout << "intV is equ to intV2" << enter;
    stds cout << stds endl << "there are two ivec3s as intV{ 1,-2,3 } and intV2{ 1, }, the value of which as follows" << enter;
    stds cout << "the operator += such that: intV += intV2, the result of which as follows:" << enter;
    intV2 = { 1, };
    intV += intV2;
    stds cout << "intV is: " << intV << enter;
    stds cout << "the operator -= such that: intV -= intV2, the result of which as follows:" << enter;
    intV -= intV2;
    stds cout << "intV is: " << intV << enter;
    stds cout << "the value of intV is to become the original value" << enter;
    stds cout << stds endl << "there are two ivec3s as intV{ 1,-2,3 } and intV2{ 2,1,3 }, the value of which as follows" << enter;
    stds cout << "the operator *= such that: intV *= intV2, the result of which as follows:" << enter;
    intV2 = { 2,1,3 };
    intV *= intV2;
    stds cout << "intV is: " << intV << enter;
    intV /= intV2;
    stds cout << "the operator /= such that: intV /= intV2, the result of which as follows:" << enter;
    stds cout << "intV is: " << intV << enter;
    stds cout << "the value of intV is to become the original value" << enter;

    stds cout << "-----------------------------------------------------------" << enter;

    stds cout << "the operator *= (number)such that: intV *= 5, the result of which as follows:" << enter;
    intV *= 5;
    stds cout << "intV is: " << intV << enter;
    stds cout << "the operator /= (number) such that: intV /= 5, the result of which as follows:" << enter;
    intV /= 5;
    stds cout << "intV is: " << intV << enter;
    stds cout << "the value of intV is to become the original value" << enter;
    stds cout << "the operator + 、 -、 * 、/ (ivec3 or number) is the same as above" << enter;
    stds cout << "-----------------------------------------------------------" << enter;

    stds cout << "the operator* between ivec3 and fvec3 as follows:" << enter;
    stds cout << "there is a ivec3: intV{1,-2,3}, there is a fvec3: fV{1.1f,2.3f,3.8f}, and the result of ivec3*fvec3 as follows:" << enter;
    intV = { 1,-2,3 };
    fV = { 1.1f,2.3f,3.8f };
    auto res = intV*fV;
    stds cout << "res is: " << res << enter;
    stds cout << "the result of * is up to the higher precision of both" << enter;

    stds cout << "the operator* between ivec3 and float as follows:" << enter;
    stds cout << "there is a ivec3: intV{1,-2,3}, there is a float: 3.14, and the result of ivec3*3.14 as follows:" << enter;
    intV = { 1,-2,3 };
    auto res2 = intV*3.14;
    stds cout << "res2 is: " << res2 << enter;
    stds cout << "the type of ivec3 * float is not fvec3 but ivec3, and the factor is just a factor that shouldn't change the vec's precision" << stds endl
        << "if you need the result's type to become fvec3,you should use static_cast(intV) * float" << enter;
    intV = { 1,-2,3 };
    auto res3 = (static_cast(intV))*3.14;
    stds cout << "res3 is: " << res3 << enter;
    stds cout << "the operator/ between different type is the same as above" << enter;
    stds cout << "-----------------------------------------------------------" << enter;

    stds cout << "the normal() test as follows: " << enter;
    stds cout << "there is a ivec3: intV{1,-2,3}" << enter;
    stds cout << "the Norm of intV is: " << intV.normal() << enter;
    stds cout << "there is a fvec3: fV{ 1.1, 2.3, 3.5}" << enter;
    stds cout << "the Norm of fV is: " << fV.normal() << enter;
    stds cout << "-----------------------------------------------------------" << enter;

    stds cout << "there is a ivec3: intV{0, 4, 3}" << enter;
    intV = { 0,4,3 };
    lvgm::vec3 normal = intV.ret_unitization();
    stds cout << "the unitization of intV is: " << normal << enter;
    stds cout << "-----------------------------------------------------------" << enter;

    stds cout << "there is a ivec3: intV{1,-2,3}, there is a fvec3: fV{1.1f,2.3f,3.8f}, and the result of ivec3·fvec3 as follows:" << enter;
    intV = { 1,-2,3 };
    fV = { 1.1f,2.3f,3.8f };
    lvgm::precision dotval = lvgm::dot(intV, fV);
    stds cout << "the dotval is: " << dotval << enter;
    auto crossVec = cross(intV, fV);
    stds cout << "crossVec is: " << crossVec << enter;
}

test code

 

库文件代码

/// lvgm.h

// -----------------------------------------------------
// [author]        lv
// [ time ]        2018.12 ~ 2018.12
// [brief ]        include all of the mymath's head files
// -----------------------------------------------------

#ifndef LVGM_H
#define LVGM_H

#include 

#endif  //LVGM_H

lvgm.h

 

/// precision.h

// -----------------------------------------------------
// [author]        lv
// [ time ]        2018.12 ~ 2018.12
// [brief ]        control the precision of data
// -----------------------------------------------------



#ifndef LV_PRECISION_H
#define LV_PRECISION_H


namespace lvgm
{

#    ifdef HIGHPRECISION            //set the high precision 
using precision = long double;

#    elif(defined LOWPRECISION)    //set the low preciion
using precision = float;

#    else
using precision = double;        //default precision

#    endif                        //set precision


}    //namespace lvgm

#endif        //LV_PRECISION_H

precision.h

 

/// myVec2.h

// -----------------------------------------------------
// [author]        lv
// [ time ]        2018.12 ~ 2018.12
// [brief ]        the definition of two-dimensional vector 
// -----------------------------------------------------


#ifndef LV_VEC2_H
#define LV_VEC2_H


namespace lvgm
{

template
    class vec2
        {
    public:
        using value_type = T;

        using norm_t = precision;

    public:

        template
        vec2(const vec2& vec);        //static_cast

        vec2(const T x = T(), const T y = T())noexcept;

        vec2(const vec2&);

        ~vec2() {  }

    public:
        //inline get function
        inline T& x() { return _x; }

        inline T& y() { return _y; }

        inline T& u() { return _x; }

        inline T& v() { return _y; }

        inline T& r() { return _x; }

        inline T& g() { return _y; }

        inline T& s() { return _x; }

        inline T& t() { return _y; }

        inline vec2 xy() { return vec2{_x, _y}; }

        inline vec2 yx() { return vec2{_y, _x}; }

        inline vec2 rg() { return vec2{_x, _y}; }

        inline vec2 gr() { return vec2{_y, _x}; }

        inline vec2 uv() { return vec2{_x, _y}; }

        inline vec2 vu() { return vec2{_y, _x}; }

        inline vec2 st() { return vec2{_x, _y}; }

        inline vec2 ts() { return vec2{_y, _x}; }

        inline const T& x()const { return _x; }

        inline const T& y()const { return _y; }

        inline const T& u()const { return _x; }

        inline const T& v()const { return _y; }

        inline const T& r()const { return _x; }

        inline const T& g()const { return _y; }

        inline const T& s()const { return _x; }

        inline const T& t()const { return _y; }

        //inline operator function
        inline const vec2& operator+()const;

        inline vec2 operator-()const;

        inline vec2& operator++();

        inline vec2& operator--();

        inline const vec2 operator++(int);

        inline const vec2 operator--(int);

        inline const T& operator[](const int index)const;

        inline T& operator[](const int index);

        inline vec2& operator=(const vec2& rhs);

        inline vec2& operator+=(const vec2& rhs);

        inline vec2& operator-=(const vec2& rhs);

        inline vec2& operator*=(const vec2& rhs);

        inline vec2& operator/=(const vec2& rhs);

        inline vec2& operator*=(const T factor);

        inline vec2& operator/=(const T factor);

    public:
        //return the Norm of vec2
        inline norm_t normal()const;

        inline norm_t squar()const;

        //let self become to the unit vector of vec_type
        inline void self_unitization();

        //return a non-integer three-dimensional unit vector [the type is norm_t]
        inline vec2 ret_unitization()const;

        inline bool isnull()const;

    private:
        T _x, _y;

        };

//constructor functions

    template
        vec2::vec2(const T x, const T y)noexcept
            :_x(x)
            , _y(y)
    {    }

    template
        template
        vec2::vec2(const vec2& rhs)
            :_x(static_cast(rhs.x()))
            , _y(static_cast(rhs.y()))
    {    }

    template
        vec2::vec2(const vec2& rhs)
            : _x(rhs._x)
            , _y(rhs._y)
    {    }

// Binary operator functions [non-mem]

    template
        inline vec2 operator+(const vec2& v1, const vec2& v2)
            {
            return vec2(v1[0] + v2[0], v1[1] + v2[1]);
            }

    template
        inline vec2 operator-(const vec2& v1, const vec2& v2)
            {
            //the operator of - ,example  (5,4) - (2,2) -> (3,2)  
            return v1 + (-v2);
            }

    template
        inline auto operator*(const vec2& v1, const vec2& v2)
            {
            //the operator of * ,example  (1.1, 2.1) * (2, 3) -> (2.2, 6.3)
            using type = decltype(v1[0] * v2[0]);
            return vec2((type)v1[0] * v2[0], (type)v1[1] * v2[1]);
            }

    template
        inline vec2 operator*(const vec2& v1, const vec2& v2)
            {
            //the operator of * ,example (1,2) * (2,3) -> (2,6)
            return vec2(v1[0] * v2[0], v1[1] * v2[1]);
            }

    template
        inline vec2 operator*(const vec2& v, const E factor)
            {
            return vec2(v.x() * factor, v.y() * factor);
            }

    template
        inline vec2 operator*(const E factor, const vec2& v)
            {
            return vec2(v.x() * factor, v.y() * factor);
            }

    template
        inline auto operator/(const vec2& v1, const vec2& v2)
            {
            //the operator of / ,example  (1.1, 2.1) * (2, 3) -> (0.55, 0.7)
            assert(v2.isnull());
            using type = decltype(v1[0] / v2[0]);
            return vec2((type)v1[0] / v2[0], (type)v1[1] / v2[1]);
            }

    template
        inline vec2 operator/(const vec2& v1, const vec2& v2)
            {
            //the operator of / ,example 3 * 5 -> 15 , (1,2) * (2,3) -> (1/2,2/3)
            assert(v2.isnull());
            return operator/ (v1, v2);
            }

    template
        inline vec2 operator/(const vec2& v, const E factor)
            {
            assert(factor != 0 && factor != 0.);
            return vec2(v.x() / factor, v.y() / factor);
            }

    template
        inline bool operator==(const vec2& v1, const vec2& v2)
            {
            return v1.x() == v2.x() && v1.y() == v2.y();
            }

    template
        inline bool operator!=(const vec2& v1, const vec2& v2)
            {
            return !(v1 == v2);
            }

    // Unary operator functions [mem]

    template
        inline const vec2& vec2::operator+() const
            {
            //the operator of + ,example 5 -> +5,  +(1,-2) -> (1,-2)
            return *this;
            }

    template
        inline vec2 vec2::operator-() const
            {
            //the operator of - ,example 5 -> -5,  -(1,-2) -> (-1,2)
            return vec2(-_x, -_y);
            }

    template
        inline vec2& vec2::operator++()
            {
            ++this->_x;
            ++this->_y;
            return *this;
            }

    template
        inline const vec2 vec2::operator++(int)
            {
            vec2ori(*this);
            ++*this;
            return ori;
            }

    template
        inline vec2& vec2::operator--()
            {
            --this->_x;
            --this->_y;
            return *this;
            }

    template
        inline const vec2 vec2::operator--(int)
            {
            vec2ori(*this);
            --*this;
            return ori;
            }

    template
        inline const T& vec2::operator[](const int index)const
            {
            if (index == 0)return _x;
            else if (index == 1)return _y;
            else throw "the index is error";
            }

    template
        inline T& vec2::operator[](const int index)
            {
            if (index == 0)return _x;
            else if (index == 1)return _y;
            else throw "the index is error";
            }

// member functions

    template
        inline vec2& vec2::operator=(const vec2& rhs)
            {
            if (this != &rhs)
                {
                _x = rhs._x;
                _y = rhs._y;
                }
            return *this;
            }

    template
        inline vec2& vec2::operator+=(const vec2& rhs)
            {
            this->_x += rhs._x;
            this->_y += rhs._y;
            return *this;
            }

    template
        inline vec2& vec2::operator-=(const vec2& rhs)
            {
            return *this += (-rhs);
            }

    template
        inline vec2& vec2::operator/=(const vec2& rhs)
            {
            assert(!rhs.isnull());
            this->_x /= rhs._x;
            this->_y /= rhs._y;
            return *this;
            }

    template
        inline vec2& vec2::operator*=(const vec2& rhs)
            {
            this->_x *= rhs._x;
            this->_y *= rhs._y;
            return *this;
            }

    template
        inline vec2& vec2::operator*=(const T factor)
            {
            this->_x *= factor;
            this->_y *= factor;
            return *this;
            }

    template
        inline vec2& vec2::operator/=(const T factor)
            {
            assert(factor != 0);
            this->_x /= factor;
            this->_y /= factor;
            return *this;
            }


    template
        inline typename vec2::norm_t vec2::normal()const
            {
            return sqrt(squar());
            }

    template
        inline typename vec2::norm_t vec2::squar()const
            {
            return _x*_x + _y*_y;
            }

    template
        inline void vec2::self_unitization()
            {
            *this /= normal();
            }

    template
        inline vec2 vec2::ret_unitization()const
            {
            norm_t div = normal();
            return vec2{ (norm_t)this->_x / div, (norm_t)this->_y / div, (norm_t)this->_z / div };
            }

    template
        inline auto dot(const vec2& v1, const vec2& v2) //-> decltype(v1.x() * v2.x() + v1.y() * v2.y()
            {// x1 * x2 + y1 * y2
            return v1.x() * v2.x() + v1.y() * v2.y();
            }

    template
        inline auto cross(const vec2 v1, const vec2& v2)
            {// v1 × v2
            return    v1[0] * v2[1] - v1[1] * v2[0];
            }

    template
        inline bool vec2::isnull()const
            {
            return *this == vec2();
            }

}    //namespace lvgm


#endif    //LV_VEC2_H

lv_vec2.h

 

/// myVec3.h

// -----------------------------------------------------
// [author]        lv
// [ time ]        2018.12 ~ 2018.12
// [brief ]        the definition of Three-dimensional vector
// -----------------------------------------------------

#ifndef LV_VEC3_H
#define LV_VEC3_H

namespace lvgm
{

template
    class vec3
        {
    public:
        using value_type = T;

        using norm_t = precision;

    public:

        template
        vec3(const vec3& vec);        //static_cast

        vec3(const T e1 = T(), const T e2 = T(), const T e3 = T())noexcept;

        explicit vec3(const vec2& v2, const T e3 = T())noexcept;

        explicit vec3(const T e1, const vec2& v)noexcept;

        explicit vec3(const vec3&);

        ~vec3() {  }

    public:

        inline T& x()        { return _x; }

        inline T& y()        { return _y; }

        inline T& z()        { return _z; }

        inline T& r()        { return _x; }

        inline T& g()        { return _y; }

        inline T& b()        { return _z; }

        inline vec2 xy() { return vec2{_x, _y}; }

        inline vec2 yx()    { return vec2{_y, _x}; }

        inline vec2 xz()    { return vec2{_x, _z}; }

        inline vec2 zx()    { return vec2{_z, _x}; }

        inline vec2 yz()    { return vec2{_y, _z}; }

        inline vec2 zy()    { return vec2{_z, _y}; }

        inline vec2 rg()    { return vec2{_x, _y}; }

        inline vec2 gr()    { return vec2{_y, _x}; }

        inline vec2 rb()    { return vec2{_x, _z}; }

        inline vec2 br()    { return vec2{_z, _x}; }

        inline vec2 gb()    { return vec2{_y, _z}; }

        inline vec2 bg()    { return vec2{_z, _y}; }

        inline vec3 rgb()    { return vec3{_x, _y, _z}; }

        inline vec3 rbg()    { return vec3{_x, _z, _y}; }
            
        inline vec3 gbr()    { return vec3{_y, _z, _x}; }

        inline vec3 grb()    { return vec3{_y, _x, _z}; }

        inline vec3 bgr()    { return vec3{_z, _y, _x}; }

        inline vec3 brg()    { return vec3{_z, _x, _y}; }

        inline const T& x()const    { return _x; }

        inline const T& y()const    { return _y; }

        inline const T& z()const    { return _z; }

        inline const T& r()const    { return _x; }

        inline const T& g()const    { return _y; }

        inline const T& b()const    { return _z; }

        //inline oprator function
        inline const vec3& operator+() const;

        inline vec3 operator-()const;

        inline vec3& operator++();

        inline vec3& operator--();

        inline const vec3 operator++(int);

        inline const vec3 operator--(int);

        inline const T& operator[](const int index)const;

        inline T& operator[](const int index);

        inline vec3& operator=(const vec3& rhs);

        inline vec3& operator+=(const vec3& rhs);

        inline vec3& operator-=(const vec3& rhs);

        inline vec3& operator*=(const vec3& rhs);

        inline vec3& operator/=(const vec3& rhs);

        inline vec3& operator*=(const T factor);

        inline vec3& operator/=(const T factor);
        
    public:
        //return the Norm of vec3
        inline norm_t normal()const;

        inline norm_t squar()const;

        //let self become to the unit vector of vec_type
        inline void self_unitization();

        //return a non-integer three-dimensional unit vector [the type is norm_t]
        inline vec3 ret_unitization()const;

        inline bool isnull()const;

    private:
        T _x, _y, _z;

        };

//constructor functions

    template
        template
        vec3::vec3(const vec3& vec)
            :_x(static_cast(vec.x()))
            ,_y(static_cast(vec.y()))
            ,_z(static_cast(vec.z()))
        {    }
    
    template
        vec3::vec3(const T e1, const T e2, const T e3)noexcept
            :_x{e1}
            ,_y{e2}
            ,_z{e3}
        {    }

    template
        vec3::vec3(const vec2& v, const T e3)noexcept
            :_x(v.x())
            ,_y(v.y())
            ,_z(e3)
        {    }

    template
        vec3::vec3(const T e, const vec2& v)noexcept
            :_x(e)
            ,_y(v.x())
            ,_z(v.y())
        {    }

    template
        vec3::vec3(const vec3& rhs)
            :_x{rhs._x}
            ,_y{rhs._y}
            ,_z{rhs._z}
        {    }

// Binary operator functions [non-mem]
    template
        vec3 operator+(const vec3& v1, const vec3& v2)
            {
            //the operator of + ,example  (5,4,3) + (2,-2,1) -> (7,2,4)  
            return vec3(v1[0] + v2[0], v1[1] + v2[1], v1[2] + v2[2]);
            }

    template
        inline vec3 operator-(const vec3& v1, const vec3& v2)
            {
            //the operator of - ,example  (5,4,3) - (2,2,1) -> (3,2,2)  
            return v1 + (-v2);
            }

    template
        inline auto operator*(const vec3& v1, const vec3& v2)
            {
            //the operator of * ,example  (1.1, 2.1, 3.1) * (2, 3, 4) -> (2.2, 6.3, 12.4)
            using type = decltype(v1[0] * v2[0]);
            return vec3((type)v1[0] * v2[0], (type)v1[1] * v2[1], (type)v1[2] * v2[2]);
            }

    template
        inline vec3 operator*(const vec3& v1, const vec3& v2)
            {
            //the operator of * ,example 3 * 5 -> 15 , (1,2,3) * (2,3,4) -> (2,6,12)
            return vec3(v1[0] * v2[0], v1[1] * v2[1], v1[2] * v2[2]);
            }

    template
        inline vec3 operator*(const vec3& v, const E factor)
            {
            return vec3(v.x() * factor, v.y() * factor, v.z() * factor);
            }

    template
        inline vec3 operator*(const E factor, const vec3& v)
            {
            return vec3(v.x() * factor, v.y() * factor, v.z() * factor);
            }

    template
        inline auto operator/(const vec3& v1, const vec3& v2)
            {
            //the operator of / ,example  (1.1, 2.1, 3.2) * (2, 3, 4) -> (0.55, 0.7, 0.8)
            assert(v2.isnull());
            using type = decltype(v1[0] / v2[0]);
            return vec3((type)v1[0] / v2[0], (type)v1[1] / v2[1], (type)v1[2] / v2[2]);
            }
        
    template
        inline vec3 operator/(const vec3& v1, const vec3& v2)
            {
            //the operator of / ,example 3 * 5 -> 15 , (1,2,3) * (2,3,4) -> (1/2,2/3,3/4)
            assert(v2.isnull());
            return operator/ (v1, v2);
            }

    template
        inline vec3 operator/(const vec3& v, const E factor)
            {
            assert(factor != 0 && factor != 0.);
            return vec3(v.x() / factor, v.y() / factor, v.z() / factor);
            }

    template
        inline bool operator==(const vec3& v1, const vec3& v2)
            {
            return v1.x() == v2.x() && v1.y() == v2.y() && v1.z() == v2.z();
            }

    template
        inline bool operator!=(const vec3& v1, vec3& v2)
            {
            return !(v1 == v2);
            }

// Unary operator functions [mem]
    template
        inline const vec3& vec3::operator+() const 
            {
            //the operator of + ,example 5 -> +5,  +(1,-2,3) -> (1,-2,3)
            return *this; 
            }

    template
        inline vec3 vec3::operator-() const
            {
            //the operator of - ,example 5 -> -5,  -(1,-2,3) -> (-1,2,-3)
            return vec3(-_x, -_y, -_z);
            }

    template
        inline vec3& vec3::operator++()
            {
            ++this->_x;
            ++this->_y;
            ++this->_z;
            return *this;
            }

    template
        inline const vec3 vec3::operator++(int)
            {
            vec3ori(*this);
            ++*this;
            return ori;
            }

    template
        inline vec3& vec3::operator--()
            {
            --this->_x;
            --this->_y;
            --this->_z;
            return *this;
            }

    template
        inline const vec3 vec3::operator--(int)
            {
            vec3ori(*this);
            --*this;
            return ori;
            }

    template
        inline const T& vec3::operator[](const int index)const
            {
            if (index == 0)return _x;
            else if (index == 1)return _y;
            else if (index == 2)return _z;
            else throw "the index is error";
            }

    template
        inline T& vec3::operator[](const int index)
            {
            if (index == 0)return _x;
            else if (index == 1)return _y;
            else if (index == 2)return _z;
            else throw "the index is error";
            }

// member functions
    template
        inline vec3& vec3::operator=(const vec3& rhs)
            {
            if (this != &rhs)
                {
                _x = rhs._x;
                _y = rhs._y;
                _z = rhs._z;
                }
            return *this;
            }

    template
        inline vec3& vec3::operator+=(const vec3& rhs)
            {
            this->_x += rhs._x;
            this->_y += rhs._y;
            this->_z += rhs._z;
            return *this;
            }

    template
        inline vec3& vec3::operator-=(const vec3& rhs)
            {
            this->_x -= rhs._x;
            this->_y -= rhs._y;
            this->_z -= rhs._z;
            return *this;
            }

    template
        inline vec3& vec3::operator/=(const vec3& rhs)
            {
            assert(!rhs.isnull());
            this->_x /= rhs._x;
            this->_y /= rhs._y;
            this->_z /= rhs._z;
            return *this;
            }

    template
        inline vec3& vec3::operator*=(const vec3& rhs)
            {
            this->_x *= rhs._x;
            this->_y *= rhs._y;
            this->_z *= rhs._z;
            return *this;
            }

    template
        inline vec3& vec3::operator*=(const T factor)
            {
            this->_x *= factor;
            this->_y *= factor;
            this->_z *= factor;
            return *this;
            }

    template
        inline vec3& vec3::operator/=(const T factor)
            {
            assert(factor != 0);
            this->_x /= factor;
            this->_y /= factor;
            this->_z /= factor;
            return *this;
            }

    template
        inline typename vec3::norm_t vec3::normal()const
            {
            return sqrt(squar());
            }

    template
        inline typename vec3::norm_t vec3::squar()const
            {
            return _x*_x + _y*_y + _z*_z;
            }

    template
        inline void vec3::self_unitization()
            {
            *this /= normal();
            }

    template
        inline vec3 vec3::ret_unitization()const
            {
            norm_t div = normal();
            return vec3{ (norm_t)this->_x / div,(norm_t)this->_y / div,(norm_t)this->_z / div };
            }

    template
        inline auto dot(const vec3& v1, const vec3& v2) //-> decltype(v1.x() * v2.x() + v1.y() * v2.y() + v1.z() * v2.z())
            {// x1 * x2 + y1 * y2 + z1 * z2
            return v1.x() * v2.x() + v1.y() * v2.y() + v1.z() * v2.z();
            }

    template
        inline auto cross(const vec3 v1, const vec3& v2)
            {// v1 × v2
            return vec31] * v2[2] - v1[2] * v2[1])>
                (
                v1[1] * v2[2] - v1[2] * v2[1],
                v1[2] * v2[0] - v1[0] * v2[2],
                v1[0] * v2[1] - v1[1] * v2[0]
                );
            }

    template
        inline bool vec3::isnull()const
            {
            return *this == vec3();
            }

}    //namespace lvgm

#endif    //LV_VEC3_H

lv_vec3.h

 

/// all vectors are in here

// -----------------------------------------------------
// [author]        lv
// [ time ]        2018.12 ~ 2018.12
// [brief ]        all vectors are in here
// -----------------------------------------------------


#pragma once

#include 
#include 
#include 
#include 

#include "lv_vec2.h"
#include "lv_vec3.h"
#include "vec_inout.h"

namespace lvgm
{
    template class vec2;

    template class vec3;

    template class vec4;


    typedef vec2<bool> bvec2;

    typedef vec2<char> cvec2;

    typedef vec2<short> svec2;

    typedef vec2<int> ivec2;

    typedef vec2<float> fvec2;

    typedef vec2<double> dvec2;

    typedef vec2<long double> ldvec2;


    typedef vec3<bool> bvec3;

    typedef vec3<char> cvec3;

    typedef vec3<short> svec3;

    typedef vec3<int> ivec3;

    typedef vec3<float> fvec3;

    typedef vec3<double> dvec3;

    typedef vec3<long double> ldvec3;


    typedef vec4<bool> bvec4;

    typedef vec4<char> cvec4;

    typedef vec4<short> svec4;

    typedef vec4<int> ivec4;

    typedef vec4<float> fvec4;

    typedef vec4<double> dvec4;

    typedef vec4<long double> ldvec4;
}

type_vec.h

 

///vec_inout.h

// -----------------------------------------------------
// [author]        lv
// [ time ]        2018.12 ~ 2018.12
// [brief ]        control the iostream of vec
// -----------------------------------------------------


#pragma once


# ifdef    VEC_OUT

    template
        std::ostream& operator<<(std::ostream& cout, const lvgm::vec2& v)
            {
            cout << "[ " << v.x() << ", " << v.y() << " ]";
            return cout;
            }

    template
        std::ostream& operator<<(std::ostream& cout, const lvgm::vec3& v)
            {
            cout << "[ " << v.x() << ", " << v.y() << ", " << v.z() << " ]";
            return cout;
            }

    template
        std::ostream& operator<<(std::ostream& cout, const lvgm::vec4& v)
        {
            cout << "[ " << v.x() << ", " << v.y() << ", " << v.z() << v.w() << " ]";
            return cout;
        }

#endif

# ifdef VEC2_OUT 

    template
        std::ostream& operator<<(std::ostream& cout, const lvgm::vec2& v)
            {
            cout << "[ " << v.x() << ", " << v.y() << " ]";
            return cout;
            }

#endif

# ifdef VEC3_OUT 

    template
        std::ostream& operator<<(std::ostream& cout, const lvgm::vec3& v)
            {
            cout << "[ " << v.x() << ", " << v.y() << ", " << v.z() << " ]";
            return cout;
            }

#endif

# ifdef VEC4_OUT 

    template
        std::ostream& operator<<(std::ostream& cout, const lvgm::vec4& v)
            {
            cout << "[ " << v.x() << ", " << v.y() << ", " << v.z() << v.w() << " ]";
            return cout;
            }

#endif

vec_inout.h

 

如有什么问题，请于评论区留言或者邮箱（^_^）

 

感谢您的阅读，生活愉快`