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

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

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

      • 自然

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

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

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

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

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

类型

类

RadarSweep 是一种地面雷达脉冲:环形波带从网格原点向外扩散,并被漂移噪声打散,因此波前不会看起来像一个画出来的圆。它叠加了前缘波峰、紧随其后的较弱首次回波、已扫过区域的微弱足迹,以及埋藏目标上的短促亮点。

波带会通过 heightAt 采样器一次性贴合到地面,因此能顺应起伏地形。请在添加到场景之前设置网格位置(波带会在 added 时重建),或在移动后调用 rebuild()。

传入 period 后脉冲会自动循环——扫描由内部时钟推进。只有在需要手动控制进度时,才需要调用 update(delta)。

默认用法

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

let effect: RadarSweep | undefined
let ground: THREE.Mesh | undefined

// 地面网格与雷达波带共用的平缓沙丘起伏,让脉冲明显贴合地形,
// 而不是直接切穿地面。
function terrainHeight(x: number, z: number): number {
  return Math.sin(x * 0.55) * 0.22 + Math.cos(z * 0.4) * 0.18
}

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

  // 用与波带相同的采样器把地面抬起。
  const geometry = new THREE.PlaneGeometry(22, 22, 96, 96)
  geometry.rotateX(-Math.PI / 2)
  const positions = geometry.attributes.position as THREE.BufferAttribute
  for (let i = 0; i < positions.count; i += 1) {
    positions.setY(i, terrainHeight(positions.getX(i), positions.getZ(i)))
  }
  geometry.computeVertexNormals()

  ground = new THREE.Mesh(
    geometry,
    new THREE.MeshStandardMaterial({ color: 0x4a3a33, roughness: 1 })
  )
  scene.add(ground)

  // `period` 让扫描自行循环,无需动画循环。
  effect = new RadarSweep({ radius: 8, heightAt: terrainHeight, period: 2.4 })
  scene.add(effect)
}

onBeforeUnmount(() => {
  effect?.dispose()
  effect = undefined
  if (ground) {
    ground.parent?.remove(ground)
    ground.geometry.dispose()
    ;(ground.material as THREE.Material).dispose()
    ground = undefined
  }
})
</script>

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

配置项

名称类型默认值描述
radiusnumber8可选 脉冲扩散到的外半径。
segmentsnumber128可选 环形几何体的径向分段数。
ringsnumber20可选 环形几何体的同心分段数。
heightAt(x: number, z: number) => number—可选 世界空间地面采样器,用于让波带贴合地形。
colornumber0x57ccff可选 扫描波带的颜色。
crestColornumber0xa8f5ff可选 前缘波峰的颜色。
echoDelaynumber1.8可选 较弱首次回波落后于波峰的距离。
opacitynumber0.9可选 整个脉冲的透明度系数。
liftnumber0.04可选 高于地形的高度偏移。
progressnumber0可选 脉冲初始进度(0-1)。
periodnumber—可选 一次完整扫描的秒数;设置后脉冲自行循环。

类用法

import { RadarSweep } from 'three-vue3'

const sweep = new RadarSweep({
  radius: 8,
  period: 2.4,
  heightAt: (x, z) => Math.sin(x * 0.5 + z * 0.3) * 0.2
})
sweep.position.set(0, 0, 0)
scene.add(sweep)

// 设置 `period` 后脉冲会自行推进动画。

// 销毁时:
sweep.dispose()
在 GitHub 上编辑此页
Last Updated:
Contributors: Shing Rui
Prev
光柱
Next
信号波