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

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

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

      • 自然

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

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

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

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

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

类型

类

SweepLight 沿某个坐标轴,在目标对象的所有网格上扫过一条叠加发光带。它会克隆每个网格的几何体,用光带着色器重新绘制,因此原始材质不受影响,模型保持原有外观。扫光由自身动画循环驱动,无需逐帧代码。

默认用法

点击我查看代码
<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 { GLTFLoader, SweepLight } from 'three-vue3'
import type * as THREE from 'three'

let effect: SweepLight | undefined
let model: THREE.Group | undefined

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

  camera.position.set(0, 1.5, 3)
  camera.lookAt(0, 0, 0)

  model = await GLTFLoader('/models/perseverance.glb', true)
  model.scale.set(0.8, 0.8, 0.8)
  scene.add(model)

  // 扫光绘制在模型表面之上。
  effect = new SweepLight(model)
}

onBeforeUnmount(() => {
  effect?.dispose()
  effect = undefined
  if (model) {
    model.parent?.remove(model)
    model = undefined
  }
})
</script>

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

配置项

名称类型默认值描述
colornumber0x00ffff可选 扫光颜色。
speednumber0.5可选 扫光速度,扫完一遍耗时 2 / speed 秒。
widthnumber0.3可选 光带宽度,取扫光轴 0-1 范围的比例。
intensitynumber1.5可选 光带强度。
directionnumber0可选 扫光轴:0 = X,1 = Y,2 = Z。
loopLoopOnce / LoopRepeat / LoopPingPongLoopRepeat可选 动画循环方式。

方法

名称参数描述
constructor(target: THREE.Object3D, options?)在网格、分组或场景对象上创建扫光。
play() => void播放或继续动画。
pause() => void在当前帧暂停动画。
stop() => void停止动画并重置到初始状态。
dispose() => void销毁扫光网格与共享材质。

类用法

import { SweepLight } from 'three-vue3'

const sweep = new SweepLight(model, { color: 0x00ffff, speed: 0.5 })
scene.add(model)

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