three.js 裡幾乎每個跟資源有關的物件都掛著一個 needsUpdate 標記,但官方文件對它的著墨很少,網路上大部分入門教學也幾乎不提——因為寫第一個旋轉方體的時候,你根本碰不到它。
一句話概括它的作用:告訴 renderer「這一幀請重新整理快取」。聽起來只是個旗標,但要正確使用,你必須知道背後為什麼需要快取、快取了哪些東西、以及哪些操作會讓快取失效。
一個 Mesh 要出現在螢幕上,資料得走過三段路:
這是一個金字塔式的傳輸模型,越往下越快、越往上越慢。第一步最慢,在 WebGL 這種得走網路的環境裡更是慢得可以;第二步的記憶體到顯示記憶體也不便宜。
再看這三步的執行頻率:小場景的第一步通常只在初始化時發生一次;第二步才是效能的關鍵戰場。我們先寫個小程式量量看。
var canvas = document.createElement('canvas');
var _gl = canvas.getContext('experimental-webgl');
var vertices = [];
for (var i = 0; i < 1000 * 3; i++) {
vertices.push(i * Math.random());
}
var buffer = _gl.createBuffer();
console.profile('buffer_test');
bindBuffer();
console.profileEnd('buffer_test');
function bindBuffer() {
for (var i = 0; i < 1000; i++) {
_gl.bindBuffer(_gl.ARRAY_BUFFER, buffer);
_gl.bufferData(_gl.ARRAY_BUFFER, new Float32Array(vertices), _gl.STATIC_DRAW);
}
}
這裡隨機產生 1000 個頂點,每個頂點有 x、y、z 三軸,所以是 3000 個浮點數。createBuffer() 在顯示記憶體中開一塊空間,bufferData() 則把資料從記憶體複製一份過去。
換算成實際規模:1000 個各含 1000 個頂點的物件,每個頂點 3 個 4 字節的 float,總量約 1000 × 1000 × 12 ≈ 11 MB。實測這段上傳耗時大約 15 毫秒。
15 毫秒聽起來不多,但若要維持 30fps,整帧的預算只有 33 毫秒左右。光是搬一次資料就吃掉一半,真正該花力氣的 GPU 繪製與 CPU 運算反而沒時間了。結論很直接:這一步必須能省就省。
它的做法是在第一次繪製時就把 Geometry 的頂點資料上傳,並把 buffer 記在 geometry.__webglVertexBuffer 上。之後每一幀只檢查 verticesNeedUpdate:是 false 就直接沿用快取,是 true 才重新上傳。
靜態物件永遠不需要重傳。真正需要逐幀設為 true 的,是那種頂點本身就會變的物件,例如以頂點 drive 的粒子系統、或正在播放骨骼動畫的 Mesh。
不過實務上這種案例並不多。多數 WebGL 專案會把粒子與骨骼變形寫進 vertex shader,讓 GPU 去算——在 CPU 端做雖然更好擴展,但 JavaScript 的計算能力實在有限。既然位置在 shader 裡就改變了,也就不必重傳頂點。所以真正高頻使用 needsUpdate 的場合,其實是材質與貼圖。
一張 1024×1024、RGBA 格式的貼圖要佔 4 MB 記憶體,上傳代價自然可觀:
var canvas = document.createElement('canvas');
var _gl = canvas.getContext('experimental-webgl');
var texture = _gl.createTexture();
var img = new Image;
img.onload = function () {
console.profile('texture test');
bindTexture();
console.profileEnd('texture test');
};
img.src = 'test_tex.jpg';
function bindTexture() {
_gl.bindTexture(_gl.TEXTURE_2D, texture);
_gl.texImage2D(_gl.TEXTURE_2D, 0, _gl.RGBA, _gl.RGBA, _gl.UNSIGNED_BYTE, img);
}
這次不必重複一千次了:單張 1024×1024 就要花上約 30 毫秒,256×256 則約 2 毫秒。所以 three.js 對貼圖同樣只在最開始上傳一次,除非你手動把 texture.needsUpdate 設為 true,否則 renderer 會一直沿用顯示記憶體裡的那份。
這是個經典小坑。前端圖片是非同步載入的,如果你在建立 img 之後立刻寫 texture.needsUpdate = true,renderer 會在該幀把「空的」貼圖上傳,然後把旗標設回 false。等圖片真正載完,反而再也不會更新了。正確做法是把這行寫在 onload 裡。
影片是連續的影像流,每一幀畫面都不同,因此必須每一幀都把 needsUpdate 設為 true,讓顯示記憶體跟上播放進度。
如果場景不是直接 flush 到螢幕,而是先畫進一張 render buffer 再做後處理(例如 SSAO 這類螢幕空間效果),那張 buffer 本質上也是貼圖,只是內容來自上一階段的繪製結果而非磁碟。three.js 用 WebGLRenderTarget 來管理它,這類貼圖同樣需要逐幀設為 true。
材質本身其實沒什麼資料要傳,之所以也需要這個旗標,是因為 shader。著色器是跑在 GPU 上的程式,WebGL 在執行期才編譯它,而編譯與連結都得花時間,理想狀態是一次編好、用到程式結束。three.js 因此在 material 初始化時就完成編譯,並把 program 物件快取起來。
一般情況下調整材質只需改 uniform 參數,不必重編。但若是把 Phong 的 shader 整個換成 Lambert,就得把 material.needsUpdate 設為 true 觸發重新編譯。這種替換不常見,比較常見的是下面這兩種。
幾乎每個新手都摔過這跤:執行期幫場景加了一盞燈,結果完全不亮。原因在於 three.js 內建的 shader 是用 #define 來宣告光源數量的,而這個數值是在更新材質時以字串拼接的方式產生的:
"#define MAX_DIR_LIGHTS " + parameters.maxDirLights,
"#define MAX_POINT_LIGHTS " + parameters.maxPointLights,
"#define MAX_SPOT_LIGHTS " + parameters.maxSpotLights,
"#define MAX_HEMI_LIGHTS " + parameters.maxHemiLights,
這種寫法能有效節省 GPU 暫存器——只有一盞燈時就只宣告一份 uniform。代價是光源數量一旦改變(尤其是新增),就得重新拼接、編譯、連結一次 shader。此時必須把場景中所有材質的 needsUpdate 都設為 true。
注意這裡說的不是更新貼圖內容,而是材質從「沒貼圖」變成「有貼圖」,或反過來。若不強制更新材質,畫面結果會和你預期的完全不同。原因同上,shader 裡用巨集判斷是否啟用貼圖:
parameters.map ? "#define USE_MAP" : "",
parameters.envMap ? "#define USE_ENVMAP" : "",
parameters.lightMap ? "#define USE_LIGHTMAP" : "",
parameters.bumpMap ? "#define USE_BUMPMAP" : "",
parameters.normalMap ? "#define USE_NORMALMAP" : "",
parameters.specularMap? "#define USE_SPECULARMAP": "",
所以每當 map、envMap、lightMap 等屬性在「有值」與「無值」之間切換,都要更新材質。
接續上面那點:如果是初始化時沒有貼圖、後來才動態加上,光設 material.needsUpdate 還不夠,還得把 geometry.uvsNeedsUpdate 也設為 true。
原因仍是 three.js 的優化。renderer 第一次初始化 geometry 時若判定沒有貼圖,即使記憶體裡明明有每個頂點的 UV 資料,它也不會把這份資料複製到顯示記憶體——用意是節省寶貴的顯存。問題是後來加上貼圖時,geometry 並不會聰明到自己去補傳 UV,必須由你手動告訴它。這個細節曾經讓我卡了很久。
關於各類頂點資料對應的更新旗標,可以參考專案 wiki 上的說明:https://github.com/mrdoob/three.js/wiki/Updates。
three.js 的優化做得相當到家,但每一層優化背後都藏著一個可能踩到的坑。想徹底避開,最終還是得讀原始碼,或者直接去 GitHub 上開 issue 問。