Skip to content

create3dApp

创建一个 Three.js WebGPU 应用实例。每次调用返回独立实例,支持同页面多实例。

用法

ts
import { create3dApp } from '@threeuse/core'

const app = create3dApp({
  antialias: true,
  camera: { fov: 75, position: [0, 0, 5] },
})

app.mount('#canvas-container')

参数

参数类型默认值说明
antialiasbooleantrue抗锯齿
alphabooleanfalse透明背景
forceWebGLboolean | undefinedundefined强制使用 WebGL
cameraPartial<CameraOptions>相机初始参数
autoResizebooleantrue自动监听容器尺寸变化

返回值

ThreeUseApp 对象,包含:

  • renderer — WebGPURenderer 实例
  • scene — Three.js Scene
  • camera — PerspectiveCamera
  • canvas — renderer.domElement
  • mount(container) — 挂载到 DOM,启动渲染循环
  • unmount() — 停止循环,清理资源
  • use(plugin) — 安装插件,支持链式调用
  • on/emit/off — 发布订阅
  • onBeforeRender/onAfterRender — 渲染回调
  • globalProperties — 插件挂载点(app.$xxx
  • config.errorHandler / config.warnHandler — 自定义错误/警告处理

Demo

Released under the MIT License.