源码分析之Openlayers中Geometry基类介绍

概述

在上一篇文章源码分析之Openlayers中Geom篇中提到Geometry类是继承于 Openlayers 中的BaseObject类(参考源码分析之Openlayers中核心BaseObject类).而Geometry类通常情况下也是作为一个抽象基类,作为Geom几何图形的基类或父类,不会在应用中去实例化它.Geometry类回去注册几何对象实例的监听.当几何对象发生改变时,会收到通知,进而进行其它处理.

源码分析

Geometry类的源码实现

Geometry类的源码实现如下:

class Geometry extends BaseObject {constructor() {super()this.extent_=createEmpty()this.extentRevision_=-1;this.simplifiedGeometryMaxMinSquaredTolerance = 0;this.simplifiedGeometryRevision = 0;this.simplifyTransformedInternal = memoizeOne((revision, squaredTolerance, transform) => {if (!transform) {return this.getSimplifiedGeometry(squaredTolerance);}const clone = this.clone();clone.applyTransform(transform);return clone.getSimplifiedGeometry(squaredTolerance);},);}simplifyTransformed(squaredTolerance, trnasform) {}clone() {return abstract();}closestPointXY(x, y, closestPoint, minSquaredDistance) {return abstract()}containXY(x,y){const corrd=this.getClosetPoint([x,y]);return coord[0] ===x && coord[1] ===y}getClosestPoint(point,closestPoint){closestPoint= closestPoint ? closestPoint:[NaN,NaN];this.closestPointXY(point[0],point[1],closestPoint,Infinity)return closestPoint;}intersectsCoordinate(coordinate){return this.containsXY(coordinate[0],coordinate[1])}computeExtent(extent){return abstract()}getExtent(extent){if(this.extentRevision_!this.getRevision()){const extent=this.computeExtent(this.extent_);if(isNaN(extent[0])||isNaN(extent[1])){createOrUpdateEmpty(extent)}this.extentRevision_=this.getRevision();}return returnOrUpdate(this.extent_,extent)}rotate(angle,anchor){abstract()}scale(xs,xy,anchor){abstract()}simplify(tolerance){return this.getSimplifiedGeometry(tolerance * tolerance)}getSimplifiedGeometry(squaredTolerance){return abstract();}getType(){return abstract();}applyTransform(transformFn){abstract()}intersectsExtent(extent){return abstract()}translate(deltaX,deltaY){abstract()}transform(source,destination){const tmpTransform=createTransform()const sourceProj=getProjection(source);const transformFn= sourceProj.getUnits()=='tile-pixels'?function (inCoordinates,outCoordinates,stride){const pixelExtent=sourceProj.getExtent();const projectedExtent = sourceProj.getWorldExtent();const scale=getHeight(projectedExtent)/getHeight(pixelExtent);composeTransform(tmpTransform,projectedExtent[0],projectedExtent[3]),scale,-scale,0,0,0);transform2D(inCoordinates,0,inCoordinates.length,stride,tmpTransform,outCoordinates);return getTransform(sourceProj,destination)(inCoordinates,outCoordinates,stride)}: getTransform(sourceProj,destination);this.appyTransform(transformFn)return this;}
}

Geometry类构造函数

Geometry类的构造函数中调用createEmpty方法返回了一个数组[Infinity, Infinity, -Infinity, -Infinity]给this.extent_,this.extent_表示的是几何对象的边界范围;然后初始化this.extentRevision_为-1,这个变量是用来记录边界范围的更改次数(修订版本);再初始化this.simplifiedGeometryMaxMinSquaredTolerance变量即几何对象的最大最小平方公差为0,初始化this.simplifiedGeometryRevision为0,记录几何对象的变化次数;调用memoizeOne方法用于获取几何对象的转换和简化版本,返回值赋给this.simplifyTransformedInternal.

memoizeOne方法主要就是包装并返回一个函数,它会记录函数第一次被调用时的返回值,参数以及this,当函数再次被调用时,它会拿新的参数和this与记录上一次的参数和this作比较,若他们相同,则直接返回上一次的返回值;否则执行函数,并再次记录下返回值,参数和this用于下一次被调用时作比较.

Geometry类的方法

Geometry类中定义了一些方法,其中有许多未实现,只是定义了,实现的是基础核心的方法,如下:

• simplifyTransformed方法:接受两个参数squaredTolerance平方公差和transform转换函数,内部就是调用this.simplifyTransformedInternal方法并返回结果

• clone方法:未实现,用于复制几何对象

• closestPointXY方法:未实现,用于比较一个目标点与几何对象中的点之间的距离,并更新最近点的坐标,返回更小的距离

• containsXY方法:接受一个坐标x和y,然后调用this.getClosestPoint获取最近点坐标,判断参数坐标是不是与最近点坐标相同

• getClosestPoint方法:接受两个坐标,目标点坐标和最近点坐标,其中若最近点坐标不存在,则赋值为[NaN,NaN],然后调用this.closestPointXY更新最近点坐标并返回

• intersectsCoordinate方法:接受一个点坐标,然后调用this.containsXY并返回;该方法就是用于判断点是否在几何对象的边界上;

• computeExtent方法:未实现,用于计算边界范围

• getExtent方法:用于获取边界范围;内部会调用this.getRevision方法获取revision_,它们都是在Observable类中定义的,Observable类就是BaseObject类的父类,关于Observable类可以参考;当获取到的revision和this.extentRevision_不等时,会调用this.computeExtent计算边界范围,然后判断,若计算得到的extent不存在,则调用createOrUpdateEmpty创建一个边界范围,然后更新this.extentRevision_的值,最后调用returnOrUpdate得到边界范围并返回.

• rotate方法:未实现,该方法就是给定一个坐标值,然后旋转几何对象,这个操作会修改几何对象的坐标

• scale方法:未实现,该方法用于对几何对象进行缩放,同样地,会修改几何对象的坐标值

• simplify方法:未实现,该方法用于创建一个几何对象的简化版本

• getSimplifiedGeometry方法:未实现,该方法用于获取几何对象的简化版

• getType方法:未实现,该方法用于获取几何对象的类型

• applyTransform方法:未实现,该方法用于对几何对象的坐标应用transform函数进行转换,

• intersectsExtent方法:未实现,该方法用于判断几何对象与参数extent范围是否相交

• translate方法:该方法用于对几何对象进行平移,同样地,会修改几何对象的坐标值

• transform方法:该方法目的是将几何对象的坐标从一个投影系转换到另一个投影系.接受两个参数source源投影和destination目标投影;先是调用getProjection获取源投影source的投影对象,然后判断,若投影对象的单位类型是栅格投影,就获取源投影的像素范围pixelExtent和projectedExtent投影范围,通过它们计算一个缩放比例scale,然后调用composeTransform构建一个转换矩阵tmpTransform,用于像素坐标转换到投影坐标.然后调用transform2D,通过转换矩阵tmpTransform将输入坐标inCoordinates转化为目标坐标outCoordinates,再调用getTransform获取坐标转换函数,该函数就是用于将坐标从源投影转换到目标投影;若投影对象的单位类型不是栅格投影,则直接使用getTransform获取转换函数;最后调用this.applyTransform将得到的transformFn作为变换函数应用到几何对象上,对几何对象的所有点坐标进行转换.

总结

Openlayers 中的 Geometry 类是所有几何类型的基础类，通过继承它的子类，可以表示不同类型的几何对象。Geometry 类提供了丰富的方法来操作几何数据，如坐标变换、几何计算、空间关系判断等.