mapbox加载本地图片

一、前面

mapbox中添加图片addImage看似简单的一个方法,可是在实际的生产过程中却产生了很多的问题,比如如何加载本地图片。这个一个小问题可以来回搞了很久,现在来看多種加载方式是如何实现的:

二、过程

  • HTMLImageElement

    let image = new Image(64, 64);
    // 这里的imageUrl采用require方式调用的base64格式
    image.src = imageUrl;
    image.onload = () =>{
        this.map.addImage("custom-marker", image);
    };
  • ImageBitmap

    ImageBitmap接口表示一个位图图像,可以在WebGL中高效绘制。可以使用函数 createImageBitmap 创建,异步加载

    // 这里的imageData采用require方式调用的base64格式
    //createImageBitmap方法支持的数据格式有, SVG,,, HTMLImageElement, SVGImageElement, HTMLVideoElement, HTMLCanvasElement, Blob, ImageData, ImageBitmap, or OffscreenCanvas object.这里使用Blob
    window.createImageBitmap(this.b64toBlob(imageData), 0, 0, 64, 64).then(res => {
        this.map.addImage("custom-marker", res);
    });
    
    function b64toBlob(dataURI) {
        var byteString = atob(dataURI.split(",")[1]);
        var ab = new ArrayBuffer(byteString.length);
        var ia = new Uint8Array(ab);
    
        for (var i = 0; i < byteString.length; i++) {
            ia[i] = byteString.charCodeAt(i);
        }
        return new Blob([ab], { type: "image/jpeg" });
    }
  • ImageData

    canvas对象的像素数据,可以使用构造器ImageData()创建,也可以用canvas渲染上下文中createImageData()方法创建

    /** @HTMLCanvasElement */
    var canvas = document.createElement("canvas");
    var ctx = canvas.getContext("2d");
    let image = new Image(64, 64);
    image.src = image_Base64;
    
    image.onload = () => {
        ctx.drawImage(image, 0, 0);
        this.map.addImage('custom-marker', ctx.getImageData(0,0,64,64));
    };
  • {width: number, height: number, data: (Uint8Array | Uint8ClampedArray)}

    与ImageData类似

  • StyleImageInterface

    mapbox内部定义的image渲染接口,常用于动态渲染

    var flashingSquare = {
      width: 64,
      height: 64,
      data: new Uint8Array(64 * 64 * 4),
    
      onAdd: function(map) {
        this.map = map;
      },
    
      render: function() {
        // keep repainting while the icon is on the map
        this.map.triggerRepaint();
    
        // alternate between black and white based on the time
        var value = Math.round(Date.now() / 1000) % 2 === 0 ? 255 : 0;
    
        // check if image needs to be changed
        if (value !== this.previousValue) {
          this.previousValue = value;
    
          var bytesPerPixel = 4;
          for (var x = 0; x < this.width; x++) {
            for (var y = 0; y < this.height; y++) {
              var offset = (y * this.width + x) * bytesPerPixel;
              this.data[offset + 0] = value;
              this.data[offset + 1] = value;
              this.data[offset + 2] = value;
              this.data[offset + 3] = 255;
            }
          }
    
          // return true to indicate that the image changed
          return true;
        }
      }
    };
    
    map.addImage("flashing_square", flashingSquare);

三、最后

比较这几种方式,HTMLImageElement是最常用的方式,也是最简单的方式(需要注意这里的Image需要base64的文件,或者服务器上的文件路径);后面的ImageBitmap, ImageData, 常用于canvas渲染中使用,StyleImageInterface是mapbox内置的一种动态渲染接口。