three.js-結合dat.gui實現介面視覺化修改及偵錯詳解

pnpm i dat.gui

import * as Dat from "dat.gui";

/// 建立 dat
const dat = new Dat.GUI();

/// 新增選單
function addMenuItem () {
    // x 軸座標
    dat
    .add(cube.position, 'x')
    .max(10)
    .min(0)
    .step(0.01)
    .name('移動x軸')
    .onChange(value => {
        console.log('我是當前正在移動的x軸', value);
    })
    .onFinishChange(value => {
        console.log('我是當前移動結束的x軸', value);
    })
}
// 新增選單
addMenuItem ()

import * as THREE from "three"
// 目標：使用 dat.gui 進行 視覺化偵錯
import * as Dat from "dat.gui";
/// 建立場景
const scene = new THREE.Scene()
/// 建立 dat
const dat = new Dat.GUI();
/// 建立相機
/*
    PerspectiveCamera( fov : Number, aspect : Number, near : Number, far : Number )
        fov — 攝像機視錐體垂直視野角度
        aspect — 攝像機視錐體長寬比
        near — 攝像機視錐體近端面
        far — 攝像機視錐體遠端面
*/
/// 透視相機
const camera = new THREE.PerspectiveCamera(
    75, // 攝像機視錐體垂直視野角度，從檢視的底部到頂部，以角度來表示。預設值是50。
    window.innerWidth / window.innerHeight, // 攝像機視錐體的長寬比，通常是使用畫布的寬/畫布的高。預設值是1（正方形畫布）。
    0.1, // 攝像機的近端面，預設值是0.1。
    1000 // 攝像機的遠端面，預設值 2000
)
/// 建立渲染器
const renderer = new THREE.WebGLRenderer();
/// 設定大小
renderer.setSize(
    1000, // 寬度
    500 // 高度
);
/// 掛載到頁面
document.body.appendChild(renderer.domElement)
/// 新增物體
/*
    width:立方體x軸的長度,
    height:立方體y軸的長度,
    depth:立方體z軸的長度也是深度
*/
let geometry = new THREE.BoxGeometry(10, 10, 10);
/// 新增材質
// const material = new THREE.MeshBasicMaterial({ color: 0xffff0000 });
/// 新增材質
const materials = []
for(let i = 0; i < 6; i++){
    materials.push(new THREE.MeshBasicMaterial({ color: Math.random() * 0x00ff0000 }))
}
/// 新增網格
const cube = new THREE.Mesh( geometry, materials );
scene.add( cube );
// 設定相機位置
camera.position.z = 50;
// 修改場景背景顏色
scene.background = new THREE.Color(0xffffcc99)
/// 新增 三色座標軸
const axesHelper = new THREE.AxesHelper(20)
scene.add( axesHelper )
/// 渲染
function animate() {
    // 使用 requestAnimationFrame 執行動畫
    requestAnimationFrame(animate)
    // 修改其旋轉的度數，讓其每次渲染增加0.01的弧段進行渲染
    cube.rotation.x += 0.01;
	cube.rotation.y += 0.01;
    //scene:前面定義的場景,camera:前面定義的相機
    //renderTarget:渲染的目標預設是是渲染到前面定義的render變數中
    //forceClear:每次繪製之前都將畫布的內容給清除,即使自動清除標誌autoClear為false,也會清除
    renderer.render(scene, camera)
}    
/// 新增選單
function addMenuItem () {
    // x 軸座標
    dat
    .add(cube.position, 'x')
    .max(10)
    .min(0)
    .step(0.01)
    .name('移動x軸')
    .onChange(value => {
        console.log('我是當前正在移動的x軸', value);
    })
    .onFinishChange(value => {
        console.log('我是當前移動結束的x軸', value);
    })
}
// 渲染
animate()
// 新增選單
addMenuItem ()