edit docs; make CurveBuilder and SurfaceBuilder work without MeshBuffers

Author: peteroupc

demos/demoutil.js

@@ -213,8 +213,8 @@ function makeMesh(func, resolutionU, resolutionV) {
     .positionNormal(func)
     .attribute(colorGradient, H3DU.Semantic.COLOR)
     // Evaluate the surface and generate a triangle
-    // mesh, using resolution+1 different U coordinates,
-    // and resolution+1 different V coordinates.
+    // mesh, using resolution+1 different u-coordinates,
+    // and resolution+1 different v-coordinates.
     // Instead of H3DU.Mesh.TRIANGLES, we could use
     // H3DU.Mesh.LINES to create a wireframe mesh,
     // or H3DU.Mesh.POINTS to create a point mesh.

demos/ellarclength.js

@@ -29,9 +29,9 @@ function _numIntegrate(func, xmin, xmax) {
   "use strict";
   /*
 * Estimates the integral of a continuous function. The integral
-* is like the area between the function's graph and the X axis,
-* where areas above the X axis add to the integral, and areas
-* below the X axis subtract from it.
+* is like the area between the function's graph and the x-axis,
+* where areas above the x-axis add to the integral, and areas
+* below the x-axis subtract from it.
 * @private
 * @param {Function} func A function that takes one number
 * and returns a number. This function is assumed to be

demos/fallingballs.html

@@ -17,9 +17,9 @@
 * Updates the position of a particle using Verlet integration.
 * @param {Array<number>} particle Information on a single particle in
 * the form of an array of nine numbers as follows:<ul>
-* <li>The first three numbers are the X, Y, and Z coordinates
+* <li>The first three numbers are the x-, y-, and z-coordinates
 * of the particle's position.
-* <li>The next three numbers are the X, Y, and Z coordinates
+* <li>The next three numbers are the x-, y-, and z-coordinates
 * of the particle's previous position.
 * <li>The next three numbers are the X, Y, and Z components
 * of the particle's acceleration (force divided by mass).
@@ -59,9 +59,9 @@
 * Initializes a particle's data for Verlet integration.
 * @param {Array<Number>} particle Array to hold
 * the data for Verlet integration.
-* @param {number} x Starting X coordinate of the particle.
-* @param {number} y Starting Y coordinate of the particle.
-* @param {number} z Starting Z coordinate of the particle.
+* @param {number} x Starting x-coordinate of the particle.
+* @param {number} y Starting y-coordinate of the particle.
+* @param {number} z Starting z-coordinate of the particle.
 * @param {number} vx X component of the velocity.
 * @param {number} vy Y component of the velocity.
 * @param {number} vz Z component of the velocity.

demos/implicit.js

@@ -13,9 +13,9 @@
  * @param {Object} func A <b>sampling object</b>. This object contains a single property,
  * "sample", which is a function that takes three parameters
  * specifying a 3-dimensional point:<ol>
- * <li>x - An X coordinate.
- * <li>y - A Y coordinate.
- * <li>z - A Z coordinate.</ol>
+ * <li>x - An x-coordinate.
+ * <li>y - A y-coordinate.
+ * <li>z - A z-coordinate.</ol>
  * and returns a number. If the implicit surface function returns 0, that
  * means the point lies on the surface.
  * @example <caption>The following defines an implicit surface
@@ -68,9 +68,9 @@ ImplicitSurface._fGetOffset = function(a, b, desired) {
 };
 
 ImplicitSurface._TARGET_VALUE = 0;
-// For any edge, if one vertex is inside of the surface and the other is outside of the surface
+// For any edge, if one vertex is inside of the surface and the other is outside the surface
 // then the edge intersects the surface
-// For each of the 8 vertices of the cube can be two possible states : either inside or outside of the surface
+// For each of the 8 vertices of the cube can be two possible states : either inside or outside the surface
 // For any cube the are 2^8=256 possible sets of vertex states
 // This table lists the edges intersected by the surface for all 256 possible vertex states
 // There are 12 edges. For each entry in the table, if edge #n is intersected, then bit #n is set to 1
@@ -433,7 +433,7 @@ ImplicitSurface.prototype._vMarchCube1 = function(mesh, fX, fY, fZ, fScaleX, fSc
 
   const iEdgeFlags = ImplicitSurface._aiCubeEdgeFlags[iFlagIndex];
 
-  // If the cube is entirely inside or outside of the surface, then there will be no intersections
+  // If the cube is entirely inside or outside the surface, then there will be no intersections
   if(iEdgeFlags === 0)return;
   // Find the point of intersection of the surface with each edge
   // Then find the normal to the surface at those points
@@ -475,20 +475,20 @@ ImplicitSurface.prototype._vMarchCube1 = function(mesh, fX, fY, fZ, fScaleX, fSc
 /**
  * Finds a tight bounding box within the given three-dimensional
  * area that encloses this implicit surface.
- * @param {number} xsize Number of grid points along the X axis. Must be 2 or greater.
- * @param {number} ysize Number of grid points along the Y axis. Must be 2 or greater.
- * @param {number} zsize Number of grid points along the Z axis. Must be 2 or greater.
- * @param {number} xmin Smallest value along the X axis.
- * @param {number} xmax Greatest value along the X axis.
- * @param {number} ymin Smallest value along the Y axis.
- * @param {number} ymax Greatest value along the Y axis.
- * @param {number} zmin Smallest value along the Z axis.
- * @param {number} zmax Greatest value along the Z axis.
+ * @param {number} xsize Number of grid points along the x-axis. Must be 2 or greater.
+ * @param {number} ysize Number of grid points along the y-axis. Must be 2 or greater.
+ * @param {number} zsize Number of grid points along the z-axis. Must be 2 or greater.
+ * @param {number} xmin Smallest value along the x-axis.
+ * @param {number} xmax Greatest value along the x-axis.
+ * @param {number} ymin Smallest value along the y-axis.
+ * @param {number} ymax Greatest value along the y-axis.
+ * @param {number} zmin Smallest value along the z-axis.
+ * @param {number} zmax Greatest value along the z-axis.
  * @returns {Array<number>} An array of six numbers describing a tight
  * axis-aligned bounding box
  * that fits this implicit surface within the given area. The first three numbers
- * are the smallest-valued X, Y, and Z coordinates, and the
- * last three are the largest-valued X, Y, and Z coordinates.
+ * are the smallest-valued x-, y-, and z-coordinates, and the
+ * last three are the largest-valued x-, y-, and z-coordinates.
  * If no part of the boundary of the surface lies within the given
  * area, returns the array [Inf, Inf, Inf, -Inf,
  * -Inf, -Inf].
@@ -539,15 +539,15 @@ ImplicitSurface.prototype.findBox = function(xsize, ysize, zsize, xmin, xmax, ym
  * implicit surface
  * within the given area.
  * @param {Mesh} mesh Mesh to store the points in.
- * @param {number} xsize Number of grid points along the X axis. Must be 2 or greater.
- * @param {number} ysize Number of grid points along the Y axis. Must be 2 or greater.
- * @param {number} zsize Number of grid points along the Z axis. Must be 2 or greater.
- * @param {number} xmin Smallest value along the X axis.
- * @param {number} xmax Greatest value along the X axis.
- * @param {number} ymin Smallest value along the Y axis.
- * @param {number} ymax Greatest value along the Y axis.
- * @param {number} zmin Smallest value along the Z axis.
- * @param {number} zmax Greatest value along the Z axis.
+ * @param {number} xsize Number of grid points along the x-axis. Must be 2 or greater.
+ * @param {number} ysize Number of grid points along the y-axis. Must be 2 or greater.
+ * @param {number} zsize Number of grid points along the z-axis. Must be 2 or greater.
+ * @param {number} xmin Smallest value along the x-axis.
+ * @param {number} xmax Greatest value along the x-axis.
+ * @param {number} ymin Smallest value along the y-axis.
+ * @param {number} ymax Greatest value along the y-axis.
+ * @param {number} zmin Smallest value along the z-axis.
+ * @param {number} zmax Greatest value along the z-axis.
  * @returns {ImplicitSurface} This object.
  */
 ImplicitSurface.prototype.evalSurfacePoints = function(mesh, xsize, ysize, zsize, xmin, xmax, ymin, ymax, zmin, zmax) {
@@ -580,15 +580,15 @@ ImplicitSurface.prototype.evalSurfacePoints = function(mesh, xsize, ysize, zsize
  * given mesh the triangles and normals that make up the boundary of
  * this implicit surface within the given area.
  * @param {Mesh} mesh Mesh to store the points in.
- * @param {number} xsize Number of grid points along the X axis. Must be 2 or greater.
- * @param {number} ysize Number of grid points along the Y axis. Must be 2 or greater.
- * @param {number} zsize Number of grid points along the Z axis. Must be 2 or greater.
- * @param {number} xmin Smallest value along the X axis.
- * @param {number} xmax Greatest value along the X axis.
- * @param {number} ymin Smallest value along the Y axis.
- * @param {number} ymax Greatest value along the Y axis.
- * @param {number} zmin Smallest value along the Z axis.
- * @param {number} zmax Greatest value along the Z axis.
+ * @param {number} xsize Number of grid points along the x-axis. Must be 2 or greater.
+ * @param {number} ysize Number of grid points along the y-axis. Must be 2 or greater.
+ * @param {number} zsize Number of grid points along the z-axis. Must be 2 or greater.
+ * @param {number} xmin Smallest value along the x-axis.
+ * @param {number} xmax Greatest value along the x-axis.
+ * @param {number} ymin Smallest value along the y-axis.
+ * @param {number} ymax Greatest value along the y-axis.
+ * @param {number} zmin Smallest value along the z-axis.
+ * @param {number} zmax Greatest value along the z-axis.
  * @returns {ImplicitSurface} This object.
  */
 ImplicitSurface.prototype.evalSurface = function(mesh, xsize, ysize, zsize, xmin, xmax, ymin, ymax, zmin, zmax) {