lil-gui调试开发3D效果

lil-gui

lii-gui 为web上的控制器创建一个浮动面板,它可以作为数据的临时替代品。方便用户通过界面组件来控制场景中的物体,大大提高开发调试效率。

使用效果会在当前页面的右上角固定一个浮动面板,截图如下:

使用

在上文《初识threejs - 你的第一个3D应用》的基础上,我们可以添加 lil-gui,来快速修改指定参数。

引入

three 内置了该插件,不需要额外安装。

js 复制代码
import { GUI } from "three/examples/jsm/libs/lil-gui.module.min.js";

新建

js 复制代码
const gui = new GUI();

创建按钮

js 复制代码
gui.add(eventObj, "Fullscreen").name("全屏");
gui.add(eventObj, "ExitFullscreen").name("退出全屏");

修改数值

js 复制代码
let folder = gui.addFolder("立方体位置");
folder
  .add(cube.position, "x")
  .min(-10)
  .max(10)
  .step(1)
  .name("立方体x轴位置")
  .onChange((val) => {
    console.log(val);
  });
folder
  .add(cube.position, "y")
  .min(-10)
  .max(10)
  .step(1)
  .name("立方体y轴位置")
  .onFinishChange((val) => {
    console.log(val);
  });
folder.add(cube.position, "z").min(-10).max(10).step(1).name("立方体z轴位置");

复选框

上面的动画效果可以发现,移动子元素的 y 轴方向运动,子元素立方体并没有沿着 y 轴方向运行,还是按照倾斜了45° 的父元素的 y 轴方向运动。

这里为了调试方便,将父元素的材质更改为线框模式。

js 复制代码
parent_material.wireframe = true;

那对于布尔值,lit-gui 会自动识别采用复选框。

js 复制代码
gui.add(parent_material, "wireframe").name("父元素线框模式");

颜色选择器

js 复制代码
let colorParams = {
  cubeColor: 80000000,
};
gui
  .addColor(colorParams, "cubeColor")
  .name("立方体颜色")
  .onChange((val) => {
    cube.material.color.set(val);
  });

完整代码如下:

js 复制代码
const gui = new GUI();
gui.add(eventObj, "Fullscreen").name("全屏");
gui.add(eventObj, "ExitFullscreen").name("退出全屏");
let folder = gui.addFolder("立方体位置");
folder
  .add(cube.position, "x")
  .min(-10)
  .max(10)
  .step(1)
  .name("立方体x轴位置")
  .onChange((val) => {
    console.log(val);
  });
folder
  .add(cube.position, "y")
  .min(-10)
  .max(10)
  .step(1)
  .name("立方体y轴位置")
  .onFinishChange((val) => {
    console.log(val);
  });
folder.add(cube.position, "z").min(-10).max(10).step(1).name("立方体z轴位置");

gui.add(parent_material, "wireframe").name("父元素线框模式");

let colorParams = {
  cubeColor: "#c4b400",
};
gui
  .addColor(colorParams, "cubeColor")
  .name("立方体颜色")
  .onChange((val) => {
    cube.material.color.set(val);
  });

最后

更多细节可以参考官方文档:lil-gui.georgealways.com/

注:本文首发微信公众号【前端一起学】,里面有持续更新的Vue源码实战专栏,Electron实战,Three.js入门教程等,还有更多前端基础知识超详细总结,欢迎关注。

相关推荐
锋行天下1 小时前
langgraph 全栈项目(三)
前端·人工智能·后端
锋行天下2 小时前
langgraph 全栈项目(二)
前端·人工智能·后端
锋行天下3 小时前
langgraph全栈项目(一)
前端·人工智能·后端
叼烟扛炮4 小时前
[LangChain] 学习笔记(15):为什么你的重试没用——429、抖动、fallback 与熔断
java·服务器·前端
小码哥0684 小时前
智慧物业系统源码定制:公告发布范围与住户阅读记录设计
前端·javascript·vue.js·物业管理·物业系统·物业软件
泯泷7 小时前
Cloudflare 出手抢 Astro:前端框架之战,底层逻辑变了
前端·javascript·前端框架
狮子座的男孩8 小时前
html+css基础:31、响应式布局(媒体类型,媒体特性,运算符,常用阈值)
前端·css·经验分享·html·响应式布局·媒体类型/特性·常用阈值
鲸鹏芯海微电子科技 (上海) 有限公司9 小时前
手机直连卫星,射频前端到底要解决什么?
前端·智能手机·低轨卫星·謓泽·鲸鹏芯海·毫米波射频·相控阵芯片
Flynt9 小时前
npm run dev --host 有风险?我把 Vite 这个 9.1 分漏洞复现了一遍
前端·vite