three.js的GUI使用

使用背景，不是每一次的事件按钮都要自己写button，可以放在GUI中进行展示。

导入：

 

额外的效果：

父元素线框模式：

描边：

 全部代码：

<script setup>
// 导入 threejs
import * as THREE from "three";
// 导入轨道控制器
import { OrbitControls } from "three/examples/jsm/controls/OrbitControls.js";
// 导入 GUI
import { GUI } from "three/examples/jsm/libs/lil-gui.module.min.js";

// 创建场景
const scene = new THREE.Scene();
// 创建相机
const camera = new THREE.PerspectiveCamera(
  45, // 视角
  window.innerWidth / window.innerHeight,
  0.1, // 近平面
  1000 // 远平面
);

// 创建渲染器
const renderer = new THREE.WebGLRenderer();
renderer.setSize(window.innerWidth, window.innerHeight);
document.body.appendChild(renderer.domElement);

// 创建几何体
const geometry = new THREE.BoxGeometry(1, 1, 1);
// 创建材质
const parent_material = new THREE.MeshBasicMaterial({ color: 0xff0000 }); // 红色几何体
const material = new THREE.MeshBasicMaterial({ color: 0x00ff00 }); // 绿色几何体

// 创建网格
const parent_cube = new THREE.Mesh(geometry, parent_material);
const cube = new THREE.Mesh(geometry, material);

parent_cube.add(cube);

parent_cube.position.x = -3;
cube.position.x = 3;
cube.scale.set(2, 2, 2);

// 将网格添加到场景中
scene.add(parent_cube);



// 描边  使用 EdgesGeometry
const edges = new THREE.EdgesGeometry(geometry);
const edgeMaterial = new THREE.LineBasicMaterial({ color: 0xffffff, linewidth: 2 }); // 白色边框
const edgeLines = new THREE.LineSegments(edges, edgeMaterial);

// 将线段添加到 cube 上
cube.add(edgeLines);


// 设置相机位置
camera.position.z = 5;
camera.position.x = 2;
camera.position.y = 2;
camera.lookAt(0, 0, 0);

// 添加坐标辅助器
const axesHelper = new THREE.AxesHelper(5);
scene.add(axesHelper);



// 轨道控制器
const controls = new OrbitControls(camera, renderer.domElement);
controls.update();

// 渲染函数
function animate() {
  requestAnimationFrame(animate);
  controls.update();
  renderer.render(scene, camera);
}
animate();

// 监听窗口变化
window.addEventListener("resize", () => {
  renderer.setSize(window.innerWidth, window.innerHeight);
  camera.aspect = window.innerWidth / window.innerHeight;
  camera.updateProjectionMatrix();
});

// 创建 lil-gui 控制面板
const gui = new GUI();

// 全屏功能
const fullscreenOptions = {
  enterFullscreen: () => {
    document.body.requestFullscreen();
  },
  exitFullscreen: () => {
    if (document.exitFullscreen) {
      document.exitFullscreen();
    } else if (document.mozCancelFullScreen) {
      document.mozCancelFullScreen();
    } else if (document.webkitExitFullscreen) {
      document.webkitExitFullscreen();
    } else if (document.msExitFullscreen) {
      document.msExitFullscreen();
    }
  }
};

// 在 GUI 中添加按钮
gui.add(fullscreenOptions, "enterFullscreen").name("全屏");
gui.add(fullscreenOptions, "exitFullscreen").name("退出全屏");

let folder = gui.addFolder('立方体位置');
folder.add(cube.position,"x").min(-10).max(10).step(1).name("立方体x轴位置")
folder.add(cube.position, "y").min(-10).max(10).step(1).name("立方体y轴位置")
folder.add(cube.position,"z").min(-10).max(10).step(1).name("立方体z轴位置")

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

</script>

<style>
* {
  margin: 0;
  padding: 0;
}

canvas {
  display: block;
  position: fixed;
  left: 0;
  top: 0;
  width: 100vw;
  height: 100vh;
}
</style>