fix: reduce assembly memory usage on mobile Safari
This commit is contained in:
@@ -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
@@ -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
@@ -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);
|
||||
|
||||
@@ -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
@@ -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
@@ -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) {
|
||||
|
||||
@@ -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), /超过/);
|
||||
});
|
||||
Reference in New Issue
Block a user