improve comments

hx2A · hx2A · commit ca1668c6b82e · 2023-04-30T14:10:13.000-04:00
diff --git a/hybrid-programming/example4/example4.py b/hybrid-programming/example4/example4.py
@@ -1,6 +1,14 @@
+# Draw Torus Example
+#
+# Torus geometry algorithm adapted from Three.js (https://threejs.org/).
+# https://github.com/mrdoob/three.js/blob/dev/src/geometries/TorusGeometry.js
+
 import py5
 
-from peasy import PeasyCam
+# Import the PeasyCam library (a Java library, not a Python library)
+# PeasyCam was created by Jonathan Feinberg (https://mrfeinberg.com/peasycam/)
+# JPype lets you import Java libraries into Python as you would import a Python library
+from peasy import PeasyCam  # type: ignore
 
 
 torus = None
diff --git a/hybrid-programming/example4/java/src/main/java/py5utils/Py5Utilities.java b/hybrid-programming/example4/java/src/main/java/py5utils/Py5Utilities.java
@@ -14,7 +14,7 @@ public Py5Utilities(Sketch sketch) {
   }
 
   public PShape createTorus(float radius, float tube, int radialSegments, int tubularSegments) {
-    // Torus algorithm adapted from Three.js (https://threejs.org/).
+    // Torus geometry algorithm adapted from Three.js (https://threejs.org/).
     // https://github.com/mrdoob/three.js/blob/dev/src/geometries/TorusGeometry.js
     float vertices[][] = new float[(radialSegments + 1) * (tubularSegments + 1)][3];
     for (int i = 0; i <= radialSegments; i++) {

Original file line number	Diff line number	Diff line change
`@@ -14,7 +14,7 @@ public Py5Utilities(Sketch sketch) {`
`14`	`14`	`}`
`15`	`15`
`16`	`16`	`public PShape createTorus(float radius, float tube, int radialSegments, int tubularSegments) {`
`17`		`- // Torus algorithm adapted from Three.js (https://threejs.org/).`
	`17`	`+ // Torus geometry algorithm adapted from Three.js (https://threejs.org/).`
`18`	`18`	`// https://github.com/mrdoob/three.js/blob/dev/src/geometries/TorusGeometry.js`
`19`	`19`	`float vertices[][] = new float[(radialSegments + 1) * (tubularSegments + 1)][3];`
`20`	`20`	`for (int i = 0; i <= radialSegments; i++) {`