Three Vue3Three Vue3
指南
在线演示
AI 智能体
  • English
  • 简体中文
GitHub
指南
在线演示
AI 智能体
  • English
  • 简体中文
GitHub
    • 快速开始
    • 场景
    • 参数总线
    • 天空盒
    • 模型加载器

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

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

      • 自然

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

        • 天空穹顶
          • 默认用法
          • 选项
          • 方法
        • 高度雾
        • 星云星系
      • 光照

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

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

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

类型

类

SkyDome 是一个带低角度太阳的渐变天空球:从地平线到天顶的四段色带、一圈宽光晕以及一个圆形太阳。它使用 TSL 节点材质,因此同一个类既能运行在 WebGPU 渲染器上,也能通过 WebGLNodesHandler 运行在 WebGL 上。

未传入 sunDirection 时,穹顶会跟随 globalParameterBus,因此更新全局太阳方向就会自动更新天空。

默认用法

点击我查看代码
<template>
  <tv-scene class="scene" bg-color="rgb(40, 42, 54)" @created="created"></tv-scene>
</template>

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

let dome: SkyDome | undefined

const created = (scene, { camera }) => {
  camera.position.set(0, 0.8, 7)
  camera.lookAt(0, 0.8, 0)

  // 一个共享的太阳方向驱动场景内的所有效果。
  globalParameterBus.set('sunDirection', new THREE.Vector3(-0.78, 0.2, -0.6))

  dome = new SkyDome()
  scene.add(dome)
}

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

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

选项

名称类型默认值描述
radiusnumber420可选 穹顶球半径。
horizonColornumber0xf27536可选 地平线色带的颜色。
lowerSkyColornumber0x803624可选 地平线稍上方的颜色。
upperSkyColornumber0x260f13可选 中间色带的颜色。
zenithColornumber0x060409可选 天顶的颜色。
sunDirection[number, number, number]来自参数总线可选 太阳方向,内部会归一化。
glowColornumber0xff9947可选 太阳光晕的颜色。
sunColornumber0xffe0b8可选 太阳圆盘的颜色。
sunIntensitynumber2.4可选 太阳圆盘的亮度倍数。
sunSizenumber10可选 太阳圆盘的角直径(度)。
segmentsnumber48可选 球体的水平分段数。

方法

名称参数描述
setSunDirection(direction: THREE.Vector3 | [number, number, number]) => void让穹顶朝向新的太阳方向。
dispose() => void取消订阅并释放几何体与材质。
在 GitHub 上编辑此页
Last Updated:
Contributors: Shing Rui
Next
高度雾