SuperMap.Geometry.Point

点几何对象类。

Inherits from

SuperMap.Geometry

Summary

SuperMap.Geometry.Point	点几何对象类。
Properties
tag	{float} 用来存储额外的属性，比如差值分析中的Z值。
type	{string} 用来存储点的类型
x	{float}横坐标。
y	{float}纵坐标。
Constructor
SuperMap.Geometry.Point	实例化点对象。
Functions
clone	克隆点对象。 Returns: {SuperMap.Geometry.Point} 克隆后的点对象。
distanceTo	计算两个点对象间的最小距离（x-y平面坐标系下）。
equals	判断两个点对象是否相等。如果两个点对象具有相同的坐标，则认为是相等的。
getCentroid	获取点对象的质心。 Returns: {SuperMap.Geometry.Point} 点对象的质心。
getVertices	返回点对象的所有顶点的列表。
intersects	判断两个几何对象是否相交。
move	沿着x、y轴的正方向上按照给定的位移移动点对象，move 不仅改变了几何对象的位置并且清理了边界缓存。
resize	调整几何对象相对于原点的大小。
rotate	围绕中心点旋转点对象。
transform	投影转换。

Properties

x

{float}横坐标。

y

{float}纵坐标。

tag

{float} 用来存储额外的属性，比如差值分析中的Z值。

type

{string} 用来存储点的类型

Constructor

SuperMap.Geometry.Point

实例化点对象。

var point = new SuperMap.Geometry.Point(-111.04, 45.68);

Parameters

x	{float} x-坐标
y	{float} y-坐标
type	{String} 用来存储点的类型
tag	{float} 用来存储额外的属性，比如差值分析中的Z值。

Functions

clone

clone: function( obj )

克隆点对象。 Returns: {SuperMap.Geometry.Point} 克隆后的点对象。

distanceTo

distanceTo: function( geometry,

options )

计算两个点对象间的最小距离（x-y平面坐标系下）。

Parameters

geometry	{SuperMap.Geometry} 目标点对象。
options	{Object} 计算距离时需要设置的可选属性。有效的选项取决于特定的几何类型。

Valid options

details	{Boolean} 返回距离计算的细节。默认为false。
edge	{Boolean} 计算一个几何对象到目标几何对象边缘的最近距离。默认为true。如果设为true，一个几何对象完全包含在目标几何对象中时，调用distanceTo返回非零结果，如果false，两个几何对象相交情况下调用distanceTo结果返回0，而且如果false，将不返距离。

Returns

{Number | Object} 返回一个几何对象到目标几何对象的距离。

equals

equals: function( geom )

判断两个点对象是否相等。如果两个点对象具有相同的坐标，则认为是相等的。

var point= new SuperMap.Geometry.Point(0,0);
var point1={x:0,y:0};
var result= point.equals(point1);

Parameters

geom	{SuperMap.Geometry.Point} 需要判断的点对象。

Returns

{Boolean} 两个点对象是否相等（true为相等，false为不等）。

move

move: function( x,

y )

沿着x、y轴的正方向上按照给定的位移移动点对象，move 不仅改变了几何对象的位置并且清理了边界缓存。

Parameters

x	{Float} x轴正方向上的偏移量。
y	{Float} y轴正方向上偏移量。

var point = new SuperMap.Geometry.Point(10,20);
var dx = 10*Math.random();
var dy = 10*Math.random();
point.move(dx,dy);

rotate

rotate: function( angle,

origin )

围绕中心点旋转点对象。

Parameters

angle	{Float} 旋转角的度数（沿着x轴正方向的逆时针方向）。
origin	{SuperMap.Geometry.Point} 旋转的中心点。

var point = new SuperMap.Geometry.Point(10,20);
var rotateOrigin = new SuperMap.Geometry.Point(5,10);
point.rotate(360,rotateOrigin);

getCentroid

getCentroid: function()

获取点对象的质心。 Returns: {SuperMap.Geometry.Point} 点对象的质心。

resize

resize: function( scale,

origin,

ratio )

调整几何对象相对于原点的大小。

Parameters

scale	{Float} resize之后到原点的距离与resize之前到原点的距离比。
origin	{SuperMap.Geometry.Point} 调整的起始点。
ratio	{Float} 点对象自身x与y的比值：ratio=x/y，默认的比例为1，不推荐设置。

Returns

{SuperMap.Geometry}

当前几何对象。

var point = new SuperMap.Geometry.Point(10,10);
var origin = new SuperMap.Geometry.Point(0,0);
point.resize(2,origin,4);

intersects

intersects: function( geometry )

判断两个几何对象是否相交。

Parameters

geometry

{SuperMap.Geometry} 任意类型的几何对象。

Returns

{Boolean} 传入的几何对象与当前几何对象相交。

transform

transform: function( source,

dest )

投影转换。

Parameters

source	{SuperMap.Projection} 源对象投影。
dest	{SuperMap.Projection} 目标对象投影。

Returns

{SuperMap.Geometry.Point}转换后的点对象。

var point = new SuperMap.Geometry.Point(10,20);
point.transform(new SuperMap.Projection("EPSG:4326"),new SuperMap.Projection("EPSG:900913"));

getVertices

getVertices: function( nodes )

返回点对象的所有顶点的列表。

Parameters

nodes

{Boolean} 对于点对象此参数不起作用，直接返回点。

Returns

{Array} 几何图形的顶点列表。