咖啡

Coffee Mug

▶ 在线运行案例

你将学到什么

• Scene / Camera / Renderer 渲染管线
• 相机交互控制器
• 外部模型 / 3D Tiles 加载
• ShaderMaterial / RawShaderMaterial 自定义 GLSL
• GUI 参数调试面板

效果说明

Three.js WebGL 场景，加载外部模型，以自定义 shader 呈现核心视觉效果，技术点：顶点着色器、片元着色器、uniform 驱动。打开在线案例可查看最终画面。

核心概念

• Scene 容纳对象，Camera 定义视点，WebGLRenderer 输出 canvas。
• OrbitControls 轨道旋转缩放；开启阻尼时每帧 controls.update()。
• 异步 Loader 返回 scene 或 tileset；注意 scale、坐标系与 modelMatrix 贴地。
• ShaderMaterial 自定义 uniforms + vertex/fragment；RawShaderMaterial 需手写全部 shader 声明。
• dat.GUI / lil-gui 绑定 uniform 或配置对象实时调参。

实现步骤

1. 初始化 Viewer 或 Scene / Camera / Renderer
2. 创建 OrbitControls 并处理 resize
3. Loader 加载资源并加入 scene / entities / primitives
4. 定义 uniforms，在 rAF 中更新并 render
5. gui.add 绑定可调参数

代码要点

// Create scene
    const scene = new THREE.Scene();

    // Create camera
    const camera = new THREE.PerspectiveCamera(
        35,
        window.innerWidth / window.innerHeight,
        0.1,
        1000,

    // Create camera
    const camera = new THREE.PerspectiveCamera(
        35,
        window.innerWidth / window.innerHeight,
        0.1,
        1000,
    );
    camera.position.z = 110;


    // Create renderer
    const renderer = new THREE.WebGLRenderer({ antialias });
    renderer.setSize(window.innerWidth, window.innerHeight);
    // renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2));
    const controls = new OrbitControls(camera, renderer.domElement);
    controls.enableDamping = true;
    root.appendChild(renderer.domElement);

    const onWindowResize = () => {

完整源码：GitHub

小结

• 建议先在 在线案例 运行，再对照源码修改 uniform / 参数加深理解

• 上一篇：矩阵操作

• 下一篇：光柱

应用场景 · Three.js · 28/68