使用ArcGIS API和Three.js在三维场景中实现动态立体墙效果

废话不多说，直接先来看下最终实现的动态立体墙效果图。

如果图片还不够直观，那么点击链接查看在线示例。

首先我们需要用到ArcGIS API中的externalRenderers类将外部的Three.js渲染器加载到地图三维场景中，如果不知道怎么使用的可以查看我的这篇文章《ArcGIS API在视图中渲染Three.js场景》。那篇文章中加载的是一个三维模型，而本示例中只需加载一面“墙”，也就是一个平面，并增加一个动态效果。所以重点就是怎么加载一个垂直于地球表面的平面，以及如何实现动态效果。

1 垂直于地球表面的墙

如图所示，先确定出两个“墙角”的坐标。

let points = [[104.06179498614645, 30.659871702738265], // 坐标1[104.06494384459816, 30.659931252383917], // 坐标2
];

现在我们有了两个经纬度坐标的点，但是我们需要4个顶点才能构成一个矩形面，所以我们还需要2个点。假设2个墙角坐标贴近于地面，那么它们的高度就为0，那就再只需要2个同样经纬度坐标但高度大于0的点就能构成一个在地面上并且垂直于地面的矩形面了。所以在我们定义的myRenderer对象中添加一个height属性。

let myRenderer = {// ... 其它属性height: 100, // 墙的高度// ... 其它属性、方法
};

现在我们有4个由经纬度加高度构成的点，如果要在视图中渲染成一个矩形面，我们要先将这4个点转换为渲染坐标系中的点，再将每3个顶点为一组构成一个三角面，最后由2个三角面构成一个矩形面。这样做是因为在Three.js中所有的模型都是由顶点加三角面构成的。

1.1 顶点转换

在顶点转换之前，我们还需要做一个操作，那就是将我们的经纬度坐标转换为XY坐标。这需要用到ArcGIS API中的webMercatorUtils工具中的lngLatToXY方法，该方法将给定的经度和纬度转换为Web Mercator的XY值。

points.forEach((point) => {// 将经纬度坐标转换为xy值let pointXY = webMercatorUtils.lngLatToXY(point[0], point[1]);
});

然后需要用到Three.js的数学库中的四维矩阵Matrix4类以及ArcGIS API中externalRenderers对象上的renderCoordinateTransformAt方法将点转换为渲染坐标系中的点坐标。

let transform = new THREE.Matrix4(); // 变换矩阵
let transformation = new Array(16);
let vector3List = []; // 顶点数组
points.forEach((point) => {// 将经纬度坐标转换为xy值let pointXY = webMercatorUtils.lngLatToXY(point[0], point[1]);// 先转换高度为0的点transform.fromArray(externalRenderers.renderCoordinateTransformAt(this.view,[pointXY[0], pointXY[1], 0], // 坐标在地面上的点[x值, y值, 高度值]this.view.spatialReference,transformation));vector3List.push(new THREE.Vector3(transform.elements[12],transform.elements[13],transform.elements[14]));// 再转换距离地面高度为height的点transform.fromArray(externalRenderers.renderCoordinateTransformAt(this.view,[pointXY[0], pointXY[1], this.height], // 坐标在空中的点[x值, y值, 高度值]this.view.spatialReference,transformation));vector3List.push(new THREE.Vector3(transform.elements[12],transform.elements[13],transform.elements[14]));
});

renderCoordinateTransformAt方法的作用是计算一个4x4变换矩阵，该矩阵构成从局部笛卡尔坐标系到虚拟世界坐标系的线性坐标变换。该方法传入4个参数：
1 view，ArcGIS API生成的三维视图。
2 origin，局部笛卡尔坐标系中原点的全局坐标，也就是[经纬度转换后的X坐标, 经纬度转换后的y坐标, 高度值]。
3 srcSpatialReference，原点坐标的空间参考。
4 dest，存储16个矩阵元素的数组的引用。生成的矩阵遵循OpenGL约定，其中转换组件占据第13、14和第15个元素。

现在，vector3List变量中存储的就是每个顶点转换后的三维向量，一共为4个顶点。顺序是[第一个经纬度的地面顶点, 第一个经纬度的空中顶点, 第二个经纬度的地面顶点, 第二个经纬度的空中顶点]，这个顶点的顺序很重要，后面会用到。

1.2 生成三角面以及面的UV队列

因为Three.js中的面都是由小三角面构成的，所以我们需要根据顶点列表中的顶点来组成三角面，每三个顶点构成一个三角面，一定要注意构成三角面的的顶点顺序，因为要和面的UV队列一一对应起来，这样给每个面贴的纹理材质才能正确显示出来。
纹理贴图的坐标系统是这样的：图片左下角为原点(0, 0)，右下角为(1, 0)，右上角为(1, 1)，左上角为(0, 1)，这和图片的大小宽高无关。如下图所示：

将纹理坐标关系转换为二维向量表示。

const t0 = new THREE.Vector2(0, 0); // 图片左下角
const t1 = new THREE.Vector2(1, 0); // 图片右下角
const t2 = new THREE.Vector2(1, 1); // 图片右上角
const t3 = new THREE.Vector2(0, 1); // 图片左上角

一个简单的矩形面由4个顶点和2个小三角面构成，顶点和三角面关系如下图所示：

图中0、1、2、3序号代表vector3List变量中顶点的顺序。按照逆时针规则画出2个三角面，下三角面为绿色三角面[0, 2, 1]，上三角面为蓝色三角面[1, 2, 3]。例如，要将纹理贴图和绿色三角面映射起来，那么绿色三角面对应的UV就是[t0, t1, t3]，蓝色三角面对应的UV就是[t3, t1, t2]。

根据以上原理生成三角面列表以及UV队列。

let faceList = []; // 三角面数组
let faceVertexUvs = []; // 面的 UV 层的队列，该队列用于将纹理和几何信息进行映射for (let i = 0; i < vector3List.length - 2; i++) {if (i % 2 === 0) { // 下三角面faceList.push(new THREE.Face3(i, i + 2, i + 1));faceVertexUvs.push([t0, t1, t3]);} else { // 上三角面faceList.push(new THREE.Face3(i, i + 1, i + 2));faceVertexUvs.push([t3, t1, t2]);}
}

1.3 生成几何体

使用Three.js中的Geometry构造函数来生成自定义几何体。

const geometry = new THREE.Geometry(); // 生成几何体
geometry.vertices = vector3List; // 几何体顶点
geometry.faces = faceList; // 几何体三角面
geometry.faceVertexUvs[0] = faceVertexUvs; // 面的UV队列，用于将纹理信息映射到几何体上

geometry.faceVertexUvs的属性值为数组是因为有多组UV。颜色贴图、法线贴图、高光贴图、金属度贴图等共用一组纹理坐标UV即geometry.faceVertexUvs[0]，设置阴影的光照贴图lightMap使用另外一组纹理坐标，也就是geometry.faceVertexUvs[1]。默认情况下，geometry.faceVertexUvs属性中会存在一个元素，所以可以直接对geometry.faceVertexUvs[0]进行赋值操作。
注意：对于缓冲区类型几何体也就是通过BufferGeometry构造函数生成的几何体，是通过设置.attributes.uv和.attributes.uv2两个属性分别定义两组顶点纹理坐标。

2 实现墙的动态效果

动态效果的原理其实是纹理贴图实现的，一共两层贴图，一层颜色从上到下越来越不透明，给人一面墙的感觉，另一层从上到下越来越透明，然后每次渲染都改变第二层纹理在垂直方向上的偏移量，这样就有了滚动起来的效果。
因为当第一层半透明和第二层半透明的效果都叠加到一个几何体上时，这个几何体就会变得更加的透明，显示效果上就不是很好，所以我们把这两层效果放到两个几何体上，只需要把上面创建好的几何体克隆一遍。

const geometry2 = geometry.clone();

2.1 利用材质的alphaMap贴图实现半透明效果

我们选用基础网络材质MeshBasicMaterial，该材质不受光照的影响，所以不需要在场景中再额外的添加光源，省时省力~。该材质对象上的alphaMap贴图属性可以用来控制整个表面的不透明度，黑色完全透明，白色完全不透明。如下图所示，从上到下越来越白，也就是也来越不透明。

加载alphaMap的纹理贴图资源，创建材质，和第一个几何体生成网格，然后添加到场景中。

this.alphaMap = new THREE.TextureLoader().load( // 加载alpha贴图资源'../images/texture_1.png'
);
// 创建材质
const material = new THREE.MeshBasicMaterial({color: 0xff0000,side: THREE.DoubleSide,transparent: true, // 必须设置为true,alphaMap才有效果depthWrite: false, // 渲染此材质是否对深度缓冲区有任何影响alphaMap: this.alphaMap, // alpha贴图，控制透明度
});
const mesh = new THREE.Mesh(geometry, material); // 第一个几何体和第一个材质
this.scene.add(mesh);

注意：
side属性要设置为THREE.DoubleSide，这样才能两个面都进行绘制，也就是说从前后两个方向都能看到几何体。
transparent属性一定要设置为true，不然alphaMap贴图是没有效果的，看不出透明效果。
depthWrite属性一定要设置为false，才能正确渲染后方的半透明物体。

效果如图所示：

2.2 利用材质的map颜色贴图实现渐变半透明效果

MeshBasicMaterial材质的map属性为颜色贴图。可以设置为半透明的PNG格式图片，也就达到了透明的效果。

加载PNG格式的纹理贴图资源，创建材质，和克隆出来的几何体生成网格，然后添加到场景中。

this.texture = new THREE.TextureLoader().load('../images/texture_2.png'
);
this.texture.wrapS = THREE.RepeatWrapping; // 水平方向重复
this.texture.wrapT = THREE.RepeatWrapping; // 垂直方向重复
const material2 = new THREE.MeshBasicMaterial({side: THREE.DoubleSide,transparent: true,depthWrite: false, // 渲染此材质是否对深度缓冲区有任何影响map: this.texture, // 颜色贴图，加载PNG图片达到透明效果
});
const mesh2 = new THREE.Mesh(geometry2, material2);
this.scene.add(mesh2);

注意：
因为需要在垂直方向上存在偏移量，形成滚动的效果，所以必须设置纹理的包裹方式为重复，wrapS和wrapT属性设置为THREE.RepeatWrapping。具体可查看文档。

叠加到场景中的效果如图所示：

2.3 效果动起来

现在大体效果已经差不多了，最后只要动起来就完工了。要实现动起来的效果只需要在render函数中添加更新纹理贴图偏移量的代码，每渲染一次就更新一次偏移量。

render() {// ... 其它代码if (this.offset <= 0) {this.offset = 1;} else {this.offset -= 0.02; // 每次渲染就向上移动0.02个单位，如果想要速度快就增大该值}if (this.texture) {this.texture.offset.set(0, this.offset); // 水平偏移量0，垂直方向偏移量为offset}// ... 其它代码
}

texture对象上存在offset属性，该属性值类型为二维向量Vector2，用来设置水平和垂直方向上的偏移量，值的范围在0.0到1.0之间。

最终效果如图所示：

3 总结

至此，我们的立体动态墙效果就已经实现了。重要点就是通过顶点向量加三角面构成自定义的平面矩形几何体，通过设置纹理贴图以及改变纹理贴图的偏移量来实现动起来的效果。

点击链接查看完整代码。
点击链接查看在线示例。