类 Wall

墙体网格对象，用于在地图上创建无厚度的墙体效果。支持自定义高度、颜色、纹理和动画效果。

示例

// 创建一个基础墙体
const wall = engine.add(new mapvthree.Wall({
    height: 200,
    color: '#00ffff',
    opacity: 0.8
}));

// 设置数据源
const data = mapvthree.GeoJSONDataSource.fromGeoJSON([{
    type: 'Feature',
    geometry: {
        type: 'LineString',
        coordinates: [[116.404, 39.915], [116.405, 39.920]]
    }
}]);
wall.dataSource = data;

// 添加动画效果
wall.enableAnimation = true;
wall.animationTailType = 3;
wall.animationSpeed = 1;

层级

GeoMesh
- Wall

构造函数

constructor

new Wall(
    parameters: {
        animationBales?: number;
        animationIdle?: number;
        animationRatio?: number;
        animationSpeed?: number;
        animationTailLength?: number;
        animationTailRatio?: number;
        animationTailType?: number;
        color?: string;
        enableAnimation?: boolean;
        height?: number;
        map?: string;
        mapScale?: number | number[];
        maxOpacity?: number;
        minOpacity?: number;
        opacity?: number;
        sideUVUseHeight?: boolean;
        vertexColors?: boolean;
    },
): Wall
构造函数
参数
- parameters: {
      animationBales?: number;
      animationIdle?: number;
      animationRatio?: number;
      animationSpeed?: number;
      animationTailLength?: number;
      animationTailRatio?: number;
      animationTailType?: number;
      color?: string;
      enableAnimation?: boolean;
      height?: number;
      map?: string;
      mapScale?: number | number[];
      maxOpacity?: number;
      minOpacity?: number;
      opacity?: number;
      sideUVUseHeight?: boolean;
      vertexColors?: boolean;
  }
  配置参数
  - 可选animationBales?: number
    条纹上升动画显示组数，值大于等于1，仅在animationTailType=4.0时生效, 默认5
  - 可选animationIdle?: number
    拖尾动画间隔时间, 默认1000
  - 可选animationRatio?: number
    条纹上升动画一组实虚线中实线所占比，范围0-1之间，仅在animationTailType=4.0时生效, 默认0.5
  - 可选animationSpeed?: number
    动画速度, 默认1
  - 可选animationTailLength?: number
    拖尾动画真实长度, 默认100
  - 可选animationTailRatio?: number
    拖尾动画长度比例, 默认0.2
  - 可选animationTailType?: number
    动画类型, 默认3
  - 可选color?: string
    墙的颜色, 默认#00ffff
  - 可选enableAnimation?: boolean
    是否开启墙动画, 默认false
  - 可选height?: number
    墙的高度, 默认100
  - 可选map?: string
    纹理贴图的路径
  - 可选mapScale?: number | number[]
    纹理贴图的缩放系数, 默认1
  - 可选maxOpacity?: number
    墙的最高透明度, 默认1
  - 可选minOpacity?: number
    墙的最低透明度, 默认0
  - 可选opacity?: number
    墙的整体透明系数, 默认1
  - 可选sideUVUseHeight?: boolean
    true 时墙面 UV.v 使用世界垂直距离（米），墙高变化时贴图不再被压缩/拉伸； false 时 v ∈ [0, 1] 归一化（默认，保持向后兼容）。 shader 里走 vUV = uv / mapScale，所以开启后 mapScale.y 的语义是「纹理一次重复对应多少米」。例如 mapScale.y = 20 表示每 20m 重复一次。值过小（如 0.05）会让 vUV.y 极大，触发 mipmap 衰减成均色。
  - 可选vertexColors?: boolean
    是否通过数据携带颜色配置, 默认false
返回 Wall
重写了 GeoMesh.constructor

属性

animationBales

animationBales: number

条纹上升动画显示组数

默认值

示例

wall.animationBales = 3;

animationIdle

animationIdle: number

拖尾动画间隔时间，单位：毫秒

默认值

示例

wall.animationIdle = 2000;

animationRatio

animationRatio: number

条纹上升动画一组实虚线中实线所占比

默认值

0.5

示例

wall.animationRatio = 0.7;

animationSpeed

animationSpeed: number

动画速度

默认值

示例

wall.animationSpeed = 2;

animationTailLength

animationTailLength: number

拖尾动画真实长度

默认值

示例

wall.animationTailLength = 200;

animationTailRatio

animationTailRatio: number

拖尾动画长度比例

默认值

0.2

示例

wall.animationTailRatio = 0.3;

animationTailType

animationTailType: 1 | 2 | 3 | 4

动画类型

1: 按墙长度比例，需设置animationTailRatio属性
2: 按固定长度，需设置animationTailLength属性
3: 垂直方向动画
4: 条纹上升动画

默认值

示例

// 设置为垂直方向动画
wall.animationTailType = 3;

color

color: string

墙的颜色

默认值

'#00ffff'

示例

wall.color = '#ff0000';

enableAnimation

enableAnimation: boolean

是否开启墙动画

默认值

false

示例

wall.enableAnimation = true;

height

height: number

墙的高度

默认值

示例

wall.height = 200;

`只读`isGeoObject

isGeoObject: true

类型为GeoObject的标识

`只读`isMesh

isMesh: true

类型为Mesh的标识

map

map: string

纹理贴图的路径

默认值

null

示例

wall.map = 'path/to/texture.png';

maxOpacity

maxOpacity: number

墙的最高透明度

默认值

示例

wall.maxOpacity = 0.9;

minOpacity

minOpacity: number

墙的最低透明度

默认值

示例

wall.minOpacity = 0.2;

opacity

opacity: number

墙的整体透明系数

默认值

示例

wall.opacity = 0.8;

vertexColors

vertexColors: boolean

是否通过数据携带颜色配置

默认值

false

示例

wall.vertexColors = true;

方法

addAttributeRename

addAttributeRename(key: string, value: string): void
添加属性重命名
参数
- key: string
  原始属性名，该组件的属性名
- value: string
  重命名后的属性名，数据源的属性名
返回 void
继承自 GeoMesh.addAttributeRename

clearAttributeRename

clearAttributeRename(): void
清空属性重命名

返回 void
继承自 GeoMesh.clearAttributeRename

dispose

dispose(): void
销毁object上的geometry和material实例，释放资源, 调用engine.remove(object)会自动销毁资源，不需要手动调用

返回 void
继承自 GeoMesh.dispose

intersectsFrustum

intersectsFrustum(frustum: Frustum): boolean
视锥剔除测试。

three r18x 起 WebGLRenderer 把剔除判断从 frustum.intersectsObject(object) 改成了 object.intersectsFrustum(frustum)，而 Object3D 的基类实现是空函数（返回 undefined）。本类只是打了 isMesh 标记、并不继承 three 的 Mesh，所以必须自己实现，否则在新版 three 下会被判定为「不在视锥内」而永远不渲染。行为与 three 的 Mesh.intersectsFrustum 一致；Frustum.intersectsObject 在 0.179 与 0.186 中都存在，所以这份实现对两个版本都安全。
参数
- frustum: Frustum
  视锥
返回 boolean
是否与视锥相交

继承自 GeoMesh.intersectsFrustum

raycast

raycast(raycaster: any, intersects: any): void
Abstract (empty) method to get intersections between a casted ray and this object
参数
- raycaster: any
- intersects: any
返回 void
备注
Subclasses such as THREE.Mesh | Mesh, THREE.Line | Line, and THREE.Points | Points implement this method in order to use raycasting.

参阅
THREE.Raycaster | Raycaster

默认值
() => {}

继承自 GeoMesh.raycast

removeAttributeRename

removeAttributeRename(key: string): void
移除属性重命名
参数
- key: string
  原始属性名
返回 void
继承自 GeoMesh.removeAttributeRename

访问器

clampToGround

get clampToGround(): boolean
Only move the anchor; flat, rotation and pixel offsets keep their original semantics.

返回 boolean
继承自 GeoMesh.clampToGround

dataSource

get dataSource(): DataSource
对象连接的 DataSource 数据源。

返回 DataSource
继承自 GeoMesh.dataSource
set dataSource(dataSource: DataSource): void
设置object的数据源
参数
- dataSource: DataSource
  数据源
返回 void
继承自 GeoMesh.dataSource

needsUpdate

get needsUpdate(): boolean
是否需要更新

返回 boolean
继承自 GeoMesh.needsUpdate
set needsUpdate(value: boolean): void
设置object是否在下一帧更新
参数
- value: boolean
  设置为true，则下一帧渲染前更新该object
返回 void
继承自 GeoMesh.needsUpdate

类 Wall

示例

层级

索引

构造函数

属性

方法

访问器

构造函数

constructor

参数

可选animationBales?: number

可选animationIdle?: number

可选animationRatio?: number

可选animationSpeed?: number

可选animationTailLength?: number

可选animationTailRatio?: number

可选animationTailType?: number

可选color?: string

可选enableAnimation?: boolean

可选height?: number

可选map?: string

可选mapScale?: number | number[]

可选maxOpacity?: number

可选minOpacity?: number

可选opacity?: number

可选sideUVUseHeight?: boolean

可选vertexColors?: boolean

返回 Wall

属性

animationBales

默认值

示例

animationIdle

默认值

示例

animationRatio

默认值

示例

animationSpeed

默认值

示例

animationTailLength

默认值

示例

animationTailRatio

默认值

示例

animationTailType

默认值

示例

color

默认值

示例

enableAnimation

默认值

示例

height

默认值

示例

只读isGeoObject

只读isMesh

map

默认值

示例

maxOpacity

默认值

示例

minOpacity

默认值

示例

opacity

默认值

示例

vertexColors

默认值

示例

方法

addAttributeRename

参数

`可选`animationBales?: number

`可选`animationIdle?: number

`可选`animationRatio?: number

`可选`animationSpeed?: number

`可选`animationTailLength?: number

`可选`animationTailRatio?: number

`可选`animationTailType?: number

`可选`color?: string

`可选`enableAnimation?: boolean

`可选`height?: number

`可选`map?: string

`可选`mapScale?: number | number[]

`可选`maxOpacity?: number

`可选`minOpacity?: number

`可选`opacity?: number

`可选`sideUVUseHeight?: boolean

`可选`vertexColors?: boolean

`只读`isGeoObject

`只读`isMesh