Skip to content

fill渲染插件

为面类型数据绘制面填充的渲染插件。

配置说明

js
{
  // [必填] 渲染插件对象
  renderPlugin: {
    // [必填] 插件类型,固定为line
    type: "fill",
    // [必填] 数据配置
    dataConfig: {
      // [必填] 数据类型,固定为fill
      type: "fill",
      // [可选] 默认为false
      // 声明是否只包含2D数据。
      // 设为true时,VectorTileLayer会开启瓦片的模板测试(stencil test),
      // 剪切掉超过瓦片范围的数据,消除绘制时瓦片重叠部分的绘制问题
      only2D: true
    },
    // [可选] 默认为null
    // 渲染场景配置
    sceneConfig: {
      // [可选] 默认为 "one"
      // WebGL的blendEquation的src参数,可选的值有:
      // 0, 1, "src color", "one minus src color", "src alpha", "one minus dst color", "dst alpha",
      // "one minus dst alpha", "constant color", "one minus constant color", "constant alpha",
      // "one minus constant alpha", "src alpha saturate"
      blendSrc: "one",
      // [可选] 默认为 "one minus src alpha"
      // WebGL的blendEquation的dst参数,可选的值有:
      // 0, 1, "src color", "one minus src color", "src alpha", "one minus dst color", "dst alpha",
      // "one minus dst alpha", "constant color", "one minus constant color", "constant alpha",
      // "one minus constant alpha", "src alpha saturate"
      blendDst: "one minus src alpha",
      // [可选] 默认为[0, 1]
      // WebGL深度值范围
      depthRange: [0, 1],
      // 【可选],默认为null
      // feature-filter类型,符合条件的数据将不被渲染
      excludes: null
      // [可选] 默认为<=
      // WebGL深度测试函数,可选的值有 always, never, <, <=, !=, >, >=
      depthFunc: '<=',
      // [可选] 默认为true(不设置时即开启)
      // 是否开启fxaa抗锯齿
      antialias: false
    }
  },
  // [可选] 默认为true
  // 数据过滤条件
  filter: true,
  // 样式属性
  symbol: {
    polygonFill: '#f00',
    polygonOpacity: 0.5
  }
}

filter 数据过滤条件的具体说明请点击这里

支持的数据类型

  • 如果是矢量瓦片数据,支持type为Polygon或者MultiPolygon类型的Feature
  • 如果是GeoJSON数据,支持type为Polygon或者MultiPolygon类型的Feature
  • 如果是矢量图层,则支持maptalks.Polygon, maptalks.MultiPolygon.

动态样式

大部分样式属性都支持 function-type 表达式,支持根据不同zoom级别或数据的属性值设置不同的样式属性。

例如以下示例,能让面的透明度在不同地图级别上由小变大:

json
{
 "polygonOpacity": {
    "stops": [[1, 0.1], [20, 1]]
  }
}

支持的Symbol样式属性

fill渲染插件支持polygon样式属性

除了上述属性,还支持下列属性:


polygonBloom

默认值:false

Boolean,是否支持bloom泛光后处理。

本文档已与 @maptalks/gl-layers 2026 源码核对(api-notes-vt-gl.md)