0. threejs源码阅读——结构概述

JavaScript019

0. threejs源码阅读——结构概述,第1张

从Git上Clone好项目后,目录结构如下:

src - 我们主要看的部分,包含了所有源码。

editor - 如果有自己做webgl webIDE的计划,可以参考一下。threejs的IDE多少年没变过了,功能很少也不太好用。

docs - 所有的教程和api文档,文件夹内有index页面可以直接本地浏览,比较方便,省的连外网了。

examples - 所有示例的源码,每个html文件的名字就是示例的名字,可以直接在本地运行。

build - 打包后的源码,一个是按module加载的,一个是整体加载的。

threejs源码中的每个类几乎都有2个文件。一个是ts文件,用来声明方法和变量,一个是js文件,用来实现。最终在打包输出的时候,都会被编译成js语法。

在本系列文章中,我们重点解读js文件中的内容,ts文件中的声明内容作为辅助,帮助我们理解每个js文件的大结构和功能。

与 Vector接口 一样,threejs也在 Matrix3.d.ts 文件中提供了一个 Matrix 接口,并且在 Matrix3 (3x3矩阵类)和 Maxtrix4 (4x4矩阵类)中实现了该接口。

我们可以看到,矩阵中的元素是用数组的方式储存的。由于不同维度的矩阵内所用的元素个数不同,所以Matrix3和Matrix4的set方法是分开声明在每个类中的。这里我们以Matrix3.set为例:

可以看到,在set时是以行优先的顺序进行传值的,也就是第一行第一个,第一行第二个,第一行第三个,第二行第一个,第二行第二个...

但是在set方法的实现中,可以看到elements数组内是以列优先的顺序进行存储的:

简单点说,这里只是 存储方式的不同 。由于大多数人都习惯以行优先的方式考虑矩阵,所以threejs中所有的文档都是以行优先的方式表示的。但如果我们想要阅读源码,就要注意到[n11, n12, n13, n21 ... n33]并不是按顺序储存在elements中。事实上如果我们按顺序读取elements中的元素并以行优先的方式组成矩阵,它将是原本矩阵的转置矩阵。

如同Vector的类型,Matrix类型中所有返回值为自身类对象的方法也是原地修改该对象。例如 Transpose转置

所有的Matrix也提供了clone和copy方法,用于深拷贝不同Matrix对象。

那么threejs中的向量与矩阵进行计算是以什么形式进行的呢?这里我们举一个例子。

在Vector3类中提供了appyMatrix3这个方法,这个方法以一个3x3的矩阵作为参数,相乘后原地修改向量的值。

如果我们将Vector3看做 三行一列的矩阵(3x1) 的话,那么就需要左乘3x3矩阵,最后得到列向量:

如果我们将Vecot3看做 一行三列的矩阵(1x3) 的话,那么就需要右乘3x3矩阵,最后得到行向量:

接下来,我们再假设一个向量

加入齐次坐标w=1,来表示三维空间中的一个点(1,2,3)

然后我们构建一个仿射变换矩阵做缩放+平移运算

即沿着xyz轴均缩放2倍,然后沿着xyz移动5个单位距离。最终结果是:

这个计算我们会使用Vector3.applyMatrix4

接下来验证一下:

控制台打印结果:

threejs中的矩阵以 行优先 的形式初始化,以 列优先 的形式储存。

threejs中的向量采用 列向量 ,与矩阵做 左乘运算 。

threejs中一个三维向量与4x4的矩阵进行运算时,会先给三维向量补充第四个值w,也就是齐次坐标,w值与矩阵的第四行有关系:

在上面的例子中,我们使用了一个缩放+平移的 仿射变换矩阵 作为例子,此时w为1。