DIV CSS 佈局教程網

Three.js 原始碼閱讀筆記(二):Object3D 類別
編輯:JavaScript基礎知識     

本篇是 Three.js 原始碼筆記的第二篇。

Core::Object3D

Object3D 幾乎是整個框架中最重要的類別:場景、幾何形體、相機、光照等等都繼承自它,因為它們都是三維空間中的物件。建構函式宣告了大量屬性:

THREE.Object3D = function () {
    THREE.Object3DLibrary.push(this);
    this.id = THREE.Object3DIdCount++;
    this.name = '';
    this.parent = undefined;
    this.children = [];
    this.up = new THREE.Vector3(0, 1, 0);
    this.position = new THREE.Vector3();
    this.rotation = new THREE.Vector3();
    this.scale = new THREE.Vector3(1, 1, 1);
    this.matrix = new THREE.Matrix4();
    this.matrixWorld = new THREE.Matrix4();
    this.matrixAutoUpdate = true;
    this.matrixWorldNeedsUpdate = true;
    this.quaternion = new THREE.Quaternion();
    this.useQuaternion = false;
    this.visible = true;
    this.castShadow = false;
    this.receiveShadow = false;
    this.frustumCulled = true;
    // ...
};

幾個關鍵屬性

parent 與 children:整個場景中的 Object3D 是以「樹」來管理的。例如一輛行駛的汽車是一個 Object3D,它的模型矩陣負責把整台車放到正確位置;而擺動的雨刷除了跟著車移動,還要相對車身左右擺動——這份邏輯不該寫在汽車物件裡。解法是把雨刷刷設為汽車的 children,讓它只負責自己相對父物件的運動。在這種結構下,Scene 就是樹的頂端。

matrix 與 matrixWorld:matrix 是本地的模型矩陣,只描述該物件自身的變換;matrixWorld 則要沿著 parent 鏈逐層左乘上層矩陣,直到場景根節點。

position / rotation / scale:分別對應模型矩陣的三種變換成分。旋轉有兩種表示法:rotation(搭配 eulerOrder)與 quaternion,實際採用哪一種取決於 useQuaternion 的布林值。

值得留意的是,物件的「變換狀態」實際上存在兩份備份:一份是 matrix 物件,一份是 position 等屬性。兩者必須保持一致,改動其中一份時,另一份要在適當時機同步。

主要方法

applyMatrix(matrix):把參數矩陣左乘到 this.matrix,等同於對物件套用某個(可能由多步組成的)變換。執行後立刻同步更新 position 等屬性。

applyMatrix: function (matrix) {
    this.matrix.multiply(matrix, this.matrix);
    this.scale.getScaleFromMatrix(this.matrix);
    var mat = new THREE.Matrix4().extractRotation(this.matrix);
    this.rotation.setEulerFromRotationMatrix(mat, this.eulerOrder);
    this.position.getPositionFromMatrix(this.matrix);
}

translate(distance, axis) 與 translateX / Y / Z:沿指定軸移動。注意這些方法只改 position,不動 matrix。

localToWorld / worldToLocal:本地座標與世界座標的互相轉換,這裡的「本地座標」指的是未套用任何變換前的原始頂點座標。

lookAt(eye, center, up):呼叫 matrix 的同名方法,主要用於相機。它只改變旋轉狀態,之後若 rotationAutoUpdate 為真,會同步更新 rotation 或 quaternion。

add / remove:從樹結構上掛上或移除子物件。

traverse: function (callback) {
    callback(this);
    for (var i = 0, l = this.children.length; i < l; i++) {
        this.children[i].traverse(callback);
    }
}

traverse(callback):對自己與所有後代逐一呼叫回呼,常用於批次修改整棵子樹。getChildByName、getDescendants 則分別用於尋找特定子物件與收集全部後代。

updateMatrix / updateMatrixWorld:依 position、rotation(或 quaternion)、scale 更新 matrix 與 matrixWorld。

updateMatrixWorld: function (force) {
    if (this.matrixAutoUpdate === true) this.updateMatrix();
    if (this.matrixWorldNeedsUpdate === true || force === true) {
        if (this.parent === undefined) {
            this.matrixWorld.copy(this.matrix);
        } else {
            this.matrixWorld.multiply(this.parent.matrixWorld, this.matrix);
        }
        this.matrixWorldNeedsUpdate = false;
        force = true;
    }
    for (var i = 0, l = this.children.length; i < l; i++) {
        this.children[i].updateMatrixWorld(force);
    }
}

這裡有個實務細節:applyMatrix 改完 matrix 後立刻同步 position,但 translate 或直接改 position 之後並不會自動更新 matrix,必須手動呼叫 updateMatrix()。與其為每個屬性加監聽器即時同步,Three.js 選擇「在真正需要時才更新」,以換取效能——例如你可能每帧都在改 rotation,但只有在存取 matrix 的那一刻才需要重算。

Core::UV

THREE.UV = function (u, v) {
    this.u = u || 0;
    this.v = v || 0;
};

材質座標,通常與頂點一一對應,光柵化後每個像素都有一個 UV 值,再据此從貼圖取色。實作上就是個改了屬性名的 Vector2。

Core::Geometry

THREE.Geometry = function () {
    this.vertices = [];
    this.colors = [];
    this.normals = [];
    this.faces = [];
    this.faceUvs = [[]];
    this.faceVertexUvs = [[]];
    this.dynamic = true;
    // 一堆 xxxNeedUpdate 標記
};

最重要的兩組屬性:vertices 是 Vector3 陣列,每個元素是一個頂點座標;faces 是 Face3 / Face4 陣列,存的是頂點的索引值,透過索引回到 vertices 取實際座標。colors 與 normals 則是與頂點對應的顏色與法線,只在少數情況使用——多數時候頂點的顏色與法線是在「面」的層級定義的。

applyMatrix(matrix) 會用變換矩陣改寫所有頂點座標與面的法線。這裡有個數學重點:法線不能直接用 matrix 去乘,而要用其左上角 3×3 子矩陣的「逆轉置矩陣」(normalMatrix),否則在包含非等比縮放的變換下,法線方向會出錯。

applyMatrix: function (matrix) {
    var normalMatrix = new THREE.Matrix3();
    normalMatrix.getInverse(matrix).transpose();

    for (var i = 0, il = this.vertices.length; i < il; i++) {
        matrix.multiplyVector3(this.vertices[i]);
    }
    for (var i = 0, il = this.faces.length; i < il; i++) {
        var face = this.faces[i];
        normalMatrix.multiplyVector3(face.normal).normalize();
        for (var j = 0, jl = face.vertexNormals.length; j < jl; j++) {
            normalMatrix.multiplyVector3(face.vertexNormals[j]).normalize();
        }
        matrix.multiplyVector3(face.centroid);
    }
}

computeFaceNormals / computeVertexNormals:前者計算每個面唯一的 normal,後者計算每個頂點的 vertexNormals。關鍵在於被多個面共享的頂點只有「一個」法線,它同時受所有相鄰面影響。以原點為中心、三組面分別垂直於各軸的立方體為例,第一象限那個頂點的法線是 (1,1,1) 的歸一化——平面的頂點法線居然不垂直於平面,看來違直,但用平面模擬曲面時效果極佳。

其他方法包含 computeCentroid(計算各面的重心,之所以放在 Geometry 而非 Face 上,是因為 Face 內部拿不到頂點座標,只有索引)、createMorphNormals、mergeVertices(合併座標重複的點並更新索引)等。

Core::Quaternion

THREE.Quaternion = function (x, y, z, w) {
    this.x = x || 0;
    this.y = y || 0;
    this.z = z || 0;
    this.w = (w !== undefined) ? w : 1;
};

四元數用另一種方式描述旋轉,最大好處是能避免歐拉角在接近垂直時出現的萬向節鎖死(gimbal lock)問題,且插值更平滑。不談函式時它就是個 Vector4;主要方法包含 setFromEuler(v, order)、setFromAxis(axis, angle)、setFromRotationMatrix(matrix),分別對應三種建立方式。

順帶一提,Core 中還有 Projectors(管理投影,涉及渲染流程)、Ray(射線,具原點、方向與遠近截斷點,點光源相關功能會用到)、Rectangle 與 Spline 等,相對單純,可留待需要時再看。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved