#!/usr/bin/env python3 """Emit a fully-offline single-file HTML viewer for a building/campus GLB. Use when the deliverable must open by double-click with NO server and NO network (mainland-China CDNs are unreliable; jsdelivr-importing viewers hang on the loading screen). Everything is inlined: three r147 UMD + OrbitControls + GLTFLoader + RoomEnvironment + pako, plus the GLB itself gzip-compressed (browser-side pako inflate; ~5x smaller than raw base64 embedding). Features: ACES tone mapping, RoomEnvironment IBL, PCF soft shadows + ground shadow catcher, physical-glass glazing, instanced low-poly street trees (from a TREES floor), grouped floor toggles (SITE/CTX* -> 场地, leading-digit keys -> N#, rest -> 主体), category toggles, click-to-inspect, on-screen error reporting (never a silent spinner). The official template (assets/web-showcase-template) remains the primary delivery for served deployments; this is the share-by-file variant. Usage: python3 write_offline_viewer.py --spec building_spec.json --glb model.glb \ --out viewer.html [--title 项目名] [--libs-dir /assets/offline-viewer-libs] """ from __future__ import annotations import argparse import base64 import gzip import html as html_lib import json import struct from pathlib import Path import showcase_schema SKILL_ROOT = Path(__file__).resolve().parent.parent def parse_args() -> argparse.Namespace: p = argparse.ArgumentParser(description=__doc__) p.add_argument("--spec", required=True) p.add_argument("--glb", required=True) p.add_argument("--out", required=True) p.add_argument("--title", default=None) p.add_argument("--subtitle", default="离线单文件查看器") p.add_argument("--libs-dir", default=str(SKILL_ROOT / "assets" / "offline-viewer-libs")) return p.parse_args() def group_of(key: str) -> str: if key in ("SITE", "ROADS", "FENCE", "TREES") or key.startswith("CTX"): return "场地" if key[:1].isdigit(): return key[0] + "#" return "主体" def glb_extensions(path: Path) -> set[str]: """Return extensionsUsed from the GLB JSON chunk without extra dependencies.""" data = path.read_bytes() if len(data) < 20 or data[:4] != b"glTF": raise SystemExit(f"Not a valid GLB: {path}") chunk_length, chunk_type = struct.unpack_from(" len(data): raise SystemExit(f"GLB JSON chunk is missing or truncated: {path}") document = json.loads(data[20 : 20 + chunk_length].decode("utf-8").rstrip("\x00 \t\r\n")) return set(document.get("extensionsUsed", [])) def script_json(value) -> str: """Serialize JSON for an inline script without allowing an early script close.""" return json.dumps(value, ensure_ascii=False).replace(" { $load.style.display='flex'; $load.textContent = '加载失败:'+m; }; window.addEventListener('error', e => fail(e.message)); window.addEventListener('unhandledrejection', e => fail(e.reason && e.reason.message || e.reason)); try { const GROUPS = __GROUPS__, CATS = __CATS__, TREES = __TREES__; const renderer = new THREE.WebGLRenderer({antialias:true}); renderer.setSize(innerWidth,innerHeight); renderer.setPixelRatio(Math.min(devicePixelRatio,2)); renderer.toneMapping = THREE.ACESFilmicToneMapping; renderer.toneMappingExposure = 1.05; renderer.outputEncoding = THREE.sRGBEncoding; renderer.physicallyCorrectLights = true; renderer.shadowMap.enabled = true; renderer.shadowMap.type = THREE.PCFSoftShadowMap; renderer.shadowMap.autoUpdate = false; renderer.shadowMap.needsUpdate = true; // static scene: bake shadows on change only document.body.appendChild(renderer.domElement); const scene = new THREE.Scene(); scene.background = new THREE.Color(0x23272d); scene.fog = new THREE.Fog(0x23272d, 500, 1400); const pmrem = new THREE.PMREMGenerator(renderer); scene.environment = pmrem.fromScene(new THREE.RoomEnvironment(), 0.04).texture; const cam = new THREE.PerspectiveCamera(48, innerWidth/innerHeight, 0.5, 4000); const controls = new THREE.OrbitControls(cam, renderer.domElement); controls.enableDamping = true; // Render on demand: identical frames at 60fps peg the GPU/fans on a static scene. let renderPending = true; window.__renders = 0; const invalidate = (shadows) => { if (shadows) renderer.shadowMap.needsUpdate = true; renderPending = true; }; controls.addEventListener('change', () => invalidate()); const sun = new THREE.DirectionalLight(0xfff3e0, 3.2); sun.position.set(-120, 180, 140); sun.castShadow = true; sun.shadow.mapSize.set(2048,2048); sun.shadow.bias = -0.0004; scene.add(sun); scene.add(new THREE.AmbientLight(0xdfe8ff, 0.5)); $load.textContent = '正在解压模型…'; await new Promise(r => setTimeout(r, 30)); const bin = atob(GLB_B64); const gz = new Uint8Array(bin.length); for (let i=0;i { $load.remove(); const root = g.scene; scene.add(root); const bb = new THREE.Box3().setFromObject(root); const c = bb.getCenter(new THREE.Vector3()), sz = bb.getSize(new THREE.Vector3()); const radius = Math.max(sz.x, sz.z, 20) * 0.75; sun.target.position.copy(c); scene.add(sun.target); const sc = sun.shadow.camera; sc.left=-radius; sc.right=radius; sc.top=radius; sc.bottom=-radius; sc.near=5; sc.far=radius*6; sc.updateProjectionMatrix(); controls.target.copy(c); cam.position.set(c.x + sz.x*0.55, c.y + Math.max(sz.x,sz.z)*0.5, c.z + sz.z*1.25); const ground = new THREE.Mesh(new THREE.PlaneGeometry(radius*8, radius*8), new THREE.ShadowMaterial({opacity:0.35})); ground.rotation.x = -Math.PI/2; ground.position.set(c.x, -0.02, c.z); ground.receiveShadow = true; scene.add(ground); const nodes = []; root.traverse(o => { if (!o.isMesh) return; nodes.push(o); const parts = (o.name||'').split('__'), fk = parts[0], cat = parts[1]; if (cat === 'glazing') { o.material = new THREE.MeshPhysicalMaterial({color:0x9fd4e8, metalness:0, roughness:0.18, transmission:0.72, ior:1.5, thickness:0.3, transparent:true, depthWrite:false, side:THREE.DoubleSide}); o.material.envMapIntensity = 1.2; } else if (['walls','columns','roof','slab','railings'].indexOf(cat)>=0 && fk!=='SITE') { o.castShadow = true; o.receiveShadow = true; } if (cat === 'trees') o.visible = false; }); window.__offlineReady = {meshes:nodes.length}; if (TREES.length) { const ti = new THREE.InstancedMesh(new THREE.CylinderGeometry(0.14,0.2,1.4,6), new THREE.MeshStandardMaterial({color:0x6b4a2e, roughness:0.9}), TREES.length); const ci = new THREE.InstancedMesh(new THREE.IcosahedronGeometry(1.5,1), new THREE.MeshStandardMaterial({color:0x3e7d4f, roughness:0.8}), TREES.length); const m4 = new THREE.Matrix4(); for (let i=0;i { nodes.forEach(o => { const p=(o.name||'').split('__'); o.visible = (state.fl[p[0]]!==false) && (state.ct[p[1]]!==false) && p[1]!=='trees'; }); invalidate(true); }; for (const gname in GROUPS) { const head = document.createElement('div'); head.className='grp'; const btn = document.createElement('button'); btn.textContent='开/关'; let on = true; btn.onclick = () => { on=!on; GROUPS[gname].forEach(f => { state.fl[f[0]]=on; const cb=document.getElementById('cb_'+f[0]); if(cb) cb.checked=on; }); apply(); }; head.appendChild(document.createTextNode(gname)); head.appendChild(btn); tg.appendChild(head); GROUPS[gname].forEach(f => { const l = document.createElement('label'); const input = document.createElement('input'); input.id='cb_'+f[0]; input.type='checkbox'; input.checked=true; input.onchange = e => { state.fl[f[0]]=e.target.checked; apply(); }; l.appendChild(input); l.appendChild(document.createTextNode(' '+f[0]+' '+f[1])); tg.appendChild(l); }); } const head2 = document.createElement('div'); head2.className='grp'; head2.textContent = '构件'; tg.appendChild(head2); const used = {}; nodes.forEach(o => used[(o.name||'').split('__')[1]] = 1); for (const k in CATS) { if (!used[k] || k==='trees') continue; const l = document.createElement('label'); const input = document.createElement('input'); input.type='checkbox'; input.checked=true; input.onchange = e => { state.ct[k]=e.target.checked; apply(); }; l.appendChild(input); l.appendChild(document.createTextNode(' '+CATS[k])); tg.appendChild(l); } const ray = new THREE.Raycaster(), ptr = new THREE.Vector2(), info = document.getElementById('info'); let hi=null, hiMat=null, downAt=null; addEventListener('pointerdown', e => downAt=[e.clientX,e.clientY]); addEventListener('pointerup', e => { if (!downAt || Math.hypot(e.clientX-downAt[0], e.clientY-downAt[1])>4) return; ptr.x=(e.clientX/innerWidth)*2-1; ptr.y=-(e.clientY/innerHeight)*2+1; ray.setFromCamera(ptr, cam); const hit = ray.intersectObjects(nodes.filter(o=>o.visible), false)[0]; if (hi) { hi.material = hiMat; hi = null; invalidate(); } if (!hit) { info.style.display='none'; return; } hi = hit.object; hiMat = hi.material; hi.material = hiMat.clone(); hi.material.emissive = new THREE.Color(0x2a6bd4); hi.material.emissiveIntensity = 0.55; const p = (hi.name||'').split('__'); let fname=''; for (const gname in GROUPS) GROUPS[gname].forEach(f => { if (f[0]===p[0]) fname=f[1]; }); info.replaceChildren(); const strong=document.createElement('b'); strong.textContent=p[0]; info.appendChild(strong); info.appendChild(document.createTextNode(' '+fname)); info.appendChild(document.createElement('br')); info.appendChild(document.createTextNode('构件:'+(CATS[p[1]]||p[1])+' 节点:'+hi.name)); info.style.display = 'block'; invalidate(); }); invalidate(true); renderer.setAnimationLoop(() => { const moved = controls.update(); if (moved || renderPending) { renderer.render(scene, cam); window.__renders += 1; renderPending = false; } }); }, e => fail('GLB 解析错误 '+(e && e.message || e))); addEventListener('resize', () => { cam.aspect=innerWidth/innerHeight; cam.updateProjectionMatrix(); renderer.setSize(innerWidth,innerHeight); invalidate(); }); } catch (err) { fail(err.message || String(err)); } })(); """ CSS = ( 'body{margin:0;background:#1c1f24;color:#e8e6e0;font:14px/1.5 -apple-system,"PingFang SC",sans-serif;overflow:hidden}' "#panel{position:fixed;top:12px;left:12px;background:rgba(244,241,232,.97);color:#2a2a26;border-radius:12px;padding:12px 14px;width:242px;max-height:92vh;overflow:auto;box-shadow:0 4px 18px rgba(0,0,0,.45);z-index:5}" "#panel h1{font-size:15px;margin:0 0 2px}" "#panel .sub{font-size:12px;color:#777;margin-bottom:6px}" "#panel label{display:flex;gap:6px;align-items:center;font-size:13px;padding:1px 0;cursor:pointer}" ".grp{border-top:1px solid #ddd;margin-top:8px;padding-top:6px;font-weight:600;font-size:12px;color:#555;display:flex;justify-content:space-between;align-items:center}" ".grp button{font-size:11px;border:none;background:#e5e0d2;border-radius:6px;padding:1px 8px;cursor:pointer}" "#info{position:fixed;bottom:14px;left:14px;background:rgba(30,33,38,.92);border:1px solid #3a3f46;color:#e8e6e0;border-radius:10px;padding:8px 12px;font-size:13px;display:none;max-width:340px;z-index:5}" "#hint{position:fixed;bottom:10px;right:14px;font-size:12px;color:#9aa;z-index:5}" "#load{position:fixed;inset:0;display:flex;align-items:center;justify-content:center;color:#cfd3c9;font-size:14px;background:#1c1f24;z-index:9}" ) def main() -> int: args = parse_args() spec_path = Path(args.spec) glb_path = Path(args.glb) if not glb_path.exists() or glb_path.stat().st_size == 0: raise SystemExit(f"GLB not found or empty: {glb_path}") extensions = glb_extensions(glb_path) if "KHR_draco_mesh_compression" in extensions: raise SystemExit( "Offline single-file viewer requires an uncompressed GLB; " f"KHR_draco_mesh_compression found in {glb_path}. Pass the matching *.raw.glb instead." ) spec = showcase_schema.normalize_spec(json.loads(spec_path.read_text(encoding="utf-8"))) try: showcase_schema.validate_spec(spec) except showcase_schema.ValidationFailure as exc: raise SystemExit(str(exc)) from exc libs = Path(args.libs_dir) parts = {} for name in ("three.min.js", "OrbitControls.js", "GLTFLoader.js", "RoomEnvironment.js", "pako_inflate.min.js"): path = libs / name if not path.exists(): raise SystemExit( f"Missing offline lib {path}. Populate via: npm pack three@0.147.0 pako@2.1.0 and copy files." ) parts[name] = path.read_text(encoding="utf-8") assert "" not in parts[name] glb = glb_path.read_bytes() b64 = base64.b64encode(gzip.compress(glb, 6)).decode() order = spec.get("source", {}).get("config", {}).get("floor_order") or list(spec.get("floors", {})) groups: dict = {} for key in order: if key in spec.get("floors", {}): groups.setdefault(group_of(key), []).append([key, spec["floors"][key].get("name", key)]) trees = [ [round((s["start"][0] + s["end"][0]) / 2, 2), round((s["start"][1] + s["end"][1]) / 2, 2)] for s in spec.get("floors", {}).get("TREES", {}).get("segments", {}).get("trees", []) ] cats = {k: v.get("label", k) for k, v in spec.get("categories", {}).items()} title = str(args.title or spec.get("project", {}).get("name", "CAD 建筑模型")) escaped_title = html_lib.escape(title, quote=True) escaped_subtitle = html_lib.escape(str(args.subtitle), quote=True) main_js = ( MAIN_JS.replace("__GROUPS__", script_json(groups)) .replace("__CATS__", script_json(cats)) .replace("__TREES__", script_json(trees)) ) sc_close = "" html = ( '' f"{escaped_title} · 3D 查看器(离线版)" '' f"" '
正在初始化…
' f'

{escaped_title}

{escaped_subtitle}
' '
' '
拖动旋转 · 滚轮缩放 · 右键平移 · 点击构件查属性
' + "".join( f"