Skip to content

PointCloud 点云

三维点云可视化组件,基于 Three.js 实现。

动画和交互

点云的动画和点击交互功能。

基础用法

基础的点云显示功能。

自定义点云颜色

自定义点云的颜色。

属性

属性名说明类型默认值
pointCloudList点云数据列表Array[]
colorList颜色列表Array['#537983','#89caed','#d6d7db','#1463c3']
point_size点的大小Number0.005
enable_animation是否启用动画Booleanfalse
animation_speed动画速度Number0.01

事件

组件会自动监听窗口大小变化和容器尺寸变化,并相应地调整渲染视图。

点击事件

点击点云中的点时触发。

typescript
(point: number[], index: number) => void
参数说明类型
point被点击的点的坐标和颜色信息number[]
index被点击的点在点云数据中的索引number

示例

基础点云显示

vue
<template>
  <CYPointCloud :pointCloudList="points" />
</template>

<script setup lang="ts">
import { ref } from "vue";
import { CYPointCloud } from "chenyuan-ui";

const points = ref([
  { x: 0, y: 0, z: 0, color: 0 },
  { x: 1, y: 1, z: 1, color: 0 },
  // ... 更多点云数据
]);
</script>

样式变量

名称 (数组元素第四位)说明默认值
default颜色0xffffff
0颜色#537983
1颜色#89caed
2颜色#d6d7db
3颜色#1463c3

注意事项

  1. 确保容器元素具有明确的宽度和高度
  2. 点云数据应包含 x、y、z 坐标信息,color是点的颜色可以传入配置色,内置默认颜色
  3. 组件会自动处理场景的清理和资源释放
  4. 支持鼠标交互:旋转、缩放、平移等操作

Released under the MIT License.