three.js提供的几何体

1.简单几何体

    three.js提供的稍微简单点的几何体包括有：PlaneGeometry(平面)、CircleGeometry（圆形）、ShapeGeometry（塑性）、CubeGeometry（立方体）、CylinderGeometry（圆柱）、TorusGeometry（圆环）、TorusKnotGeometry（画面扭结）、PolyhedronGeometry（多面体）、IcosahedronGeometry（二十面体）、OctahedronGeometry（八面体）、TetraHedronGeometry（四面体）。

    稍微复杂点的几何体包括有：ConvexGeometry（凸面体）、LatheGeometry（扫描体）、ExtrudeGeometry（拉伸几何体）、TubeGeometry（管状体）ParameterGeometry（参数几何体）、TextGeometry（文本几何体）。

2.二维几何体PlaneGoemetry

    PlaneGeoemtry是矩形态的平面几何体，初始化也很简单，需要4个参数：

new THREE.PlaneGeometry(10, 14, 4, 4)

    4个参数分别是width、height、widthSegment、heightSegment。其中widthSegment指定矩形的宽度应该划成几段，这里是在width和height方向都划分成4段。如下所示：

3.同时显示几何体的面和网状结构

    可通过THREE.SceneUtils.createMultiMaterialObject来为几何体添加多个材质，从而由显示面的颜色也显示网状结构。实现代码可参考下面：

var meshMaterial = new THREE.MeshNormalMaterial();
                meshMaterial.side = THREE.DoubleSide;
                var wireFrameMat = new THREE.MeshBasicMaterial();
                wireFrameMat.wireframe = true;

                var plane = THREE.SceneUtils.createMultiMaterialObject(new THREE.PlaneGeometry(10, 14, 4, 4), [meshMaterial, wireFrameMat]);

    createMultiMaterialObject函数第一个参数是一个几何体对象，第二个参数是材质的数组，可传递多个。其实最终生成的是多个物体，只不过都重叠在一起。

4.CircleGeometry

    很容易理解CircleGeoemtry用来画平面元的。属性包括:

    属性/是否必填/描述
    radius/是/定义啊圆的半径
    segments（分段）/否/定义创建圆所有面的数量，最少三个。如果没有指定默认为8
    thetaStart(起始角)/否/定义从哪儿开始画圆。取值从0到2*PI
    thetaLength(角度)/否/定义圆要花多大。如果没有指定，默认为2*PI整圆。如果指定为0.5PI则为四分之一个圆

5.ShapeGeometry

    PlaneGeometry和CircleGeometry只有有限的方法来定制他们的外观。如果想创建一个自定义的二维图形，可以使用ShapeGeometry。ShapeGeometry没有比的选项可以定制图形。一般都是先创建一个Shape图形。用Shape图形绘图。Shape对象提供的函数绘制函数包括:
    moveTo(x, y)/将绘图点移动到x、y坐标处
    lineTo(x, y)/从当前位置绘制一条线到指定的x、y坐标处
    quadriCurveTo(aCPx, aCPy, x, z)(二次曲面)/定义曲面，可以使用quadraticCurveTo函数或者bezierCurveTo函数绘制曲面。
    bezierCurveTO(aCPx1, aCPy1, aCPx2, aCPy2, x, y)/画一条曲线。该曲线的绘制是基于两个定义曲线的坐标以及重点坐标（x，y）。起始点是当前位置。
    splineThru(pts)/该函数沿着提供的坐标集合绘制一条光华曲线。这个参数应该是THREE.Vector2的对象数组
    arc(ay, ay, aRadius, aSTartAngle, aEndAngle, aClockwise)/画圆或者一段圆弧。圆弧起始于当前位置。ax和ay用来指定圆心与当前位置之间的偏移量。aRadius设置圆大小，而aSTartAgnle和aEndAngle定义圆弧要画多长。布尔aCockwise决定这段圆弧是顺时针还是逆时针
    absArc(ay, ay, aRadius, aSTartAngle, aEndAngle, aClockwise)/参考arc,其位置是绝对的，而不是相对于当前位置
    ellipse(aX, aY, xRadius, aStartAngle, aEndAngle, aClockwise))/参考arc。作为补充，通过ellipse函数可以分别制定x轴半径和y轴半径
    absEllipse(aX, aY, xRadius, yRadius, aStartAngle, aEndAngle, aClockwise)/参考ellipse描述。起位置时绝对，而不是相对于当前位置的相对值

    Shape对象属性holes，通过往这个属性中国添加THEE.Shape对象，你可以在图形中打几个洞。Shape对象本身也有几个辅助函数，可永安里创建几何体。如下所示：

    makeGeometry/该函数从shape对象返回一个ShapeGeometry对象
    createPointsGeometry(divisions)/改函数将图形转换成一个点集。属性divisions分段数定义返回点的数目
    createSpacedPointsGeoemtry(divisions)/该函数将图形转换为一个点集，但是这一次，分段数是一次性地应用到整个路径上
如果用createPointsGeometry或者createSpacedPointsGeometry函数创建一个点集，你可用这些点创建线段
   new THREE.Line(shape.createPointsGeometry(10), new THREE.LineBasicMateial({color: 0xff3333, line 2})

6.SphereGeometry

    这个几何体非常灵活，可以用来创建所有跟球体相关的几何体。下表中的属性可用来调整结果网格的外观：

    属性/是否必填/描述   

    radius/否/该属性设置球体的半径

    widthSegments/否/指定竖直方向上的分段数。默认为8，最小为2

    hieghtSegments/否/指定水平方向的分段数。默认为6，最小为2

    phiStart/否/指定从x轴的什么地方开始绘制。取值范围从0到2*PI。默认为0

    phiLength/否/指定从phiStart开始画多少。2*PI是整球，0.5*PI是四分之一球

    thetaStart/否/指定从y轴的什么地方开始绘制。取值范围从0到PI。默认为0

    thetaLength/指定从theata开始画多少。PI是征求，0.5PI只会绘制上半球

7.CylinderGeometry

    创建CylinderGeometry时，没有必须提供的参数。直接调用new THREE.CylinderGeometry()即可创建一个圆柱。属性列表如下：

    radiusTop/圆柱顶部尺寸，默认是20

    radiusBottom/设置圆柱底部的尺寸，默认是20

    height/属性设置圆柱的高度，默认是100

    segmentsX/该属性设置沿x轴分成多少段，默认是8.这个数字越大，圆柱越光滑

    segmentsY/该属性设置沿y轴分成多少段

    openEnded/指定网格的顶部和底部是否封闭。默认为false

8.TorusGeometry

    Torus圆环是一种简单的图形，看上去像甜甜圈。创建TorusGeometry没有必须提供的参数。参数列表为：

    radius/设置完整环的尺寸，默认为100

    tube/设置是管子的半径。默认为40

    radialSegments/这个参数设置的是沿圆环长度方向分成的段数。默认是8

    tabularSegments/这个参数设置沿圆环宽度方向分成的段数。默认是6

    arc/通过该属性值，可以孔子是否绘制一个完整的圆环。默认是 2*PI

9.ConvexGeometry

    通过ConvexGeometry可以在一组点的外面建立一个凸面。所谓凸面就是包围这组点的最小图形。如下面的代码，创建了一组随机的点，使用new THREE.ConvexGeometry(points)初始化这个包面图形。

function generatePoints(){
                var points = [];
                for(var i = 0; i < 20; i++){
                    var randomX = -15 + 30 * Math.random();
                    var randomY = -15 + 30 * Math.random();
                    var randomZ = -15 + 30 * Math.random();

                    points.push(new THREE.Vector3(randomX, randomY, randomZ));
                }

                spGroup = new THREE.Object3D();
                var material = new THREE.MeshBasicMaterial({color: 0xff0000, wireframe: true});
                points.forEach(function(point){
                    var sphereGeometry = new THREE.SphereGeometry(0.2);
                    var mesh = new THREE.Mesh(sphereGeometry, material);
                    mesh.position.copy(point);
                    spGroup.add(mesh);
                });
                scene.add(spGroup);

                var hullGeometry = new THREE.ConvexGeometry(points);
                hullMesh = createMesh(hullGeometry);
                scene.add(hullMesh);
            }

10.TubeGeometry

    TubeGeometry沿着一条三维样条曲线拉伸出一根管道。你可以通过指定顶点来定义路径，然后TubeGeometry就可以创建这根管子。如下面的代码：

function generatePoints(points, segments, radius, radiusSegments, closed){
                spGroup = new THREE.Object3D();
                var material = new THREE.MeshBasicMaterial({color: 0xff0000, transparent: false});
                points.forEach(function(point){
                    var spGeom = new THREE.SphereGeometry(0.2);
                    var spMesh = new THREE.Mesh(spGeom, material);
                    spMesh.position.copy(point);
                    spGroup.add(spMesh);
                });
                scene.add(spGroup);

                var tubeGeometry = new THREE.TubeGeometry(new THREE.SplineCurve3(points), segments, radius, radiusSegments, closed);
                tubeMesh = createMesh(tubeGeometry);
                scene.add(tubeMesh);
            }

    points是一组Vector3集合，但TubeGeometry不能直接使用，必须要转换成THREE.SplineCurve3创建样条。而且这个参数是比传的。其他属性如下列表：

    属性/是否必须/描述

    path/是/该属性用一个THREE.SplineCurve3对象指定管道应当遵循的路径

    segments/否/管道所有的分段数。默认64.路径越长，指定的分段数应该越多

    radius/否/管道半径，默认为1

    radiusSegments/否/管道圆周的分段数。默认是8.分段数越多，管道看上去越圆滑

    closed/否/如果为true，管道的头和尾会连起来。默认为false

11.textGeometry

    text几何体的创建代码可参考如下：

this.asGeom = function(){
                scene.remove(text1);
                scene.remove(text2);

                var option = {
                    size: controls.size,
                    height: controls.height,
                    weight: controls.weight,
                    font: controls.font,
                    bevelThickness: controls.bevelThickness,
                    bevelSize: controls.bevelSize,
                    bevelSegments: controls.bevelSegments,
                    bevelEnabled: controls.bevelEnabled,
                    curveSegments: controls.curveSegments,
                    steps: controls.steps
                }

                text1 = createMesh(new THREE.TextGeometry("Learning", option));
                text1.position.z = -100;
                text1.position.y = 100;
                scene.add(text1);

                text2 = createMesh(new THREE.TextGeometry("Three.js", option));
                scene.add(text2);
            }

    和其他几何体创建方式一样，只是初始化时调用new THREE.TextGeometry对象，第一个参数是传递的文字。第二个参数是几何体的属性。属性列表如下：

    属性/是否必须/描述

    size/否/指定文字的大小。默认100

    height/否/指定拉伸的程度。默认是50

    weight/否/指定字体的权重。可选的值是normal、bold。默认normal

    font/否/指定要使用的字体名。默认是helvetiker

    style/否/字体样式。可选值包括normal、italic。默认是normal

    bevelThickness（斜角厚度）/否/指定斜角的深度。斜角是前后面和拉伸面之间的倒角。默认是10

    bevelSegments(斜角分段数)/斜角的分段数。默认是3

    bevelSize/否/指定斜角的高度。默认为8

    bevelEnabled/否/如果设置为true，就会有斜角。默认为false

    curveSegments（曲线分段数）/否/定义拉伸体被分成几段。默认为1.

    steps（拉伸体段数）/否/拉伸体被分成多少段。默认为1

    extrudePath/否/指定图形沿着什么路径拉伸。如果没有指定，图形沿着z轴拉伸

    material/否/定义前后面所用材质的索引。用函数THREE.SceneUtils.createMultiMaterialObject创建网格

    extrudeMateria(拉伸材质）/否/指定斜角和拉伸体所用材质的索引。用函数THREE.SceneUtils.createMultiMaterialObject创建网格

12添加自定义字体

    Three.js提供了几种可以在场景中使用的字体。这些字体技术是由typeface.js(http://typeface.neocracy.org)提供的字体。typeface.js是一个可以将TrueType和OpenType字体转换为Javascript库。转换出来的Javascript文件可以包含在你的页面，然后即可在Three.js中使用。

    要转换已有的OpenType或TrueType字体，可以使用网页http://typeface.neocracy.org/fonts.html。你可以在这个网站上上传一个字体，然后它就会把该字体转化成javascript。要包含这个字体。只要在html页面顶部引用这个javascript文件即可。

13.使用二元操作组合网格

    我们可以把标准的几何体组合在一起创建出一个新的几何体。实现这个功能，我们可以使用Three.js扩展库ThreeBSP。下载地址为：https://github.com/skalnik/ThreeBSP。这个扩展库提供了三个函数：

    intersect(相交)/可以在两个几何体的交集上创建出新的几何体。两个几何体相互交叠的地方就是新的几何体

    union(联合)/将两个几何体联合在一起创建出新的几何体。可以将这个函数与mergeGeometry函数想比较

    subtract(相减)/可以在第一个几何体中减去两个几何体交叠的部分，从而创建出新的几何体

    下面代码是使用ThreeBSP的代码，使用也比较简单：

function redrawResult(){
            showSpinner();

            //异步执行，避免锁定线程
            setTimeout(function(){
                scene.remove(result);
                var sphere1BSP = new ThreeBSP(sphere1);
                var sphere2BSP = new ThreeBSP(sphere2);
                var cubeBSP = new ThreeBSP(cube);

                var resultBSP;

                switch(controls.actionSphere){
                    case "subtract":
                        resultBSP = sphere1BSP.subtract(sphere2BSP);
                        break;
                    case "intersect":
                        resultBSP = sphere1BSP.intersect(sphere2BSP);
                        break;
                    case "union":
                        resultBSP = sphere1BSP.union(sphere2BSP);
                        break;
                    case "none":
                        break;
                }

                if(!resultBSP) resultBSP = sphere1BSP;
                switch(controls.actionCube){
                    case "subtract":
                            resultBSP = cubeBSP.subtract(resultBSP);
                        break;
                    case "intersect":
                            resultBSP = cubeBSP.intersect(resultBSP);
                        break;
                    case "union":
                            resultBSP = cubeBSP.union(resultBSP);
                        break;
                    case "none":
                        break;
                }

                if(controls.actionCube === "none" && controls.actionSphere === "none"){

                }else{
                    result = resultBSP.toMesh();
                    result.geometry.computeFaceNormals();
                    result.geometry.computeVertexNormals();
                    scene.add(result);
                }

                hideSpinner(spinner);
            }, 200);
        }

    要使用运算函数，需要把geometry转换成ThreeBSP对象。代码resultBSP = sphere1BSP.subtract(sphere2BSP)最终的结果是sphere1BSP几何体减去和sphere2BSP重叠的部分后剩下的几何体。

    运算完成后直接调用result.BSP.toMesh()函数即可得到网格。但还需要调用computeFaceNormals和computeVertexNromals函数，这是因为执行二元操作之后，几何体中心店和面的法向量可能会变化。Three.js在着色器中会用到面法向量和顶点法向量。明确地重新计算面和顶点法向量，可保证新生成的对象着色光滑。