DIV CSS 佈局教程網

Three.js 原始碼閱讀筆記(一):Core 核心物件
編輯:JavaScript基礎知識     

Three.js 是相當優秀的 WebGL 開源函式庫,大幅簡化了瀏覽器 3D 程式設計。由於當時中文資料匱乏,作者決定直接讀原始碼並做筆記,本篇從最基礎的 Core 物件開始。

Vector2

THREE.Vector2 = function (x, y) {
    this.x = x || 0;
    this.y = y || 0;
};

功能函式挂在 prototype 上:

THREE.Vector2.prototype = {
    constructor: THREE.Vector2,
    set: function (x, y) { this.x = x; this.y = y; return this; },
    copy: function (v)   { this.x = v.x; this.y = v.y; return this; },
    // 更多函式
};

set 會改動呼叫者並回傳自己,這種鏈式設計在 Three.js 中很常見。其他重要方法包含:add / sub(回傳兩向量相加減的新向量)、addSelf / subSelf(原地加減)、multiplyScale / divideScale(原地乘除純量)、lerpSelf(v, alpha)(朝 v 方向插值,alpha 為 1 時等於 v、為 0 時保持原狀)、negate(取反)、dot(點積)、lengthSq / length(長度平方與長度)、normalize(歸一化)、distanceTo(距離)、setLength(改變長度不改方向)、equals、isZero,以及 clone(複製出去,與 copy 方向相反)。

Vector3

THREE.Vector3 = function (x, y, z) {
    this.x = x || 0;
    this.y = y || 0;
    this.z = z || 0;
};

與 Vector2 大量重疊,此處只列差異:setX / setY / setZ 可單獨設定某分量;cross(a, b) 與 crossSelf(v) 進行叉乘(結果垂直於兩向量並符合右手定則);getPositionFromMatrix、getRotationFromMatrix、getScaleFromMatrix 從 4×4 模型矩陣中取出平移、旋轉、縮放分量;angleTo(v) 計算兩向量夾角。

Vector4

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

用來表示齊次座標,函式與前三個向量類別大同小異,只是多一個分量。

Matrix3 與 Matrix4

THREE.Matrix3 = function () {
    this.elements = new Float32Array(9);
};

3×3 矩陣的 9 個元素存在 elements 中,主要方法有 getInverse(求逆並改動自身)與 transpose(轉置)。

THREE.Matrix4 = function (n11, n12, ... , n44) {
    this.elements = new Float32Array(16);
    this.set(/* 預設為單位矩陣 */);
};

4×4 矩陣在三維圖學中極為關鍵,模型矩陣、視圖矩陣、投影矩陣都是它。除矩陣乘法與縮放外,幾個值得記住的方法:

lookAt(eye, target, up):建立視圖矩陣,表示相機位於 eye、看向 target、向上向量為 up。up 的作用是鎖定相機剩下的那一個自由度——相機位置與朝向固定後仍可繞視線旋轉,up 就是用来消除這個旋轉的。

multiplyVector3 / multiplyVector4:矩陣左乘向量。若矩陣是模型視圖矩陣、向量是點座標,輸出即為該點在相機座標系下的位置。

rotateAxis(v):以矩陣左上角 3×3 子矩陣左乘向量並歸一化。該子矩陣正好承載了旋轉資訊,因此這個操作等同於把向量做旋轉。

getPosition / setPosition:平移分量存放在 elements[12]、[13]、[14]。
compose / decompose:把平移、旋轉、縮放合成一個矩陣,或反向拆解。
make 系列(makeTranslate、makeRotationX、makeScale 等):直接重置為「單位矩陣套用單一變換」的結果,與物件原本的值無關。
extractPosition / extractRotation:把另一矩陣的位置或旋轉抽出來套用到自己。

Face3 / Face4

THREE.Face3 = function (a, b, c, normal, color, materialIndex) {
    this.a = a; this.b = b; this.c = c;
    this.normal = normal instanceof THREE.Vector3 ? normal : new THREE.Vector3();
    this.vertexNormals = normal instanceof Array ? normal : [];
    // ...
};

a、b、c 是頂點的「索引」而非座標本身(Mesh 把所有點集中存在一個陣列中);normal 是法線、color 是顏色、materialIndex 是材質索引,這幾個參數既可傳單一物件也可傳陣列。Face4 為四頂點版本,其餘幾乎相同。

Math

靜態類別,不需 new。clamp(x, a, b) 把 x 夾在 [a, b];mapLinear(x, a1, a2, b1, b2) 做線性映射;random16、randInt、randFloat、randFloatSpread 產生各類隨機數;sigh(x) 依正負號回傳 +1 或 -1。

Clock

THREE.Clock = function (autoStart) {
    this.autoStart = (autoStart !== undefined) ? autoStart : true;
    this.startTime = 0;
    this.oldTime = 0;
    this.elapsedTime = 0;
    this.running = false;
};

start() / stop() 控制計時,getDelta() 回傳與上次呼叫間隔的時間,getElapsedTime() 回傳自開始以來的總時間。autoStart 為真時,若在未 start 或已 stop 的狀態呼叫 getDelta(),會自動開始計時並回傳 0。

Color

THREE.Color = function (hex) {
    if (hex !== undefined) this.setHex(hex);
    return this;
};

setHex: function (hex) {
    hex = Math.floor(hex);
    this.r = (hex >> 16 & 255) / 255;
    this.g = (hex >>  8 & 255) / 255;
    this.b = (hex      & 255) / 255;
    return this;
}

內部一律以 0–1 浮點的 r、g、b 儲存顏色。另有 setRGB、setHSV、getHex,以及 copyGammaToLinear / copyLinearToGamma 與 convertGammaToLinear / convertLinearToGamma—— Gamma 校正在本質上是 rgb 值的平方與開方。

讀完這一批物件會發現一個共同設計哲學:所有運算方法都盡量「原地修改並回傳 this」,讓呼叫可以串成一條鏈,這也是 Three.js 程式碼看起來特別緊湊的原因。

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