Three.js 本地模型加载教程

发布时间:2026/7/3 2:31:09
Three.js 本地模型加载教程 本地模型加载 ·Local Model· ▶ 在线运行案例案例合集三维可视化功能案例threehub.cn开源仓库github地址https://github.com/z2586300277/three-cesium-examples400个案例代码:网盘链接你将学到什么OrbitControls 相机轨道交互glTF/Draco 模型加载与优化requestAnimationFrame渲染循环与resize自适应效果说明本案例演示本地模型加载效果基于 WebGL 实现「本地模型加载」可视化效果附完整可运行源码核心用到 OrbitControls、glTF/Draco。建议先打开文首在线案例查看动态画面再对照下方源码逐步理解。核心概念Scene / Camera / WebGLRenderer构成最小渲染闭环大场景可开logarithmicDepthBuffer缓解 Z-fighting。OrbitControls提供轨道旋转/缩放开启enableDamping后需在 animate 中controls.update()。阅读下方完整源码时建议从init/load/animate三条主线入手再深入 shader 与工具函数。实现步骤搭建 Scene、PerspectiveCamera、WebGLRenderer挂载 canvas 并处理resize异步加载模型 / 3D Tiles / GeoJSON 等资源并加入 scene 或 entities创建 OrbitControls及 Raycaster 等交互控件若源码包含在requestAnimationFrame循环中更新状态并 renderCesium 为viewer.render或自动渲染代码要点import * as THREE from threeimport { OrbitControls } from three/examples/jsm/controls/OrbitControls.js import { GLTFLoader } from three/examples/jsm/loaders/GLTFLoader.js import { DRACOLoader } from three/examples/jsm/loaders/DRACOLoader.jsconst box document.getElementById(box)const scene new THREE.Scene()const camera new THREE.PerspectiveCamera(50, box.clientWidth / box.clientHeight, 0.1, 10000000)camera.position.set(10, 10, 10)const renderer new THREE.WebGLRenderer({ antialias: true, alpha: true, logarithmicDepthBuffer: true })renderer.setSize(box.clientWidth, box.clientHeight)box.appendChild(renderer.domElement)const controls new OrbitControls(camera, renderer.domElement)controls.enableDamping truescene.add(new THREE.AxesHelper(500), new THREE.AmbientLight(0xffffff, 2))animate()function animate() {requestAnimationFrame(animate)controls.update()renderer.render(scene, camera)}window.onresize () {renderer.setSize(box.clientWidth, box.clientHeight)camera.aspect box.clientWidth / box.clientHeightcamera.updateProjectionMatrix()}// 文件地址 const urls [0, 1, 2, 3, 4, 5].map(k (FILE_HOST files/sky/skyBox0/ (k 1) .png));const textureCube new THREE.CubeTextureLoader().load(urls);scene.background textureCube;// 创建一个文件上传的输入框 const input document.createElement(input) input.type file input.accept .glb Object.assign(input.style, { position: absolute, top: 30px, left: 100px, zIndex: 9999 }) input.onchange (e) { const file e.target.files[0] const url URL.createObjectURL(file) new GLTFLoader().setDRACOLoader(new DRACOLoader().setDecoderPath(FILE_HOST js/three/draco/)).load(url, (gltf) { gltf.scene.traverse((child) { if (child?.material) child.material.envMap textureCube }) scene.add(gltf.scene)// 主视图 const box3 new THREE.Box3().setFromObject(gltf.scene) const center box3.getCenter(new THREE.Vector3()) const size box3.getSize(new THREE.Vector3()) const maxDim Math.max(size.x, size.y, size.z) const fov camera.fov * (Math.PI / 180) const distance (maxDim / 2) / Math.tan(fov / 2) camera.position.set(center.x, center.y, center.z distance size.z / 2) camera.lookAt(center) controls.target.copy(center) controls.update()}) URL.revokeObjectURL(url) } document.body.appendChild(input)完整源码GitHub小结本文提供本地模型加载完整 Three.js 源码与在线 Demo建议先运行案例再改 uniform/参数做二次实验更多 Three.js 实战案例见 three-cesium-examples 合集 与 GitHub 开源仓库