@antv/l7-layers 2.25.7 → 2.25.9

package/lib/geometry/models/plane.js

@@ -0,0 +1,316 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
+var _objectSpread2 = _interopRequireDefault(require("@babel/runtime/helpers/objectSpread2"));
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+var _l7Core = require("@antv/l7-core");
+var _BaseModel = _interopRequireDefault(require("../../core/BaseModel"));
+/* babel-plugin-inline-import '../shaders/plane_frag.glsl' */
+const planeFrag = "uniform sampler2D u_texture;\nlayout(std140) uniform commonUniforms {\n  float u_opacity;\n  float u_mapFlag;\n  float u_terrainClipHeight;\n};\n\nin vec3 v_Color;\nin vec2 v_uv;\nin float v_clip;\nout vec4 outputColor;\n\n#pragma include \"picking\"\nvoid main() {\n  if (u_mapFlag > 0.0) {\n    outputColor = texture(SAMPLER_2D(u_texture), vec2(v_uv.x, 1.0 - v_uv.y));\n    outputColor.a *= u_opacity;\n  } else {\n    outputColor = vec4(v_Color, u_opacity);\n  }\n  outputColor.a *= v_clip;\n  outputColor = filterColor(outputColor);\n}\n";
+/* babel-plugin-inline-import '../shaders/plane_vert.glsl' */
+const planeVert = "layout(location = ATTRIBUTE_LOCATION_POSITION) in vec3 a_Position;\nlayout(location = ATTRIBUTE_LOCATION_COLOR) in vec3 a_Color;\nlayout(location = ATTRIBUTE_LOCATION_UV) in vec2 a_Uv;\n\nlayout(std140) uniform commonUniforms {\n  float u_opacity;\n  float u_mapFlag;\n  float u_terrainClipHeight;\n};\n\nout vec3 v_Color;\nout vec2 v_uv;\nout float v_clip;\n\n#pragma include \"projection\"\n#pragma include \"picking\"\nvoid main() {\n  v_Color = a_Color;\n  v_uv = a_Uv;\n\n  vec4 project_pos = project_position(vec4(a_Position, 1.0));\n\n  v_clip = 1.0;\n  if (a_Position.z < u_terrainClipHeight) {\n    v_clip = 0.0;\n  }\n\n  gl_Position = project_common_position_to_clipspace(vec4(project_pos.xy, a_Position.z, 1.0));\n\n  setPickingColor(a_PickingColor);\n}\n";
+class PlaneModel extends _BaseModel.default {
+  constructor(...args) {
+    super(...args);
+    (0, _defineProperty2.default)(this, "texture", void 0);
+    (0, _defineProperty2.default)(this, "terrainImage", void 0);
+    (0, _defineProperty2.default)(this, "terrainImageLoaded", false);
+    (0, _defineProperty2.default)(this, "mapTexture", void 0);
+    (0, _defineProperty2.default)(this, "planeGeometryTriangulation", () => {
+      const {
+        width = 1,
+        height = 1,
+        widthSegments = 1,
+        heightSegments = 1,
+        center = [120, 30],
+        terrainTexture,
+        rgb2height = (r, g, b) => r + g + b
+      } = this.layer.getLayerConfig();
+      const {
+        indices,
+        positions
+      } = this.initPlane(width, height, widthSegments, heightSegments, ...center);
+      if (terrainTexture) {
+        // 存在地形贴图的时候会根据地形贴图对顶点进行偏移
+        return this.translateVertex(positions, indices, this.terrainImage, widthSegments, heightSegments, rgb2height);
+      }
+      return {
+        vertices: positions,
+        indices,
+        size: 5
+      };
+    });
+  }
+  get attributeLocation() {
+    return Object.assign(super.attributeLocation, {
+      MAX: super.attributeLocation.MAX,
+      UV: 10
+    });
+  }
+  initPlane(width = 1, height = 1, widthSegments = 1, heightSegments = 1, lng = 120, lat = 30) {
+    // https://github.com/mrdoob/three.js/blob/dev/src/geometries/PlaneGeometry.js
+    const widthHalf = width / 2;
+    const heightHalf = height / 2;
+    const gridX = Math.floor(widthSegments);
+    const gridY = Math.floor(heightSegments);
+    const gridX1 = gridX + 1;
+    const gridY1 = gridY + 1;
+    const segmentWidth = width / gridX;
+    const segmentHeight = height / gridY;
+    const indices = [];
+    const positions = [];
+    for (let iy = 0; iy < gridY1; iy++) {
+      const y = iy * segmentHeight - heightHalf;
+      for (let ix = 0; ix < gridX1; ix++) {
+        const x = ix * segmentWidth - widthHalf;
+        positions.push(x + lng, -y + lat, 0);
+        positions.push(ix / gridX);
+        positions.push(1 - iy / gridY);
+      }
+    }
+    for (let iy = 0; iy < gridY; iy++) {
+      for (let ix = 0; ix < gridX; ix++) {
+        const a = ix + gridX1 * iy;
+        const b = ix + gridX1 * (iy + 1);
+        const c = ix + 1 + gridX1 * (iy + 1);
+        const d = ix + 1 + gridX1 * iy;
+        indices.push(a, b, d);
+        indices.push(b, c, d);
+      }
+    }
+    return {
+      indices,
+      positions
+    };
+  }
+  getUninforms() {
+    const commoninfo = this.getCommonUniformsInfo();
+    const attributeInfo = this.getUniformsBufferInfo(this.getStyleAttribute());
+    this.updateStyleUnifoms();
+    return (0, _objectSpread2.default)((0, _objectSpread2.default)({}, commoninfo.uniformsOption), attributeInfo.uniformsOption);
+  }
+  getCommonUniformsInfo() {
+    const {
+      opacity,
+      mapTexture,
+      terrainClipHeight = 0,
+      terrainTexture
+    } = this.layer.getLayerConfig();
+    if (this.mapTexture !== mapTexture) {
+      var _this$texture;
+      this.mapTexture = mapTexture;
+      (_this$texture = this.texture) === null || _this$texture === void 0 || _this$texture.destroy();
+      this.updateTexture(mapTexture);
+    }
+    const commonOptions = {
+      u_opacity: opacity || 1,
+      u_mapFlag: mapTexture ? 1 : 0,
+      u_terrainClipHeight: terrainTexture ? terrainClipHeight : -1,
+      u_texture: this.texture
+    };
+    this.textures = [this.texture];
+    const commonBufferInfo = this.getUniformsBufferInfo(commonOptions);
+    return commonBufferInfo;
+  }
+  clearModels() {
+    var _this$texture2;
+    // @ts-ignore
+    this.terrainImage = null;
+    (_this$texture2 = this.texture) === null || _this$texture2 === void 0 || _this$texture2.destroy();
+    this.textures = [];
+  }
+  initModels() {
+    var _this = this;
+    return (0, _asyncToGenerator2.default)(function* () {
+      const {
+        mapTexture,
+        terrainTexture
+      } = _this.layer.getLayerConfig();
+      _this.mapTexture = mapTexture;
+      const {
+        createTexture2D
+      } = _this.rendererService;
+      _this.texture = createTexture2D({
+        height: 0,
+        width: 0
+      });
+      _this.updateTexture(mapTexture);
+      _this.initUniformsBuffer();
+      if (terrainTexture) {
+        _this.terrainImage = yield _this.loadTerrainImage(terrainTexture);
+      }
+      const model = yield _this.layer.buildLayerModel({
+        moduleName: 'geometryPlane',
+        vertexShader: planeVert,
+        fragmentShader: planeFrag,
+        triangulation: _this.planeGeometryTriangulation,
+        defines: _this.getDefines(),
+        inject: _this.getInject(),
+        primitive: _l7Core.gl.TRIANGLES,
+        depth: {
+          enable: true
+        },
+        cull: {
+          enable: true,
+          face: _l7Core.gl.BACK // gl.FRONT | gl.BACK;
+        }
+      });
+      return [model];
+    })();
+  }
+  buildModels() {
+    var _this2 = this;
+    return (0, _asyncToGenerator2.default)(function* () {
+      return _this2.initModels();
+    })();
+  }
+  createModelData(options) {
+    if (options) {
+      const {
+        widthSegments: oldwidthSegments,
+        heightSegments: oldheightSegments,
+        width: oldwidth,
+        height: oldheight
+      } = this.layer.getLayerConfig();
+      const {
+        widthSegments,
+        heightSegments,
+        width,
+        height
+      } = options;
+      this.layer.style({
+        widthSegments: widthSegments !== undefined ? widthSegments : oldwidthSegments,
+        heightSegments: heightSegments !== undefined ? heightSegments : oldheightSegments,
+        width: width !== undefined ? width : oldwidth,
+        height: height !== undefined ? height : oldheight
+      });
+    }
+    const oldFeatures = this.layer.getEncodedData();
+    const res = this.styleAttributeService.createAttributesAndIndices(oldFeatures, this.planeGeometryTriangulation);
+    return res;
+  }
+  updateTexture(mapTexture) {
+    const {
+      createTexture2D
+    } = this.rendererService;
+    if (mapTexture) {
+      const img = new Image();
+      img.crossOrigin = 'anonymous';
+      img.onload = () => {
+        this.texture = createTexture2D({
+          data: img,
+          width: img.width,
+          height: img.height,
+          wrapS: _l7Core.gl.CLAMP_TO_EDGE,
+          wrapT: _l7Core.gl.CLAMP_TO_EDGE
+        });
+        this.layerService.reRender();
+      };
+      img.src = mapTexture;
+    } else {
+      this.texture = createTexture2D({
+        width: 0,
+        height: 0
+      });
+    }
+  }
+  getImageData(img) {
+    const canvas = document.createElement('canvas');
+    const ctx = canvas.getContext('2d');
+    const {
+      width,
+      height
+    } = img;
+    canvas.width = width;
+    canvas.height = height;
+    ctx.drawImage(img, 0, 0, width, height);
+    const imageData = ctx.getImageData(0, 0, width, height);
+    return imageData;
+  }
+  translateVertex(positions, indices, image, widthSegments, heightSegments, rgb2height) {
+    const imgWidth = image.width;
+    const imgHeight = image.height;
+    const imageData = this.getImageData(image).data;
+    const gridX = Math.floor(widthSegments);
+    const gridY = Math.floor(heightSegments);
+    const gridX1 = gridX + 1;
+    const gridY1 = gridY + 1;
+    const widthStep = imgWidth / gridX;
+    const heightStep = imgHeight / gridY;
+    for (let iy = 0; iy < gridY1; iy++) {
+      const imgIndexY = Math.floor(iy * heightStep);
+      const imgLen = imgIndexY * imgWidth;
+      for (let ix = 0; ix < gridX1; ix++) {
+        const imgIndexX = Math.floor(ix * widthStep);
+        const imgDataIndex = (imgLen + imgIndexX) * 4;
+        const r = imageData[imgDataIndex];
+        const g = imageData[imgDataIndex + 1];
+        const b = imageData[imgDataIndex + 2];
+        const z = (iy * gridX1 + ix) * 5 + 2;
+        positions[z] = rgb2height(r, g, b);
+      }
+    }
+    return {
+      vertices: positions,
+      indices,
+      size: 5
+    };
+  }
+  loadTerrainImage(terrainTexture) {
+    var _this3 = this;
+    return (0, _asyncToGenerator2.default)(function* () {
+      if (_this3.terrainImage) {
+        // 若当前已经存在 image，直接进行偏移计算（LOD）
+        if (_this3.terrainImageLoaded) {
+          return _this3.terrainImage;
+        } else {
+          return new Promise(resolve => {
+            _this3.terrainImage.onload = () => {
+              resolve(_this3.terrainImage);
+            };
+          });
+        }
+      } else {
+        // 加载地形贴图、根据地形贴图对 planeGeometry 进行偏移
+        const terrainImage = new Image();
+        terrainImage.crossOrigin = 'anonymous';
+        return new Promise(resolve => {
+          terrainImage.onload = () => {
+            _this3.terrainImageLoaded = true;
+            resolve(terrainImage);
+            // 图片加载完，触发事件，可以进行地形图的顶点计算存储
+            setTimeout(() => _this3.layer.emit('terrainImageLoaded', null));
+          };
+          terrainImage.src = terrainTexture;
+        });
+      }
+    })();
+  }
+  registerBuiltinAttributes() {
+    // point layer size;
+    this.styleAttributeService.registerStyleAttribute({
+      name: 'uv',
+      type: _l7Core.AttributeType.Attribute,
+      descriptor: {
+        name: 'a_Uv',
+        shaderLocation: this.attributeLocation.UV,
+        buffer: {
+          // give the WebGL driver a hint that this buffer may change
+          usage: _l7Core.gl.DYNAMIC_DRAW,
+          data: [],
+          type: _l7Core.gl.FLOAT
+        },
+        size: 2,
+        update: (feature, featureIdx, vertex) => {
+          return [vertex[3], vertex[4]];
+        }
+      }
+    });
+  }
+}
+exports.default = PlaneModel;

package/lib/geometry/models/sprite.d.ts

@@ -0,0 +1,48 @@
+import type { IModel, IModelUniform, ITexture2D } from '@antv/l7-core';
+import BaseModel from '../../core/BaseModel';
+declare enum SPRITE_ANIMATE_DIR {
+    'UP' = "up",
+    'DOWN' = "down"
+}
+export default class SpriteModel extends BaseModel {
+    protected texture: ITexture2D;
+    protected mapTexture: string | undefined;
+    protected positions: number[];
+    protected indices: number[];
+    protected timer: number;
+    protected spriteTop: number;
+    protected spriteUpdate: number;
+    protected spriteAnimate: SPRITE_ANIMATE_DIR;
+    initSprite(radius?: number, spriteCount?: number, lng?: number, lat?: number): {
+        indices: number[];
+        positions: number[];
+    };
+    planeGeometryUpdateTriangulation: () => {
+        vertices: number[];
+        indices: number[];
+        size: number;
+    };
+    /**
+     * Recalculate and update position attribute.
+     */
+    private updatePosition;
+    planeGeometryTriangulation: () => {
+        vertices: number[];
+        indices: number[];
+        size: number;
+    };
+    getUninforms(): IModelUniform;
+    protected getCommonUniformsInfo(): {
+        uniformsArray: number[];
+        uniformsLength: number;
+        uniformsOption: {
+            [key: string]: any;
+        };
+    };
+    clearModels(): void;
+    initModels(): Promise<IModel[]>;
+    buildModels(): Promise<IModel[]>;
+    updateTexture(mapTexture: string | undefined): void;
+    protected registerBuiltinAttributes(): string;
+}
+export {};

package/lib/geometry/models/sprite.js

@@ -0,0 +1,233 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
+var _objectSpread2 = _interopRequireDefault(require("@babel/runtime/helpers/objectSpread2"));
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+var _l7Core = require("@antv/l7-core");
+var _BaseModel = _interopRequireDefault(require("../../core/BaseModel"));
+/* babel-plugin-inline-import '../shaders/sprite_frag.glsl' */
+const spriteFrag = "layout(std140) uniform commonUniforms {\n  float u_opacity;\n  float u_mapFlag;\n  float u_Scale;\n};\nuniform sampler2D u_texture;\n\nin vec3 v_Color;\nin float v_d;\nout vec4 outputColor;\n\nvoid main() {\n  if (v_d < 0.0) {\n    discard;\n  }\n\n  if (u_mapFlag > 0.0) {\n    outputColor = texture(SAMPLER_2D(u_texture), gl_PointCoord);\n    outputColor.a *= u_opacity;\n  } else {\n    outputColor = vec4(v_Color, u_opacity);\n  }\n}\n";
+/* babel-plugin-inline-import '../shaders/sprite_vert.glsl' */
+const spriteVert = "layout(location = ATTRIBUTE_LOCATION_POSITION) in vec3 a_Position;\nlayout(location = ATTRIBUTE_LOCATION_COLOR) in vec3 a_Color;\n\nlayout(std140) uniform commonUniforms {\n  float u_opacity;\n  float u_mapFlag;\n  float u_Scale;\n};\n\nout vec3 v_Color;\nout float v_d;\n\n#pragma include \"projection\"\nvoid main() {\n  v_Color = a_Color.xyz;\n  v_d = a_Position.z;\n\n  vec4 project_pos = project_position(vec4(a_Position, 1.0));\n  gl_Position = project_common_position_to_clipspace(vec4(project_pos.xy, a_Position.z, 1.0));\n  gl_PointSize = pow(u_Zoom - 1.0, 2.0) * u_Scale;\n}\n";
+var SPRITE_ANIMATE_DIR = /*#__PURE__*/function (SPRITE_ANIMATE_DIR) {
+  SPRITE_ANIMATE_DIR["UP"] = "up";
+  SPRITE_ANIMATE_DIR["DOWN"] = "down";
+  return SPRITE_ANIMATE_DIR;
+}(SPRITE_ANIMATE_DIR || {});
+class SpriteModel extends _BaseModel.default {
+  constructor(...args) {
+    super(...args);
+    (0, _defineProperty2.default)(this, "texture", void 0);
+    (0, _defineProperty2.default)(this, "mapTexture", void 0);
+    (0, _defineProperty2.default)(this, "positions", void 0);
+    (0, _defineProperty2.default)(this, "indices", void 0);
+    (0, _defineProperty2.default)(this, "timer", void 0);
+    (0, _defineProperty2.default)(this, "spriteTop", void 0);
+    (0, _defineProperty2.default)(this, "spriteUpdate", void 0);
+    (0, _defineProperty2.default)(this, "spriteAnimate", void 0);
+    (0, _defineProperty2.default)(this, "planeGeometryUpdateTriangulation", () => {
+      const {
+        spriteBottom = -10
+      } = this.layer.getLayerConfig();
+      const updateZ = this.spriteUpdate;
+      const bottomZ = spriteBottom;
+      const topZ = this.spriteTop;
+      for (let i = 0; i < this.positions.length; i += 5) {
+        if (this.spriteAnimate === SPRITE_ANIMATE_DIR.UP) {
+          this.positions[i + 2] += updateZ;
+          if (this.positions[i + 2] > topZ) {
+            this.positions[i + 2] = bottomZ;
+          }
+        } else {
+          this.positions[i + 2] -= updateZ;
+          if (this.positions[i + 2] < bottomZ) {
+            this.positions[i + 2] = topZ;
+          }
+        }
+      }
+      return {
+        vertices: this.positions,
+        indices: this.indices,
+        size: 5
+      };
+    });
+    /**
+     * Recalculate and update position attribute.
+     */
+    (0, _defineProperty2.default)(this, "updatePosition", () => {
+      var _this$styleAttributeS;
+      this.planeGeometryUpdateTriangulation();
+      const vertexAttribute = (_this$styleAttributeS = this.styleAttributeService.getLayerStyleAttribute('position')) === null || _this$styleAttributeS === void 0 ? void 0 : _this$styleAttributeS.vertexAttribute;
+      if (vertexAttribute) {
+        // [x1, y1, z1, x2, y2, z2...]
+        const updated = [];
+        for (let i = 0; i < this.positions.length; i += 5) {
+          updated.push(this.positions[i], this.positions[i + 1], this.positions[i + 2]);
+        }
+        vertexAttribute.updateBuffer({
+          data: updated,
+          offset: 0
+        });
+      }
+      this.layerService.throttleRenderLayers();
+      this.timer = requestAnimationFrame(this.updatePosition);
+    });
+    (0, _defineProperty2.default)(this, "planeGeometryTriangulation", () => {
+      const {
+        center = [120, 30],
+        spriteCount = 100,
+        spriteRadius = 10
+      } = this.layer.getLayerConfig();
+      const {
+        indices,
+        positions
+      } = this.initSprite(spriteRadius, spriteCount, ...center);
+      this.positions = positions;
+      this.indices = indices;
+      return {
+        vertices: positions,
+        indices,
+        size: 5
+      };
+    });
+  }
+  initSprite(radius = 10, spriteCount = 100, lng = 120, lat = 30) {
+    const indices = [];
+    const positions = [];
+    const heightLimit = this.spriteAnimate === SPRITE_ANIMATE_DIR.UP ? -this.spriteTop : this.spriteTop;
+    for (let i = 0; i < spriteCount; i++) {
+      const height = Math.random() * heightLimit;
+      positions.push(...getPos(height));
+    }
+    for (let i = 0; i < spriteCount; i++) {
+      indices.push(i);
+    }
+    function getPos(z) {
+      const randomX = radius * Math.random();
+      const randomY = radius * Math.random();
+      const x = -radius / 2 + randomX;
+      const y = -radius / 2 + randomY;
+      return [x + lng, -y + lat, z, 0, 0];
+    }
+    return {
+      indices,
+      positions
+    };
+  }
+  getUninforms() {
+    const commoninfo = this.getCommonUniformsInfo();
+    const attributeInfo = this.getUniformsBufferInfo(this.getStyleAttribute());
+    this.updateStyleUnifoms();
+    return (0, _objectSpread2.default)((0, _objectSpread2.default)({}, commoninfo.uniformsOption), attributeInfo.uniformsOption);
+  }
+  getCommonUniformsInfo() {
+    const {
+      opacity,
+      mapTexture,
+      spriteScale = 1
+    } = this.layer.getLayerConfig();
+    if (this.mapTexture !== mapTexture) {
+      var _this$texture;
+      this.mapTexture = mapTexture;
+      (_this$texture = this.texture) === null || _this$texture === void 0 || _this$texture.destroy();
+      this.textures = [];
+      this.updateTexture(mapTexture);
+    }
+    const commonOptions = {
+      u_opacity: opacity || 1,
+      u_mapFlag: mapTexture ? 1 : 0,
+      u_Scale: spriteScale,
+      u_texture: this.texture
+    };
+    this.textures = [this.texture];
+    const commonBufferInfo = this.getUniformsBufferInfo(commonOptions);
+    return commonBufferInfo;
+  }
+  clearModels() {
+    var _this$texture2;
+    cancelAnimationFrame(this.timer);
+    (_this$texture2 = this.texture) === null || _this$texture2 === void 0 || _this$texture2.destroy();
+    this.textures = [];
+  }
+  initModels() {
+    var _this = this;
+    return (0, _asyncToGenerator2.default)(function* () {
+      const {
+        mapTexture,
+        spriteTop = 300,
+        spriteUpdate = 10,
+        spriteAnimate = SPRITE_ANIMATE_DIR.DOWN
+      } = _this.layer.getLayerConfig();
+      _this.initUniformsBuffer();
+      _this.mapTexture = mapTexture;
+      _this.spriteTop = spriteTop;
+      _this.spriteUpdate = spriteUpdate;
+      spriteAnimate === 'up' ? _this.spriteAnimate = SPRITE_ANIMATE_DIR.UP : _this.spriteAnimate = SPRITE_ANIMATE_DIR.DOWN;
+      const {
+        createTexture2D
+      } = _this.rendererService;
+      _this.texture = createTexture2D({
+        height: 0,
+        width: 0
+      });
+      _this.updateTexture(mapTexture);
+      setTimeout(() => {
+        _this.updatePosition();
+      }, 100);
+      const model = yield _this.layer.buildLayerModel({
+        moduleName: 'geometrySprite',
+        vertexShader: spriteVert,
+        fragmentShader: spriteFrag,
+        triangulation: _this.planeGeometryTriangulation,
+        defines: _this.getDefines(),
+        inject: _this.getInject(),
+        primitive: _l7Core.gl.POINTS,
+        depth: {
+          enable: false
+        },
+        blend: _this.getBlend()
+      });
+      return [model];
+    })();
+  }
+  buildModels() {
+    var _this2 = this;
+    return (0, _asyncToGenerator2.default)(function* () {
+      return _this2.initModels();
+    })();
+  }
+  updateTexture(mapTexture) {
+    const {
+      createTexture2D
+    } = this.rendererService;
+    if (mapTexture) {
+      const img = new Image();
+      img.crossOrigin = 'anonymous';
+      img.onload = () => {
+        this.texture = createTexture2D({
+          data: img,
+          width: img.width,
+          height: img.height,
+          wrapS: _l7Core.gl.CLAMP_TO_EDGE,
+          wrapT: _l7Core.gl.CLAMP_TO_EDGE
+        });
+        this.layerService.reRender();
+      };
+      img.src = mapTexture;
+    } else {
+      this.texture = createTexture2D({
+        width: 1,
+        height: 1
+      });
+    }
+  }
+  registerBuiltinAttributes() {
+    return '';
+  }
+}
+exports.default = SpriteModel;

package/lib/geometry/shaders/billboard_frag.glsl

@@ -0,0 +1,18 @@
+layout(std140) uniform commonUniforms {
+  vec2 u_size;
+  float u_raisingHeight;
+  float u_rotation;
+  float u_opacity;
+};
+
+uniform sampler2D u_texture;
+
+in vec2 v_uv;
+out vec4 outputColor;
+
+#pragma include "picking"
+void main() {
+  outputColor = texture(SAMPLER_2D(u_texture), vec2(v_uv.x, 1.0 - v_uv.y));
+  outputColor.a *= u_opacity;
+  outputColor = filterColor(outputColor);
+}

package/lib/geometry/shaders/billboard_vert.glsl

@@ -0,0 +1,43 @@
+layout(location = ATTRIBUTE_LOCATION_POSITION) in vec3 a_Position;
+layout(location = ATTRIBUTE_LOCATION_EXTRUDE) in vec3 a_Extrude;
+layout(location = ATTRIBUTE_LOCATION_UV) in vec2 a_Uv;
+
+layout(std140) uniform commonUniforms {
+  vec2 u_size;
+  float u_raisingHeight;
+  float u_rotation;
+  float u_opacity;
+};
+
+out vec2 v_uv;
+
+#pragma include "projection"
+#pragma include "picking"
+#pragma include "rotation_2d"
+void main() {
+  vec3 extrude = a_Extrude;
+  v_uv = a_Uv;
+  float raiseHeight = u_raisingHeight;
+  if (
+    u_CoordinateSystem == COORDINATE_SYSTEM_LNGLAT ||
+    u_CoordinateSystem == COORDINATE_SYSTEM_LNGLAT_OFFSET
+  ) {
+    float mapboxZoomScale = 4.0 / pow(2.0, 21.0 - u_Zoom);
+    raiseHeight = u_raisingHeight * mapboxZoomScale;
+  }
+
+  // 计算经纬度点位坐标
+  vec4 project_pos = project_position(vec4(a_Position.xy, 0.0, 1.0));
+
+  // 计算绕 z 轴旋转后的偏移
+  vec2 offsetXY = project_pixel(rotate_matrix(vec2(extrude.x * u_size.x, 0.0), u_rotation));
+  // 绕 z 轴旋转
+  float x = project_pos.x + offsetXY.x;
+  float y = project_pos.y + offsetXY.y;
+  // z 轴不参与旋转
+  float z = project_pixel(extrude.y * u_size.y + raiseHeight);
+
+  gl_Position = project_common_position_to_clipspace(vec4(x, y, z, 1.0));
+
+  setPickingColor(a_PickingColor);
+}

package/lib/geometry/shaders/plane_frag.glsl

@@ -0,0 +1,23 @@
+uniform sampler2D u_texture;
+layout(std140) uniform commonUniforms {
+  float u_opacity;
+  float u_mapFlag;
+  float u_terrainClipHeight;
+};
+
+in vec3 v_Color;
+in vec2 v_uv;
+in float v_clip;
+out vec4 outputColor;
+
+#pragma include "picking"
+void main() {
+  if (u_mapFlag > 0.0) {
+    outputColor = texture(SAMPLER_2D(u_texture), vec2(v_uv.x, 1.0 - v_uv.y));
+    outputColor.a *= u_opacity;
+  } else {
+    outputColor = vec4(v_Color, u_opacity);
+  }
+  outputColor.a *= v_clip;
+  outputColor = filterColor(outputColor);
+}