Class: Pixel

Pixel

此类用x,y坐标描绘屏幕坐标(像素点)。

new SuperMap.Pixel(x, y, mode)

common/commontypes/Pixel.js, line 3
Name Type Description
x number

x坐标,默认为0.0

y number

y坐标,默认为0.0

mode string

坐标模式,默认为SuperMap.Pixel.Mode.LeftTop

Example
//单独创建一个对象
var pixcel = new SuperMap.Pixel(100,50);

//依据size创建
 var size = new SuperMap.Size(21,25);
 var offset = new SuperMap.Pixel(-(size.w/2), -size.h);

Members

static,readonlySuperMap.Pixel.Modestring

模式

  • SuperMap.Pixel.Mode.LeftTop 左上模式
  • SuperMap.Pixel.Mode.RightTop 右上模式
  • SuperMap.Pixel.Mode.RightBottom 右下模式
  • SuperMap.Pixel.Mode.LeftBottom 左下模式

坐标模式,有左上、右上、右下、左下这几种模式,分别表示相对于左上角、右上角、右下角、左下角的坐标。
值有

这四种 默认值为:SuperMap.Pixel.Mode.LeftTop

Default Value:

xnumber

x坐标,默认为0.0

ynumber

y坐标,默认为0.0

Methods

add(x, y){SuperMap.Pixel}

common/commontypes/Pixel.js, line 117

在原来像素坐标基础上,x值加上传入的x参数,y值加上传入的y参数。

Name Type Description
x number

传入的x值。

y number

传入的y值。

Returns:
Type Description
SuperMap.Pixel 返回一个新的pixel对象,该pixel是由当前的pixel与传 入的x,y相加得到。
Example
var pixcel = new SuperMap.Pixel(100,50);
//pixcel2是新的对象
var pixcel2 = pixcel.add(20,30);

clone(){SuperMap.Pixel}

common/commontypes/Pixel.js, line 67

克隆当前的 pixel 对象。

Returns:
Type Description
SuperMap.Pixel 返回一个新的与当前 pixel 对象有相同x、y坐标的 pixel 对象。
Example
var pixcel = new SuperMap.Pixel(100,50);
var pixcel2 = pixcel.clone();

destroy()

common/commontypes/Pixel.js, line 158

销毁此对象。 销毁后此对象的所有属性为null,而不是初始值。

Example
var pixcel = new SuperMap.Pixel(100,50);
pixcel.destroy();

distanceTo(px){float}

common/commontypes/Pixel.js, line 99

返回两个 pixel 的距离。

Name Type Description
px SuperMap.Pixel

用于计算的一个 pixel

Returns:
Type Description
float 作为参数传入的像素与当前像素点的距离。
Example
var pixcel = new SuperMap.Pixel(100,50);
var pixcel2 = new SuperMap.Pixel(110,30);
var distance = pixcel.distanceTo(pixcel2);

equals(px){Boolean}

common/commontypes/Pixel.js, line 79

比较两 pixel 是否相等

Name Type Description
px SuperMap.Pixel

用于比较相等的 pixel 对象。

Returns:
Type Description
Boolean 如果传入的像素点和当前像素点相同返回true,如果不同或传入参数为NULL则返回false
Example
var pixcel = new SuperMap.Pixel(100,50);
var pixcel2 = new SuperMap.Pixel(100,50);
var isEquals = pixcel.equals(pixcel2);

offset(px){SuperMap.Pixel}

common/commontypes/Pixel.js, line 137

通过传入的 SuperMap.Pixel 参数对原屏幕坐标进行偏移。

Name Type Description
px SuperMap.Pixel

传入的 对象。

Returns:
Type Description
SuperMap.Pixel 返回一个新的pixel,该pixel是由当前的pixel对象的x,y 值与传入的Pixel对象的x,y值相加得到。
Example
var pixcel = new SuperMap.Pixel(100,50);
var pixcel2 = new SuperMap.Pixel(130,20);
//pixcel3 是新的对象
var pixcel3 = pixcel.offset(pixcel2);

toString(){string}

common/commontypes/Pixel.js, line 53

返回此对象的字符串形式

Returns:
Type Description
string 例如: "x=200.4,y=242.2"
Example
var pixcel = new SuperMap.Pixel(100,50);
var str = pixcel.toString();