类 Polygon

填充多边形（不含描边），可沿Z轴拉伸高度成多边形柱状体

支持以下功能：

基础多边形填充渲染
Z轴拉伸创建3D柱状体
贴地渲染（Ground Primitive）
纹理贴图支持
顶点颜色和高度配置

示例

// 创建基础多边形
const polygon = engine.add(new mapvthree.Polygon({
    vertexColors: true,
    extrude: true,
    extrudeValue: 100,
}));

// 设置数据源
let data = mapvthree.GeoJSONDataSource.fromGeoJSON(data);
data.defineAttribute('color', 'color');
polygon.dataSource = data;

示例

// 创建贴地多边形
const groundPolygon = engine.add(new mapvthree.Polygon({
    isGroundPrimitive: true,
    color: 'rgba(255, 0, 0, 0.5)',
    opacity: 0.8
}));

层级

GeoMesh
- Polygon

构造函数

constructor

new Polygon(
    parameters?: {
        border?: boolean;
        borderColor?: string;
        borderOpacity?: number;
        borderWidth?: number;
        clampToGround?: boolean;
        color?: string;
        emissive?: string;
        enableBottomFace?: boolean;
        excludeElements?: any[];
        extrude?: boolean;
        extrudeValue?: number;
        groundTargets?: any[];
        isDynamic?: boolean;
        isGroundPrimitive?: boolean;
        mapScale?: number;
        mapSrc?: string;
        nearScale?: number;
        normalOffset?: number;
        opacity?: number;
        perPositionHeight?: boolean;
        renderOrder?: number;
        vertexColors?: boolean;
        vertexHeights?: boolean;
        zOffset?: number;
    },
): Polygon
创建多边形渲染对象
参数
- parameters: {
      border?: boolean;
      borderColor?: string;
      borderOpacity?: number;
      borderWidth?: number;
      clampToGround?: boolean;
      color?: string;
      emissive?: string;
      enableBottomFace?: boolean;
      excludeElements?: any[];
      extrude?: boolean;
      extrudeValue?: number;
      groundTargets?: any[];
      isDynamic?: boolean;
      isGroundPrimitive?: boolean;
      mapScale?: number;
      mapSrc?: string;
      nearScale?: number;
      normalOffset?: number;
      opacity?: number;
      perPositionHeight?: boolean;
      renderOrder?: number;
      vertexColors?: boolean;
      vertexHeights?: boolean;
      zOffset?: number;
  } = {}
  传入参数对象
  - 可选border?: boolean
    是否显示边框
  - 可选borderColor?: string
    边框颜色
  - 可选borderOpacity?: number
    边框透明度
  - 可选borderWidth?: number
    边框线宽（像素）
  - 可选clampToGround?: boolean
    是否贴合三维实体表面
  - 可选color?: string
    填充颜色
  - 可选emissive?: string
    自发光颜色
  - 可选enableBottomFace?: boolean
    是否封闭底面
  - 可选excludeElements?: any[]
    排除的元素列表
  - 可选extrude?: boolean
    是否拉伸，默认否
  - 可选extrudeValue?: number
    拉伸高度，默认100
  - 可选groundTargets?: any[]
    接收对象根节点；省略时自动发现，空数组表示不接收
  - 可选isDynamic?: boolean
    是否需要动态调整数据源，贴地时使用
  - 可选isGroundPrimitive?: boolean
    是否为贴地渲染
  - 可选mapScale?: number
    贴图的缩放大小，仅在使用纹理贴图时有效，默认1
  - 可选mapSrc?: string
    纹理贴图，默认''
  - 可选nearScale?: number
    深度图near值缩放系数
  - 可选normalOffset?: number
    沿法线方向抬升
  - 可选opacity?: number
    整体透明度系数，默认1
  - 可选perPositionHeight?: boolean
    使用顶点高度，若不指定，则即使设置了高度也当0处理, 默认为true
  - 可选renderOrder?: number
    渲染顺序
  - 可选vertexColors?: boolean
    是否通过数据携带颜色配置，默认否
  - 可选vertexHeights?: boolean
    是否通过数据携带高度配置，默认否
  - 可选zOffset?: number
    整体高度抬升
返回 Polygon
示例
```
const polygon = new mapvthree.Polygon({
    extrude: true,
    extrudeValue: 150,
    color: 'rgba(255, 0, 0, 0.8)',
    vertexColors: true,
    opacity: 0.9
});
```
重写了 GeoMesh.constructor

属性

color

color: string

填充颜色

示例

polygon.color = 'rgba(255, 0, 0, 0.8)';

emissive

emissive: string

自发光颜色

示例

polygon.emissive = 'rgba(0, 255, 0, 0.5)';

extrude

extrude: boolean

是否拉伸多边形

示例

polygon.extrude = true;

extrudeValue

extrudeValue: number

拉伸高度值

示例

polygon.extrudeValue = 200;

`只读`isEventEntitySupported

isEventEntitySupported: boolean = true

是否支持返回的事件参数中携带entity实体数据

`只读`isGeoObject

isGeoObject: true

类型为GeoObject的标识

`只读`isMesh

isMesh: true

类型为Mesh的标识

mapScale

mapScale: number

贴图的缩放大小，仅在使用纹理贴图时有效

示例

polygon.mapScale = 2.0;

opacity

opacity: number

整体透明度系数

示例

polygon.opacity = 0.7;

vertexColors

vertexColors: boolean

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

示例

polygon.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
释放资源

返回 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

onBeforeRender

onBeforeRender(renderer: any, scene: any, camera: any): void
An optional callback that is executed immediately before a 3D object is rendered.
参数
- renderer: any
- scene: any
- camera: any
返回 void
备注
This function is called with the following parameters: renderer, scene, camera, geometry, material, group. Please notice that this callback is only executed for renderable 3D objects. Meaning 3D objects which define their visual appearance with geometries and materials like instances of Mesh, Line, Points or Sprite. Instances of Object3D, Group or Bone are not renderable and thus this callback is not executed for such objects.

重写了 GeoMesh.onBeforeRender

removeAttributeRename

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

访问器

border

get border(): boolean
是否显示边框

返回 boolean

borderColor

get borderColor(): string
边框颜色

返回 string

borderOpacity

get borderOpacity(): number
边框透明度

返回 number

borderWidth

get borderWidth(): number
边框线宽（像素）

返回 number

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

mapSrc

get mapSrc(): string
纹理贴图图片路径

返回 string
示例
```
polygon.mapSrc = 'textures/ground.jpg';
```
set mapSrc(value: string): void
设置纹理贴图路径
参数
- value: string
  纹理贴图路径
返回 void

nearScale

get nearScale(): number
控制near的值，默认5，在一些对深度要求比较高的场景需要调整near的值

返回 number
示例
```
polygon.nearScale = 10; // 提高深度精度
```
set nearScale(value: number): void
设置near缩放值
参数
- value: number
  near缩放值
返回 void

needsUpdate

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

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

类 Polygon

示例

示例

层级

索引

构造函数

属性

方法

访问器

构造函数

constructor

参数

可选border?: boolean

可选borderColor?: string

可选borderOpacity?: number

可选borderWidth?: number

可选clampToGround?: boolean

可选color?: string

可选emissive?: string

可选enableBottomFace?: boolean

可选excludeElements?: any[]

可选extrude?: boolean

可选extrudeValue?: number

可选groundTargets?: any[]

可选isDynamic?: boolean

可选isGroundPrimitive?: boolean

可选mapScale?: number

可选mapSrc?: string

可选nearScale?: number

可选normalOffset?: number

可选opacity?: number

可选perPositionHeight?: boolean

可选renderOrder?: number

可选vertexColors?: boolean

可选vertexHeights?: boolean

可选zOffset?: number

返回 Polygon

示例

属性

color

示例

emissive

示例

extrude

示例

extrudeValue

示例

只读isEventEntitySupported

只读isGeoObject

只读isMesh

mapScale

示例

opacity

示例

vertexColors

示例

方法

addAttributeRename

参数

返回 void

clearAttributeRename

返回 void

dispose

返回 void

intersectsFrustum

参数

返回 boolean

onBeforeRender

参数

返回 void

备注

removeAttributeRename

参数

返回 void

访问器

border

返回 boolean

borderColor

返回 string

borderOpacity

`可选`border?: boolean

`可选`borderColor?: string

`可选`borderOpacity?: number

`可选`borderWidth?: number

`可选`clampToGround?: boolean

`可选`color?: string

`可选`emissive?: string

`可选`enableBottomFace?: boolean

`可选`excludeElements?: any[]

`可选`extrude?: boolean

`可选`extrudeValue?: number

`可选`groundTargets?: any[]

`可选`isDynamic?: boolean

`可选`isGroundPrimitive?: boolean

`可选`mapScale?: number

`可选`mapSrc?: string

`可选`nearScale?: number

`可选`normalOffset?: number

`可选`opacity?: number

`可选`perPositionHeight?: boolean

`可选`renderOrder?: number

`可选`vertexColors?: boolean

`可选`vertexHeights?: boolean

`可选`zOffset?: number

`只读`isEventEntitySupported

`只读`isGeoObject

`只读`isMesh