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

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

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

      • 自然

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

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

        • 泛光
        • 扫光
        • 灯光渐变
        • 光柱
          • 默认用法
          • 配置项
          • 方法
          • 类用法
        • 雷达扫描
        • 信号波
        • 力场护盾
      • 粒子与精灵

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

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

类型

类

圆锥形光柱,由半透明外锥、更亮的内芯、柱顶的呼吸光晕和地面上扩散的两道脉冲光环组成。常用作数据标记:把归一化数值映射到 height 配置项,柱体越高代表数值越大。呼吸光晕与脉冲光环由光柱自身的动画循环驱动。

默认用法

点击我查看代码
<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 { LightPillar } from 'three-vue3'

const pillars: LightPillar[] = []

const created = (scene, { camera }) => {
  if (!camera) return

  camera.position.set(0, 2.4, 6)
  camera.lookAt(0, 1, 0)

  const data: Array<{ x: number; z: number; value: number; color: number }> = [
    { x: -2.2, z: 0, value: 0.35, color: 0x00ffff },
    { x: 0, z: -0.6, value: 1, color: 0x36e0a0 },
    { x: 2.2, z: 0, value: 0.62, color: 0xffb347 }
  ]

  data.forEach(({ x, z, value, color }) => {
    const pillar = new LightPillar({
      color,
      // 把归一化的数据值映射为光柱高度
      height: 1 + value * 2.4,
      radius: 0.22
    })
    pillar.position.set(x, 0, z)
    scene.add(pillar)
    pillars.push(pillar)
  })
}

onBeforeUnmount(() => {
  pillars.forEach((pillar) => pillar.dispose())
  pillars.length = 0
})
</script>

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

配置项

名称类型默认值描述
colornumber0x00ffff可选 光柱颜色。
heightnumber3可选 沿 Y 轴的柱体高度,底部位于 y = 0。
radiusnumber0.3可选 锥体底部半径。
opacitynumber1可选 全局不透明度系数(0-1)。
speednumber1可选 动画速度系数。
segmentsnumber32可选 锥体与光环的径向分段数。
glowbooleantrue可选 是否渲染柱顶的呼吸光晕。
ringbooleantrue可选 是否渲染地面上的两道扩散脉冲光环。
ringRadiusnumberradius * 3可选 脉冲光环扩散到的外半径。

方法

名称参数描述
constructor(options?: LightPillarOptions)创建光柱。它继承自 THREE.Group,可直接加入场景并通过 position 定位。
dispose() => void销毁光柱并从场景中移除。

类用法

import { LightPillar } from 'three-vue3'

const pillar = new LightPillar({ color: 0x36e0a0, height: 3, radius: 0.22 })
pillar.position.set(0, 0, 0)
scene.add(pillar)

// 光晕与光环由光柱自身动画循环驱动;销毁时:
pillar.dispose()
在 GitHub 上编辑此页
Last Updated:
Contributors: Shing Rui
Prev
灯光渐变
Next
雷达扫描