API Reference / api/level/Location / Location

Class: Location

Defined in: api/level/Location.d.ts:6

该位置的三维位置表示，包含在维度中的一级。

Extends

• Position

Constructors

new Location()

new Location(
   dim, 
   x, 
   y, 
   z, 
   pitch, 
   yaw): Location

Defined in: api/level/Location.d.ts:7

Parameters

dim

Dimension

x

number

y

number

z

number

pitch

number

yaw

number

Returns

Location

Overrides

Position.constructor

Properties

x

x: number;

Defined in: api/util/Vector.d.ts:10

Inherited from

Position.x

---

y

y: number;

Defined in: api/util/Vector.d.ts:11

Inherited from

Position.y

---

z

z: number;

Defined in: api/util/Vector.d.ts:12

Inherited from

Position.z

Methods

distance()

distance(other): number

Defined in: api/util/Vector.d.ts:81

获取从当前向量到另一个向量的距离。

Parameters

other

Vector

其他向量

Returns

number

距离

Inherited from

Position.distance

---

distanceSquared()

distanceSquared(other): number

Defined in: api/util/Vector.d.ts:89

获取从当前向量到另一个向量的平方距离。

Parameters

other

Vector

其他向量

Returns

number

距离

Inherited from

Position.distanceSquared

---

getBlockX()

getBlockX(): number

Defined in: api/level/Position.d.ts:30

获取X组件的下确界值。这表示这个位置所包含的块ID为多少。

Returns

number

块 X

Inherited from

Position.getBlockX

---

getBlockY()

getBlockY(): number

Defined in: api/level/Position.d.ts:37

获取Y组件的下确界值。这表示这个位置所包含的块ID为多少。

Returns

number

块 Y

Inherited from

Position.getBlockY

---

getBlockZ()

getBlockZ(): number

Defined in: api/level/Position.d.ts:44

获取Z组件的下确界值。这表示这个位置所包含的块ID为多少。

Returns

number

块 Z

Inherited from

Position.getBlockZ

---

getDimension()

getDimension(): Dimension

Defined in: api/level/Position.d.ts:16

获取这个位置所在的维度

Returns

Dimension

包含这个位置的维度对象，或如果未设置，则返回null。

Inherited from

Position.getDimension

---

getPitch()

getPitch(): number

Defined in: api/level/Location.d.ts:23

获取这个位置的坡度，以度为单位测量。坡度是水平方向、负y方向、向上方向或正y方向之间的角度。

Returns

number

块的坡度

---

getX()

getX(): number

Defined in: api/util/Vector.d.ts:21

获取X分量。

Returns

number

X分量。

Inherited from

Position.getX

---

getY()

getY(): number

Defined in: api/util/Vector.d.ts:28

获取Y分量。

Returns

number

Y分量。

Inherited from

Position.getY

---

getYaw()

getYaw(): number

Defined in: api/level/Location.d.ts:43

获取这个位置的 yaw，以度为单位测量。yaw是顺时针方向或逆时针方向之间的角度。

Returns

number

旋转的yaw

---

getZ()

getZ(): number

Defined in: api/util/Vector.d.ts:35

获取Z分量。

Returns

number

Z分量。

Inherited from

Position.getZ

---

length()

length(): number

Defined in: api/util/Vector.d.ts:66

获取向量的模，定义为sqrt(x^2 + y^2 + z^2)。

Returns

number

模长

Inherited from

Position.length

---

lengthSquared()

lengthSquared(): number

Defined in: api/util/Vector.d.ts:73

获取向量的平方模。

Returns

number

模长的平方

Inherited from

Position.lengthSquared

---

setDimension()

setDimension(dimension): void

Defined in: api/level/Position.d.ts:23

设置这个位置所在的维度

Parameters

dimension

Dimension

新的维度对象，该位置将位于其中

Returns

void

Inherited from

Position.setDimension

---

setPitch()

setPitch(pitch): void

Defined in: api/level/Location.d.ts:36

设置这个位置的坡度，以度为单位测量。坡度是水平方向、负y方向、向上方向或正y方向之间的角度。

• 一个坡度为0表示面向水平方向。
• 一个坡度为90表示向下方向（负Y方向）。
• 一个坡度为-90表示向上方向（正Y方向）。

增加坡度值相当于向下看。

Parameters

pitch

number

新坡度的坡度

Returns

void

---

setX()

setX(x): number

Defined in: api/util/Vector.d.ts:43

设置X分量。

Parameters

x

number

新的X分量。

Returns

number

这个向量。

Inherited from

Position.setX

---

setY()

setY(y): number

Defined in: api/util/Vector.d.ts:51

设置Y分量。

Parameters

y

number

新的Y分量。

Returns

number

这个向量。

Inherited from

Position.setY

---

setYaw()

setYaw(yaw): void

Defined in: api/level/Location.d.ts:57

设置这个位置的 yaw，以度为单位测量。yaw是顺时针方向或逆时针方向之间的角度。

• 一个 yaw为0或360表示正Z方向。
• 一个 yaw为180表示负Z方向。
• 一个 yaw为90表示负X方向。
• 一个 yaw为270表示正X方向。

增加yaw值相当于向右-facing，增加下 respective轴的缩放，减少上 respective轴的缩放

Parameters

yaw

number

新旋转的yaw

Returns

void

---

setZ()

setZ(z): number

Defined in: api/util/Vector.d.ts:59

设置Z分量。

Parameters

z

number

新的Z分量。

Returns

number

这个向量。

Inherited from

Position.setZ

---

toString()

toString(): string

Defined in: api/level/Location.d.ts:16

Returns

string

Overrides

Position.toString