概述

在 OpenLayers 中，LinearRing 类用于表示封闭的线段集合（即多段线）形成的环状路径。LinearRing 是 SimpleGeometry 的子类，继承自几何图形类。它通常用于描述多边形的外边界或孔洞边界，本质上它就是一个封闭的线段路径，首尾点必须是重合的，形成一个封闭环。

本文主要介绍LinearRing类的源码实现和原理。

源码分析

LinearRing类源码实现

class LinearRing extends SimpleGeometry {
  constructor(coordinates, layout) {
    super();
    this.maxDelta_ = -1;
    this.maxDeltaRevision_ = -1;
    if (layout !== undefined && !Array.isArray(coordinates[0])) {
      this.setFlatCoordinates(layout, coordinates);
    } else {
      this.setCoordinates(coordinates, layout);
    }
  }

  clone() {
    return new LinearRing(this.flatCoordinates.slice(), this.layout);
  }

  closestPointXY(x, y, closestPoint, minSquaredDistance) {
    if (minSquaredDistance < closestSquaredDistanceXY(this.getExtent(), x, y)) {
      return minSquaredDistance;
    }
    if (this.maxDeltaRevision_ != this.getRevision()) {
      this.maxDelta_ = Math.sqrt(
        maxSquaredDelta(
          this.flatCoordinates,
          0,
          this.flatCoordinates.length,
          this.stride,
          0
        )
      );
      this.maxDeltaRevision_ = this.getRevision();
    }
    return assignClosestPoint(
      this.flatCoordinates,
      0,
      this.flatCoordinates.length,
      this.stride,
      this.maxDelta_,
      true,
      x,
      y,
      closestPoint,
      minSquaredDistance
    );
  }

  getArea() {
    return linearRingArea(
      this.flatCoordinates,
      0,
      this.flatCoordinates.length,
      this.stride
    );
  }

  getCoordinates() {
    return inflateCoordinates(
      this.flatCoordinates,
      0,
      this.flatCoordinates.length,
      this.stride
    );
  }

  getSimplifiedGeometryInternal(squaredTolerance) {
    const simplifiedFlatCoordinates = [];
    simplifiedFlatCoordinates.length = douglasPeucker(
      this.flatCoordinates,
      0,
      this.flatCoordinates.length,
      this.stride,
      squaredTolerance,
      simplifiedFlatCoordinates,
      0
    );
    return new LinearRing(simplifiedFlatCoordinates, "XY");
  }

  getType() {
    return "LinearRing";
  }

  intersectsExtent(extent) {
    return false;
  }

  setCoordinates(coordinates, layout) {
    this.setLayout(layout, coordinates, 1);
    if (!this.flatCoordinates) {
      this.flatCoordinates = [];
    }
    this.flatCoordinates.length = deflateCoordinates(
      this.flatCoordinates,
      0,
      coordinates,
      this.stride
    );
    this.changed();
  }
}

LinearRing类的构造函数

LinearRing类的构造函数中定义了两个变量this.maxDelta_和this.maxDeltaRevision_，这两个变量都与优化和性能相关，在LinearRing类的管理和更新时，可以避免不必要的计算，具体如下

• this.maxDelta_:该变量通常用于控制几何形状的精度或处理几何更新时的变化阈值。初始值为-1，表示初始、未定义的状态，还没有设置具体的最大变化量；实际的值通常是在更新几何图形时进行设定；当几何图形的顶点发生变化时，this.maxDelta_会用来判断这些变化是否超出阈值，若没有，这不会触发重新渲染或计算的操作；
• this.maxDeltaRevision_：初始值也是-1，该变量是用于跟踪几何图形修订版本的变量。它存储了上次更新时的修订版本号，用于判断当前几何形状是否发生了变化。每当几何形状的顶点或属性更新时，this.maxDeltaRevision_ 会被更新。如果当前版本与上次的版本不一致，可能会触发一些操作，比如重新计算、重新渲染或者优化缓存等。该变量有助于优化性能，因为在很多情况下，OpenLayers 需要检查对象是否发生了变化。如果当前修订版本与上次的修订版本一致，那么可以跳过一些不必要的操作。

除了定义上述两个变量外,LinearRing类还会判断构造函数的第二个参数layout是否存在，若不存在，且参数coordinates的第一个值不是数组，则调用父类SimpleGeometry类中的this.setFlatCoordinates方法；否则调用this.setCoordinates方法，二者都是会设置this.layout、this.stride和this.flatCoordinates的值。

LinearRing类的主要方法

LinearRing类的主要方法如下：

• clone方法：用于克隆一个LinearRing几何对象，内部就是实例化LinearRing类并返回实例。

• closestPointXY方法：接受四个参数，目标点坐标x、y、最近点坐标closestPoint和最短距离平方minSquaredDistance;首先会判断，若minSquaredDistance小于目标点离包围盒的距离(该距离是调用closetSquaredDistanceXY方法计算)，则返回minSquaredDistance;然后调用this.getRevision()方法获取几何对象的修改次数，若该次数不等于this.maxDeltaRevision_,则调用maxSquaredDelta方法计算几何对象相邻点之间的最大平方距离并将其平方根赋值给this.maxDelta_,并调用this.getRevision()将返回值赋值给this.maxDeltaRevision_;最后调用assignClosePoint方法并返回，assignClosePoint方法就是寻找一组坐标点中离给定点 (x, y) 最近的点，并返回该点的平方距离。该方法是计算几何中点之间最近距离的一种实现，特别适用于路径、线段、或者多边形边界等几何结构，常用于计算点到线的最近距离，或者优化几何数据结构。所以closestPointXY同Point类的同名方法作用一样，修改最近点坐标并返回最短距离

• getArea方法：获取几何对象的面积，内部是调用linearRingArea方法，该方法的原理是使用**Shoelace定理**（或高斯面积公式）计算多边形的面积。

• getCoordinates方法：获取几何对象的坐标，内部是调用inflateCoordinates方法

• getSimplifiedGeometryInternal方法：内部方法，获取简化的几何对象，接受一个参数squaredTolerance，该参数表示一个距离阈值的平方，用于控制在多大程度上可以去除多余的点，即控制简化的精度，值越大，去除的点更多；内部利用了Douglas-Peucker算法来对多边形进行简化。

• getType方法：获取几何对象的类型，返回LinearRing类

• intersectsExtent方法：返回false

• setCoordinates方法:设置坐标，主要还是赋值，内部会调用deflateCoordinates方法修改三个变量this.stride、this.layout和this.flatCoordinates，最后会调用this.changed方法

总结

本文介绍了LinearRing类的源码实现，LinearRing类通常情况下实例化后不会直接被渲染，而是在Polygon类中用于构建多边形。