fix: reduce assembly memory usage on mobile Safari

This commit is contained in:
Jerry
2026-10-30 19:39:50 +08:00
parent 738095c60d
commit e0416b4064
7 changed files with 316 additions and 51 deletions
+97
View File
@@ -0,0 +1,97 @@
// Texture files can be small on disk but occupy gigabytes after decoding.
// Limit their resolution BEFORE retaining another part or uploading to WebGL.
export function constrainedAssemblyDevice() {
return !!globalThis.matchMedia?.('(pointer: coarse)').matches
|| (globalThis.navigator?.deviceMemory > 0 && navigator.deviceMemory <= 4);
}
export function assemblyTextureLimit(fileCount, constrained = constrainedAssemblyDevice()) {
// Reserve room for geometry, the decoder and the browser. Allow several maps
// per GLB, and count both the decoded image and GPU texture/mipmaps.
const budget = (constrained ? 32 : 128) * 1024 * 1024;
const edge = Math.sqrt(budget / (Math.max(1, fileCount) * 2 * 4 * (1 + 4 / 3)));
return Math.max(32, Math.min(constrained ? 512 : 1024, 2 ** Math.floor(Math.log2(edge))));
}
export function textureDimensions(width, height, limit) {
const scale = Math.min(1, limit / Math.max(width, height));
return { width: Math.max(1, Math.round(width * scale)), height: Math.max(1, Math.round(height * scale)) };
}
export function objectTextures(root) {
const textures = new Set();
root.traverse((object) => {
for (const material of [object.material].flat().filter(Boolean)) {
for (const value of Object.values(material)) if (value?.isTexture) textures.add(value);
}
});
return textures;
}
export async function resizeAssemblyImage(image, width, height) {
if (globalThis.createImageBitmap) {
try {
const resized = await createImageBitmap(image, { resizeWidth: width, resizeHeight: height,
resizeQuality: 'high', colorSpaceConversion: 'none', premultiplyAlpha: 'none' });
if (resized.width === width && resized.height === height) return resized;
// Some older WebKit builds accept the options but ignore resizeWidth.
resized.close?.();
} catch { /* Older Safari image sources need the canvas path. */ }
}
const canvas = document.createElement('canvas');
canvas.width = width; canvas.height = height;
const context = canvas.getContext('2d');
if (!context) throw new Error('无法为装配贴图分配内存,请关闭其他页面后重试');
context.drawImage(image, 0, 0, width, height);
return canvas;
}
export async function fitAssemblyTextures(root, limit, { signal, resize = resizeAssemblyImage } = {}) {
const sources = new Map();
for (const texture of objectTextures(root)) {
if (!sources.has(texture.source)) sources.set(texture.source, []);
sources.get(texture.source).push(texture);
}
// An entire machine can also arrive in one GLB containing hundreds of maps.
limit = Math.min(limit, assemblyTextureLimit(Math.ceil(sources.size / 2)));
const originals = new Set([...sources.keys()].map(source => source.data));
let beforeBytes = 0, afterBytes = 0;
try { for (const [source, textures] of sources) {
signal?.throwIfAborted();
const image = source.data;
// Video, compressed and data textures must retain their specific layout.
if (!image?.width || !image?.height || image.data || textures.some(t => t.isCompressedTexture || t.isVideoTexture)) continue;
const { width, height } = textureDimensions(image.width, image.height, limit);
beforeBytes += image.width * image.height * 4;
afterBytes += width * height * 4;
if (width === image.width && height === image.height) continue;
const small = await resize(image, width, height);
if (signal?.aborted) { small.close?.(); signal.throwIfAborted(); }
source.data = small;
for (const texture of textures) texture.needsUpdate = true;
} } finally {
// Different Texture Sources may point to the same bitmap. Never close one
// still referenced by a source, including after cancellation or failure.
const live = new Set([...sources.keys()].map(source => source.data));
for (const image of originals) if (!live.has(image)) image?.close?.();
}
return { beforeBytes, afterBytes };
}
export function disposeAssemblyObjects(roots) {
const resources = new Set(), images = new Set();
for (const root of [roots].flat().filter(Boolean)) root.traverse((object) => {
if (object.geometry) resources.add(object.geometry);
for (const material of [object.material].flat().filter(Boolean)) {
resources.add(material);
for (const value of Object.values(material)) if (value?.isTexture) {
resources.add(value);
if (value.source?.data) images.add(value.source.data);
}
}
});
for (const resource of resources) resource.dispose();
// Texture.dispose() only frees WebGL storage; Safari's decoded ImageBitmap
// backing memory needs an explicit close as well.
for (const image of images) image.close?.();
}
+37 -15
View File
@@ -8,23 +8,13 @@ import { readLimited, validateEmbeddedGlb, visibleAssemblyParts } from './experi
import { modelAssetUrl } from './model-assets.js';
import { ScrewTransition, screwDuration, inferToolTipAxis } from './assembly-motion.js';
import { createExplodedLayout } from './assembly-explode.js';
function disposeObject(root) {
const resources = new Set();
for (const item of [root].flat()) item.traverse((object) => {
if (object.geometry) resources.add(object.geometry);
for (const material of [object.material].flat().filter(Boolean)) {
resources.add(material);
for (const value of Object.values(material)) if (value?.isTexture) resources.add(value);
}
});
resources.forEach((resource) => resource.dispose());
}
import { constrainedAssemblyDevice, assemblyTextureLimit, fitAssemblyTextures, disposeAssemblyObjects as disposeObject } from './assembly-memory.js';
export class AssemblyViewer {
constructor(container) {
this.container = container;
this.disposed = false;
this.lifecycle = new AbortController();
this.budget = new RenderBudget();
this.renderer = new THREE.WebGLRenderer({ antialias: this.budget.antialias, alpha: true, powerPreference: 'low-power' });
const renderer = this.renderer;
@@ -88,9 +78,11 @@ export class AssemblyViewer {
this.intersectionObserver.observe(container);
document.addEventListener('visibilitychange', this.onVisibility);
renderer.domElement.addEventListener('webglcontextlost', (event) => {
if (this.disposed) return;
event.preventDefault();
this.contextLost = true;
this.onVisibility();
this.onContextLost?.();
});
renderer.domElement.addEventListener('webglcontextrestored', () => {
if (this.disposed) return;
@@ -125,11 +117,23 @@ export class AssemblyViewer {
setPaused(paused) { this.paused = paused; this.onVisibility(); }
async load(config, signal, onProgress) {
const cancelLoad = () => this.lifecycle.abort(signal.reason);
signal.addEventListener('abort', cancelLoad, { once: true });
if (signal.aborted) cancelLoad();
const callerSignal = signal;
signal = this.lifecycle.signal;
try { await this.loadParts(config, signal, onProgress); }
finally { callerSignal.removeEventListener('abort', cancelLoad); }
}
async loadParts(config, signal, onProgress) {
this.config = config;
this.templates = new Map();
this.parts = new Map();
const queue = [...new Set([...config.parts, ...(config.tools || [])].map((part) => part.file))];
const count = queue.length;
const textureLimit = assemblyTextureLimit(count);
this.memoryStats = { textureLimit, beforeBytes: 0, afterBytes: 0, files: count };
let completed = 0;
// Compressed uploads use the same local decoder as the main model viewer.
// One decoder worker keeps assembly loading within mobile memory budgets.
@@ -156,18 +160,30 @@ export class AssemblyViewer {
validateEmbeddedGlb(bytes.buffer);
signal.throwIfAborted();
const gltf = await loader.parseAsync(bytes.buffer, new URL('.', file.url).href);
if (this.disposed || signal.aborted) {
try {
signal.throwIfAborted();
const stats = await fitAssemblyTextures(gltf.scene, textureLimit, { signal });
this.memoryStats.beforeBytes += stats.beforeBytes;
this.memoryStats.afterBytes += stats.afterBytes;
signal.throwIfAborted();
} catch (error) {
disposeObject(gltf.scene);
throw new DOMException('预览已关闭', 'AbortError');
throw error;
}
file.data = undefined;
this.templates.set(path, gltf.scene);
onProgress?.(Math.round(++completed / count * 100));
// Let the UI respond and discarded decode buffers be reclaimed between
// parts instead of retaining a burst of full-resolution images.
await new Promise(resolve => setTimeout(resolve, 0));
}
};
// Let in-flight parses settle before terminating the shared decoder worker.
try {
const results = await Promise.allSettled(Array.from({ length: Math.min(2, count) }, worker));
const results = await Promise.allSettled(Array.from({ length: Math.min(constrainedAssemblyDevice() ? 1 : 2, count) }, () => worker().catch(error => {
this.lifecycle.abort(error);
throw error;
})));
const failed = results.find(result => result.status === 'rejected');
if (failed) throw failed.reason;
} finally { draco.dispose(); }
@@ -433,6 +449,9 @@ export class AssemblyViewer {
dispose() {
if (this.disposed) return;
this.disposed = true;
this.lifecycle.abort();
for (const transition of this.transitions || []) transition.dispose?.();
this.transitions = [];
this.loop.dispose();
document.removeEventListener('visibilitychange', this.onVisibility);
this.resizeObserver.disconnect();
@@ -440,10 +459,13 @@ export class AssemblyViewer {
this.controls.dispose();
disposeObject([this.scene, ...this.templates?.values() || []]);
this.templates?.clear();
this.parts?.clear();
this.scene.traverse((object) => object.shadow?.dispose());
this.environment.dispose();
this.renderer.dispose();
this.renderer.forceContextLoss();
this.renderer.domElement.remove();
this.scene.clear();
this.model = this.config = this.explodedLayout = this.explosionTransition = null;
}
}
+15 -1
View File
@@ -139,7 +139,8 @@ export function openAssemblyPreview(project, { initialStep = null, focusPartId =
const visibility = () => { if (document.hidden) stopPlayback(); };
document.addEventListener('visibilitychange', visibility);
const setEnabled = (enabled) => {
dialog.querySelectorAll('[data-reset], [data-rotate], [data-explode]').forEach((b) => { b.disabled = !enabled; });
dialog.querySelectorAll('.assembly-tools button, .assembly-step button, .assembly-step input, [data-explosion], [data-focus]')
.forEach((control) => { control.disabled = !enabled; });
};
dialog.addEventListener('close', () => {
@@ -182,6 +183,17 @@ export function openAssemblyPreview(project, { initialStep = null, focusPartId =
config = pkg;
if (controller.signal.aborted) return;
preview = new AssemblyViewer(find('.assembly-scene'));
preview.onContextLost = () => {
stopPlayback();
preview?.dispose();
preview = null;
setEnabled(false);
overlay.hidden = false;
overlay.classList.add('is-error');
overlay.querySelector('strong').textContent = '三维显示已中断';
find('[data-progress]').textContent = '可重新加载拼装模型,无需刷新页面。';
find('[data-retry]').hidden = false;
};
preview.onMotionChange = (motion) => {
activeScrew = motion?.partId;
find('[data-focus]').hidden = !motion;
@@ -200,6 +212,8 @@ export function openAssemblyPreview(project, { initialStep = null, focusPartId =
find('[data-steps]').hidden = config.steps.length === 0;
find('[data-explode]').hidden = config.parts.length < 2;
find('[data-seek]').max = String(Math.max(0, config.steps.length - 1));
showStep(null, false);
find('[data-focus]').hidden = true;
if (Number.isInteger(initialStep) && initialStep >= 0 && initialStep < config.steps.length) {
showStep(initialStep, false);
if (focusPartId) preview.focusPart(focusPartId);
+13 -2
View File
@@ -34,7 +34,8 @@ export async function fetchPackageJson(url, signal) {
}
export async function readLimited(response, maxBytes = Infinity) {
if (Number(response.headers.get('Content-Length')) > maxBytes) {
const length = Number(response.headers.get('Content-Length'));
if (length > maxBytes) {
await response.body?.cancel();
fail('资源文件超过允许的大小');
}
@@ -44,6 +45,11 @@ export async function readLimited(response, maxBytes = Infinity) {
return bytes;
}
const reader = response.body.getReader();
// Most individual GLBs have a known length. Fill one buffer directly rather
// than holding every network chunk plus a second full copy during decoding.
// For untrusted/large lengths use the streaming path without eager allocation.
let direct = Number.isSafeInteger(length) && length > 0 && length <= 64 * 1024 * 1024
&& !response.headers.get('Content-Encoding') ? new Uint8Array(length) : null;
const chunks = [];
let size = 0;
try {
@@ -52,9 +58,14 @@ export async function readLimited(response, maxBytes = Infinity) {
if (done) break;
size += value.byteLength;
if (size > maxBytes) { await reader.cancel(); fail('资源文件超过允许的大小'); }
chunks.push(value);
if (direct && size <= direct.length) direct.set(value, size - value.byteLength);
else {
if (direct) { chunks.push(direct.subarray(0, size - value.byteLength)); direct = null; }
chunks.push(value);
}
}
} finally { reader.releaseLock(); }
if (direct) return size === direct.length ? direct : direct.slice(0, size);
const bytes = new Uint8Array(size);
let offset = 0;
for (const chunk of chunks) { bytes.set(chunk, offset); offset += chunk.byteLength; }
+57 -26
View File
@@ -14,6 +14,7 @@ import { hasWalkingDemo, openWalkingDemo } from './walking.js';
import { projectExperiences } from './project-experiences.js';
import { loadProjectAssembly, publicResourceUrl } from './project-resources.js';
import { prepareDocumentImages, hydrateDocumentImages } from './document-images.js';
import { constrainedAssemblyDevice } from './assembly-memory.js';
renderShell('explore');
@@ -26,6 +27,18 @@ const LANG_COLORS = { Python: '#5ea8ff', 'C++': '#ff7a9a', URDF: '#c8ff3e', Type
const TABS = ['overview', 'files', 'discussions', 'forks', 'activity'];
let project, all, viewer;
let stageGeneration = 0, stageSuspended = false, stageCleanup = () => {};
function releaseStage() {
stageGeneration++;
stageCleanup();
stageCleanup = () => {};
viewer?.dispose();
viewer = null;
}
window.addEventListener('pagehide', releaseStage);
window.addEventListener('pageshow', event => {
if (event.persisted && project && !stageSuspended) setupViewer();
});
let tab = TABS.includes(params.get('tab')) ? params.get('tab') : params.get('path') ? 'files' : 'overview';
let path = params.get('path') || '';
let pathKind = null; // 后端模式:'dir' | 'file',未知时先按目录读
@@ -93,13 +106,21 @@ function renderDescription(description) {
document.fonts.ready.then(updateOverflow);
}
function openPreview(open) {
function openPreview(open, releaseBackground = false) {
const release = releaseBackground && constrainedAssemblyDevice();
if (release) { stageSuspended = true; releaseStage(); }
const dialog = open();
if (!dialog) return;
if (!dialog) {
if (release) { stageSuspended = false; setupViewer(); }
return;
}
viewer?.setPaused(true);
dialog.addEventListener('close', () => viewer?.setPaused(false), { once: true });
dialog.addEventListener('close', () => {
if (release) { stageSuspended = false; setupViewer(); }
else viewer?.setPaused(false);
}, { once: true });
}
$('ai-assembly').addEventListener('click', () => openPreview(() => openAssemblyPreview(projectExperiences(project))));
$('ai-assembly').addEventListener('click', () => openPreview(() => openAssemblyPreview(projectExperiences(project)), true));
$('walking-demo').addEventListener('click', () => openPreview(() => openWalkingDemo(projectExperiences(project))));
function renderCounters() {
@@ -188,20 +209,34 @@ function syncUrl() {
// ---------- 3D 展示 ----------
async function setupViewer() {
if (stageSuspended) return;
releaseStage();
const generation = stageGeneration;
const controller = new AbortController();
stageCleanup = () => controller.abort();
const stale = () => controller.signal.aborted || generation !== stageGeneration;
$('loader').classList.remove('hidden', 'error');
$('loader-text').textContent = '正在加载模型…';
if (!project.robot && !publicResourceUrl(project.modelGlbUrl)) {
$('stage').closest('section').hidden = true;
splashDone();
return;
}
// The independently bound URDF owns the main interactive preview. A GLB
// uploaded for assembly must not replace it or supply its coordinate frame.
if (!project.robot && publicResourceUrl(project.modelGlbUrl)) {
const { AssemblyViewer } = await import('./assembly-viewer.js');
viewer = new AssemblyViewer($('stage'));
viewer.setPaused(!!document.querySelector('.assembly-dialog[open]'));
const controller = new AbortController();
window.addEventListener('pagehide', () => { controller.abort(); viewer?.dispose(); }, { once: true });
$('reset-view').onclick = () => viewer.resetView();
if (stale()) return;
const current = viewer = new AssemblyViewer($('stage'));
current.setPaused(!!document.querySelector('.assembly-dialog[open]'));
$('reset-view').onclick = () => viewer?.resetView();
try {
// A supplied assembly frame also defines this project's assembled model orientation.
// Plain GLB uploads otherwise use glTF's standard Y-up frame.
const assembly = getAssemblyModel(project) ? await loadProjectAssembly(project, controller.signal).catch(() => null) : null;
await viewer.loadGlb(project.modelGlbUrl, controller.signal, assembly?.displayQuaternion);
if (stale()) return;
await current.loadGlb(project.modelGlbUrl, controller.signal, assembly?.displayQuaternion);
if (stale()) return;
$('loader').classList.add('hidden');
$('stage-info').innerHTML = `<span class="chip">${icon('cube', 13)}整机模型</span><span class="chip">拖拽旋转 · 滚轮或双指缩放</span>`;
} catch (error) {
@@ -214,8 +249,9 @@ async function setupViewer() {
}
// 3D 引擎按需加载:标题、README 先显示
const { RobotViewer } = await import('./viewer.js');
viewer = new RobotViewer($('stage'), { framing: 2.3, autoRotate: false, onDemand: true, renderPreset: 'studio' });
viewer.setPaused(!!document.querySelector('.assembly-dialog[open]'));
if (stale()) return;
const current = viewer = new RobotViewer($('stage'), { framing: 2.3, autoRotate: false, onDemand: true, renderPreset: 'studio' });
current.setPaused(!!document.querySelector('.assembly-dialog[open]'));
const loader = $('loader');
loader.classList.add('with-progress');
viewer.addEventListener('loading', () => { loader.classList.remove('hidden', 'error'); $('loader-text').textContent = '正在加载 URDF…'; });
@@ -235,22 +271,16 @@ async function setupViewer() {
if (e.detail.joint) tag.textContent = e.detail.joint;
tag.classList.toggle('show', !!e.detail.joint);
});
if (!project.robot) {
// 项目里没有 robot.json(没有 URDF 模型):不显示 3D 区域
$('stage').closest('section').hidden = true;
splashDone();
return;
}
const retry = document.createElement('button');
retry.type = 'button'; retry.className = 'btn btn-sm'; retry.textContent = '重新加载模型'; retry.hidden = true;
loader.querySelector('.loader-box').append(retry);
let loading = false;
const loadRobot = async () => {
if (loading) return;
if (loading || stale()) return;
loading = true; retry.hidden = true;
try { await viewer.load(project.robot); }
try { await current.load(project.robot); }
catch (err) {
if (err.name === 'AbortError') return;
if (stale() || err.name === 'AbortError') return;
console.error(err);
loader.classList.remove('hidden'); loader.classList.add('error');
$('loader-text').textContent = `URDF 未能加载:${err.message || '请检查网络连接'}`;
@@ -261,16 +291,17 @@ async function setupViewer() {
retry.addEventListener('click', loadRobot);
const reconnect = () => { if (!retry.hidden) loadRobot(); };
window.addEventListener('online', reconnect);
window.addEventListener('pagehide', (event) => {
if (event.persisted) return;
window.removeEventListener('online', reconnect); viewer.dispose();
}, { once: true });
stageCleanup = () => {
controller.abort();
window.removeEventListener('online', reconnect);
retry.remove();
};
loadRobot();
// 只展示模型:不播放演示动作、不自动旋转(不是所有模型都有关节映射,演示动作不一定对)
viewer.setMode('manual');
viewer.controls.autoRotate = false;
$('reset-view').addEventListener('click', () => viewer.resetPose());
$('reset-view').onclick = () => viewer?.resetPose();
}
// ---------- 概览:README ----------
+1 -7
View File
@@ -15,6 +15,7 @@ import { createStudioEnvironment, loadStudioHDR } from './studio-environment.js'
import { RenderBudget, RenderLoop } from './render-budget.js';
import { fetchResource, queueModelResource } from './resource-loading.js';
import { configureRobotViewerRenderer, createRobotViewerLights, createRobotViewerReflectionMap } from './robot-viewer-lighting.js';
import { disposeAssemblyObjects as disposeObject } from './assembly-memory.js';
export const ACCENT = '#c8ff3e';
const GRID_SPACING = 0.075;
@@ -757,13 +758,6 @@ export class RobotViewer extends EventTarget {
}
}
function disposeObject(obj) {
obj.traverse((o) => {
o.geometry?.dispose();
[].concat(o.material || []).forEach((m) => m.dispose?.());
});
}
// 离屏渲染缩略图(配置里没提供 thumbnail 时使用)
let thumbRenderer;
export async function renderThumbnail(config, width = 560, height = 350) {
+96
View File
@@ -0,0 +1,96 @@
import test from 'node:test';
import assert from 'node:assert/strict';
import * as THREE from 'three';
import { assemblyTextureLimit, textureDimensions, resizeAssemblyImage, fitAssemblyTextures, disposeAssemblyObjects } from '../js/assembly-memory.js';
import { readLimited } from '../js/experience-packages.js';
const bitmap = (width = 1024, height = 1024) => ({ width, height, closed: 0, close() { this.closed++; } });
const scene = (...textures) => {
const root = new THREE.Group();
for (const normalMap of textures) root.add(new THREE.Mesh(new THREE.BoxGeometry(), new THREE.MeshStandardMaterial({ color: 0xff6600, metalness: 0.7, roughness: 0.2, normalMap })));
return root;
};
test('a 243-file duck uses a bounded decoded and GPU texture budget on mobile', () => {
const limit = assemblyTextureLimit(243, true);
assert.equal(limit, 64);
const bytes = 266 * limit ** 2 * 4 * (1 + 4 / 3);
assert.ok(bytes < 16 * 1024 * 1024);
assert.deepEqual(textureDimensions(2048, 1024, 128), { width: 128, height: 64 });
assert.deepEqual(textureDimensions(32, 16, 128), { width: 32, height: 16 });
});
test('downsizes shared sources once without changing materials, geometry or placement', async () => {
const original = bitmap(), texture = new THREE.Texture(original), clone = texture.clone();
const root = scene(texture, clone); root.position.set(1, 2, 3);
const before = root.children.map(mesh => ({ geometry: mesh.geometry, material: mesh.material,
color: mesh.material.color.toArray(), normalScale: mesh.material.normalScale.toArray() }));
let calls = 0;
const stats = await fitAssemblyTextures(root, 128, { resize: async (_, w, h) => { calls++; return bitmap(w, h); } });
assert.equal(calls, 1); assert.equal(original.closed, 1);
assert.equal(texture.image, clone.image); assert.equal(texture.image.width, 128);
assert.equal(stats.beforeBytes / stats.afterBytes, 64);
root.children.forEach((mesh, i) => {
assert.equal(mesh.geometry, before[i].geometry); assert.equal(mesh.material, before[i].material);
assert.deepEqual(mesh.material.color.toArray(), before[i].color);
assert.deepEqual(mesh.material.normalScale.toArray(), before[i].normalScale);
assert.equal(mesh.material.metalness, 0.7); assert.equal(mesh.material.roughness, 0.2);
});
assert.deepEqual(root.position.toArray(), [1, 2, 3]);
disposeAssemblyObjects(root);
assert.equal(texture.image.closed, 1);
});
test('same bitmap in different sources stays alive until every source is replaced', async () => {
const original = bitmap(); const a = new THREE.Texture(original), b = new THREE.Texture(original);
let calls = 0;
await fitAssemblyTextures(scene(a, b), 128, { resize: async (image, w, h) => {
calls++; assert.equal(image.closed, 0); return bitmap(w, h);
} });
assert.equal(calls, 2); assert.equal(original.closed, 1);
});
test('close during texture resize releases the new bitmap and keeps cleanup possible', async () => {
const controller = new AbortController(), original = bitmap(), small = bitmap(128, 128);
const root = scene(new THREE.Texture(original));
await assert.rejects(fitAssemblyTextures(root, 128, { signal: controller.signal, resize: async () => {
controller.abort(); return small;
} }), { name: 'AbortError' });
assert.equal(small.closed, 1); assert.equal(original.closed, 0);
disposeAssemblyObjects(root); assert.equal(original.closed, 1);
});
test('WebKit ignoring ImageBitmap resize options falls back to an actually smaller canvas', async () => {
const originalCreate = globalThis.createImageBitmap, originalDocument = globalThis.document;
const unscaled = bitmap(); let drawn = false;
globalThis.createImageBitmap = async () => unscaled;
globalThis.document = { createElement: () => ({ width: 0, height: 0, getContext: () => ({ drawImage: () => { drawn = true; } }) }) };
try {
const result = await resizeAssemblyImage(bitmap(), 128, 64);
assert.equal(result.width, 128); assert.equal(result.height, 64);
assert.equal(unscaled.closed, 1); assert.equal(drawn, true);
} finally {
if (originalCreate) globalThis.createImageBitmap = originalCreate; else delete globalThis.createImageBitmap;
if (originalDocument) globalThis.document = originalDocument; else delete globalThis.document;
}
});
test('scene and template clones release each shared GPU resource and bitmap once', () => {
const image = bitmap(), root = scene(new THREE.Texture(image)), clone = root.clone(true);
const mesh = root.children[0], counts = { geometry: 0, material: 0, texture: 0 };
mesh.geometry.addEventListener('dispose', () => counts.geometry++);
mesh.material.addEventListener('dispose', () => counts.material++);
mesh.material.normalMap.addEventListener('dispose', () => counts.texture++);
disposeAssemblyObjects([root, clone]);
assert.deepEqual(counts, { geometry: 1, material: 1, texture: 1 }); assert.equal(image.closed, 1);
});
test('streaming GLBs preserves bytes for exact, missing, and incorrect length headers', async () => {
for (const length of [null, '5', '2', '8']) {
const response = new Response(new ReadableStream({ start(c) {
c.enqueue(new Uint8Array([1, 2, 3])); c.enqueue(new Uint8Array([4, 5])); c.close();
} }), { headers: length ? { 'Content-Length': length } : {} });
assert.deepEqual(await readLimited(response, 10), new Uint8Array([1, 2, 3, 4, 5]));
}
await assert.rejects(readLimited(new Response(new Uint8Array([1, 2, 3])), 2), /超过/);
});