# 球坐标（[name]）

一个点的[link:https://en.wikipedia.org/wiki/Spherical_coordinate_system spherical coordinates]（球坐标）。

## 构造函数

### [name]( [param:Float radius], [param:Float phi], [param:Float theta] )

[page:Float radius] - 半径值，或者说从该点到原点的 [link:https://en.wikipedia.org/wiki/Euclidean_distance Euclidean distance]（欧几里得距离，即直线距离）。默认值为*1.0*。
[page:Float phi] - polar angle from the y (up) axis. Default is *0*.
[page:Float theta] - equator angle around the y (up) axis. Default is *0*.
The poles (phi) are at the positive and negative y axis. The equator (theta) starts at positive z.

## 属性

### [property:Float radius]

### [property:Float phi]

### [property:Float theta]

## 方法

### [method:Spherical clone]()

返回一个新的球坐标，新的球坐标与该球坐标具有相同的 [page:.radius radius]、[page:.phi phi]和[page:.theta theta]。

### [method:Spherical copy]( [param:Spherical s] )

复制所传入的球坐标的[page:.radius radius]、 [page:.phi phi] 和[page:.theta theta]属性到该球坐标中。

### [method:Spherical makeSafe]()

将极角 [page:.phi phi] 的值限制在0.000001 和 pi - 0.000001 之间。

### [method:Spherical set]( [param:Float radius], [param:Float phi], [param:Float theta] )

设置球坐标中[page:.radius radius]、[page:.phi phi] 和 [page:.theta theta] 属性的值。

### [method:Spherical setFromVector3]( [param:Vector3 vec3] )

从[page:Vector3 Vector3]中设置球坐标的[page:.radius radius]、[page:.phi phi]和[page:.theta theta]值。

### [method:Spherical setFromCartesianCoords]( [param:Float x], [param:Float y], [param:Float z] )

从笛卡尔坐标系中设置球坐标的[page:.radius radius]、[page:.phi phi]和[page:.theta theta]值。

## 源代码

[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]