【Threejs】从零开始（六）--GUI调试开发3D效果

请先完成前置步骤再进行下面操作：【Threejs】从零开始（一）--创建threejs应用-CSDN博客

一.GUI界面概述

GUI（Graphical User Interface）指的是图形化用户界面，广泛用在各种程序的上位机，能够通过简单的操作和按钮就可以调用底层代码，方便我们使用和展示结果。写好了底层的代码后我们就可以制作一个GUI界面来打包和展示。

简单来说就是功能的一个集合模块。

二.GUI的简单使用

1.导入GUI

import {GUI} from 'three/examples/jsm/libs/lil-gui.module.min.js'  // 导入GUI

2.创建GUI

const gui = new GUI();

3.控制立方体位置的控制器

gui.add(cube.position, 'x', 最小值,最大值, 步数).name('立方体X位置');

onFinishChange是当你滑动结束时执行一次函数，可以输出滑动的结果。

onChange是数值改变时执行一次函数，可以输出滑动的结果。

//控制立方体位置
gui.add(cube.position, 'x', -5, 5, 1).name('立方体X位置');
gui.add(cube.position, 'y', -5, 5, 1).name('立方体Y位置').onFinishChange((val) => {
  console.log('立方体Y位置',val)
})
;
gui.add(cube.position, 'z', -5, 5, 1).name('立方体Z位置').onChange((val) => {
  console.log('立方体Z位置',val)
})
;

4.添加文件夹（归类）

通过addFolder（）方法可以将同一类型的放到同一个文件下，方便管理。

//创建文件夹
let folder = gui.addFolder('立方体位置');
//控制立方体位置
folder.add(cube.position, 'x', -5, 5, 1).name('立方体X位置');
folder.add(cube.position, 'y', -5, 5, 1).name('立方体Y位置').onFinishChange((val) => {
  console.log('立方体Y位置',val)
});
folder.add(cube.position, 'z', -5, 5, 1).name('立方体Z位置').onChange((val) => {
  console.log('立方体Z位置',val)
});

5.调用方法

比如想实现全屏展示和退出全屏。

先创建个数组：

let eventObject = {
  fullscreen:function(){
    document.body.requestFullscreen()
  },
  exitFullscreen:function(){
    document.exitFullscreen()
  },
}

调用：

// 创建gui
const gui = new GUI();
gui.add(eventObject,'fullscreen').name('全屏')
gui.add(eventObject,'exitFullscreen').name('退出全屏')

比如控制立方体颜色：

//控制立方体颜色
let colorParms = {
  color: 0x00ff00
}
folder.addColor(colorParms, 'color').name('立方体颜色').onChange((val) => {
  cube.material.color.set(val)
})

控制立方体材质：

//控制立方体材质
folder.add(parentMaterial,'wireframe' ).name('父元素立方体材质');