# 球坐标（[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] - 与 y (up) 轴的极角（以弧度为单位）。 默认值为 *0*。
[page:Float theta] - 绕 y (up) 轴的赤道角(方位角)（以弧度为单位）。 默认值为 *0*。
极角（phi）位于正 y 轴和负 y 轴上。赤道角(方位角)（theta）从正 z 开始。

## 属性

### [property:Float radius]

### [property:Float phi]

### [property:Float theta]

## 方法

### [method:Spherical clone]()

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

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

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

### [method:this makeSafe]()

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

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

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

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

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

### [method:this 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]