Three Vue3Three Vue3
指南
在线演示
AI 智能体
  • English
  • 简体中文
GitHub
指南
在线演示
AI 智能体
  • English
  • 简体中文
GitHub
    • 快速开始
    • 场景
    • 参数总线
      • 默认用法
      • 方法
      • GlobalParameters
      • 自定义实例
    • 天空盒
    • 模型加载器

      • 组件加载器
      • 函数加载器
    • 弹出窗口
    • 标注
    • 动态元素
    • 动画
    • 模型旋转器
    • 拾取
    • 相机自适应
    • 网格模型

      • 波动圆
      • 流动线网格
    • 效果

      • 自然

        • 雨
        • 雪
        • 海洋水面
        • 互动水池
        • 沙滩漫步
      • 天空与大气

        • 天空穹顶
        • 高度雾
        • 星云星系
      • 光照

        • 泛光
        • 扫光
        • 灯光渐变
        • 光柱
        • 雷达扫描
        • 信号波
        • 力场护盾
      • 粒子与精灵

        • 烟花
        • 文字烟花
        • 光晕精灵
    • 地理

      • 地理参考系
      • GeoObject 地理对象
      • GeoJsonLayer 图层
      • 瓦片图层

类型

类

globalParameterBus 是一个用于场景级共享值的轻量存储。效果组件订阅某个键并响应变化,因此一次更新就能同时驱动天空穹顶、灯光以及其他监听者。内置的键是 sunDirection。

默认用法

点击我查看代码
<template>
  <div>
    <tv-scene class="scene" @created="created"></tv-scene>
    <label class="control">
      太阳高度角
      <input v-model.number="elevation" type="range" min="-5" max="70" step="1" />
    </label>
  </div>
</template>

<script lang="ts" setup>
import { onBeforeUnmount, ref, watch } from 'vue'
import * as THREE from 'three'
import { SkyDome, globalParameterBus } from 'three-vue3'

const elevation = ref(18)

let dome: SkyDome | undefined

const sunDirection = (degrees: number) => {
  const phi = THREE.MathUtils.degToRad(degrees)
  return new THREE.Vector3(Math.cos(phi), Math.sin(phi), 0.6).normalize()
}

const created = (scene, { camera }) => {
  camera.position.set(0, 2, 8)

  // 未传入 sunDirection,穹顶会跟随全局参数总线。
  dome = new SkyDome({ radius: 60 })
  scene.add(dome)

  globalParameterBus.set('sunDirection', sunDirection(elevation.value))
}

watch(elevation, (value) => {
  globalParameterBus.set('sunDirection', sunDirection(value))
})

onBeforeUnmount(() => {
  dome?.dispose()
  globalParameterBus.reset()
})
</script>

<style>
.scene {
  margin-top: 10px;
  width: 100%;
  height: 300px;
}

.control {
  display: flex;
  align-items: center;
  gap: 8px;
  margin-top: 8px;
  font-size: 14px;
}
</style>

方法

名称参数描述
get<K>(key: K) => GlobalParameters[K]返回当前值。
set<K>(key: K, value: GlobalParameters[K]) => void写入值并通知订阅者。
subscribe<K>(key: K, listener: (value) => void) => () => void订阅变化,返回取消订阅函数。
reset() => void恢复默认值。

GlobalParameters

名称类型默认值描述
sunDirectionTHREE.Vector3归一化后的 (-0.78, 0.2, -0.6)天空共享的太阳方向。

自定义实例

import { ParameterBus } from 'three-vue3'

const bus = new ParameterBus()
const unsubscribe = bus.subscribe('sunDirection', (direction) => {
  console.log(direction)
})
在 GitHub 上编辑此页
Last Updated:
Contributors: Shing Rui
Prev
场景
Next
天空盒