浏览代码

Updated Spherical and Cylindrical docs

Lewy Blue 8 年之前
父节点
当前提交
7915d1a99c
共有 4 个文件被更改,包括 48 次插入39 次删除
  1. 24 15
      docs/api/math/Cylindrical.html
  2. 0 2
      docs/api/math/Plane.html
  3. 1 4
      docs/api/math/Sphere.html
  4. 23 18
      docs/api/math/Spherical.html

+ 24 - 15
docs/api/math/Cylindrical.html

@@ -10,17 +10,20 @@
 	<body>
 		<h1>[name]</h1>
 
-		<div class="desc">A point's cylindrical coordinates.</div>
+		<div class="desc">
+			A point's [link:https://en.wikipedia.org/wiki/Cylindrical_coordinate_system cylindrical coordinates].
+		</div>
 
 
 		<h2>Constructor</h2>
 
-
 		<h3>[name]( [page:Float radius], [page:Float theta], [page:Float y] )</h3>
 		<div>
-		radius -- [page:Float] distance from the origin to a point in the x-z plane<br />
-		theta -- [page:Float] counterclockwise angle in the x-z plane measured in radians from the positive z-axis<br />
-		y -- [page:Float] height above the x-z plane
+		[page:Float radius] - distance from the origin to a point in the x-z plane.
+		Default is *1.0*.<br />
+		[page:Float theta] - counterclockwise angle in the x-z plane measured in radians
+		from the positive z-axis. Default is *0*.<br />
+		[page:Float y] - height above the x-z plane. Default is *0*.
 		</div>
 
 
@@ -35,24 +38,30 @@
 
 		<h2>Methods</h2>
 
-		<h3>[method:Cylindrical set]( [page:Float radius], [page:Float theta], [page:Float y] ) [page:Cylindrical this]</h3>
+		<h3>[method:Cylindrical clone]()</h3>
 		<div>
-		Sets values of this cylindrical's component coordinates.
+		Returns a new cylindrical with the same [page:.radius radius], [page:.theta theta]
+		and [page:.y y] properties as this one.
 		</div>
 
-		<h3>[method:Cylindrical copy]( [page:Cylindrical c] ) [page:Cylindrical this]</h3>
+		<h3>[method:Cylindrical copy]( [page:Cylindrical other] )</h3>
 		<div>
-		Copies value of *c* to this cylindrical.
+			Copies the values of the passed Cylindrical's [page:.radius radius], [page:.theta theta]
+			and [page:.y y] properties to this cylindrical.
 		</div>
 
-		<h3>[method:Cylindrical clone]() [page:Cylindrical this]</h3>
-		<div>
-		Clones this cylindrical.
-		</div>
+		<h3>[method:Cylindrical set]( [page:Float radius], [page:Float phi], [page:Float theta] )</h3>
+		<div>Sets values of this cylindrical's [page:.radius radius], [page:.theta theta]
+		and [page:.y y] properties.</div>
 
-		<h3>[method:Cylindrical setFromVector3]( [page:Vector3 v] ) [page:Cylindrical this]</h3>
+		<h3>[method:Cylindrical setFromVector3]( [page:Vector3 vec3] )</h3>
 		<div>
-		Sets this object from the vector *v*.
+			Sets values of this cylindrical's [page:.radius radius], [page:.theta theta]
+			and [page:.y y] properties from the [page:Vector3 Vector3].<br /><br />
+
+			The [page:.radius radius] is set the vector's distance from the origin as measured along
+			the the x-z plane, while [page:.theta theta] is set from its direction on
+			the the x-z plane and [page:.y y] is set from the vector's y component.
 		</div>
 
 		<h2>Source</h2>

+ 0 - 2
docs/api/math/Plane.html

@@ -62,8 +62,6 @@
 
 		<h3>[method:Plane copy]( [page:Plane plane] )</h3>
 		<div>
-		[page:Plane plane] - the [page:Plane] to copy<br /><br />
-
 		Copies the values of the passed plane's [page:.normal normal] and [page:.constant constant]
 		properties to this plane.
 		</div>

+ 1 - 4
docs/api/math/Sphere.html

@@ -10,12 +10,9 @@
 	<body>
 		<h1>[name]</h1>
 
-		<div class="desc">A geometric sphere defined by a center position and radius.</div>
-
+		<div class="desc">A sphere defined by a center and radius.</div>
 
 		<h2>Constructor</h2>
-
-
 		<h3>[name]( [page:Vector3 center], [page:Float radius] )</h3>
 		<div>
 		[page:Vector3 center] - center of the sphere. Default is a [page:Vector3] at (0, 0, 0). <br />

+ 23 - 18
docs/api/math/Spherical.html

@@ -10,7 +10,7 @@
 	<body>
 		<h1>[name]</h1>
 
-		<div class="desc">A point's spherical coordinates.</div>
+		<div class="desc">A point's [link:https://en.wikipedia.org/wiki/Spherical_coordinate_system spherical coordinates].</div>
 
 
 		<h2>Constructor</h2>
@@ -18,11 +18,11 @@
 
 		<h3>[name]( [page:Float radius], [page:Float phi], [page:Float theta] )</h3>
 		<div>
-		radius -- [page:Float] the radius<br />
-		phi -- [page:Float] polar angle from the y (up) axis<br />
-		theta -- [page:Float] equator angle around the y (up) axis
-		</div>
-		<div>
+		[page:Float radius] - the radius, or the Euclidean distance from the point to the
+		origin. Default is *1.0*.<br />
+		[page:Float phi] - polar angle from the y (up) axis. Default is *0*.<br />
+		[page:Float theta] - equator angle around the y (up) axis. Default is *0*.<br /><br />
+
 		The poles (phi) are at the positive and negative y axis. The equator (theta) starts at positive z.
 		</div>
 
@@ -38,29 +38,34 @@
 
 		<h2>Methods</h2>
 
-		<h3>[method:Spherical set]( [page:Float radius], [page:Float phi], [page:Float theta] ) [page:Spherical this]</h3>
+		<h3>[method:Spherical clone]()</h3>
 		<div>
-		Sets values of this spherical's component coordinates.
+		Returns a new plane with the same [page:.radius radius], [page:.phi phi]
+		and [page:.theta theta] properties as this one.
 		</div>
 
-		<h3>[method:Spherical copy]( [page:Spherical s] ) [page:Spherical this]</h3>
+		<h3>[method:Spherical copy]( [page:Spherical s] )</h3>
 		<div>
-		Copies value of *s* to this spherical.
+			Copies the values of the passed Spherical's [page:.radius radius], [page:.phi phi]
+			and [page:.theta theta] properties to this spherical.
 		</div>
 
-		<h3>[method:Spherical clone]() [page:Spherical this]</h3>
+		<h3>[method:Spherical makeSafe]()</h3>
 		<div>
-		Clones this spherical.
+		Restricts the polar angle page:.phi phi] to be between 0.000001 and pi - 0.000001.
 		</div>
 
-		<h3>[method:Spherical makeSafe]() [page:Spherical this]</h3>
-		<div>
-		Restricts the polar angle phi to be between 0.000001 and pi - 0.000001.
-		</div>
+		<h3>[method:Spherical set]( [page:Float radius], [page:Float phi], [page:Float theta] )</h3>
+		<div>Sets values of this spherical's [page:.radius radius], [page:.phi phi]
+		and [page:.theta theta] properties.</div>
 
-		<h3>[method:Spherical setFromVector3]( [page:Vector3 v] ) [page:Spherical this]</h3>
+		<h3>[method:Spherical setFromVector3]( [page:Vector3 vec3] )</h3>
 		<div>
-		Sets this object from the vector *v*.
+			Sets values of this spherical's [page:.radius radius], [page:.phi phi]
+			and [page:.theta theta] properties from the [page:Vector3 Vector3].<br /><br />
+
+			The [page:.radius radius] is set the vector's [page:Vector3.length], while the
+			[page:.phi phi] and [page:.theta theta] properties are set from its direction.
 		</div>
 
 		<h2>Source</h2>