added comments

Author: jafu888

desktop/graph3d/com/support/constraintlayout/extlib/graph3d/Graph3dPanel.java

@@ -1,3 +1,18 @@
+/*
+ * Copyright (C) 2023 The Android Open Source Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
 package com.support.constraintlayout.extlib.graph3d;
 
 import com.support.constraintlayout.extlib.graph3d.objects.AxisBox;
@@ -9,7 +24,9 @@
 import java.awt.image.BufferedImage;
 import java.awt.image.DataBufferInt;
 
-
+/**
+ * The JPanel that draws the Scene and handles mouse input
+ */
 public class Graph3dPanel extends JPanel {
 
     Scene3D mScene3D = new Scene3D();

desktop/graph3d/com/support/constraintlayout/extlib/graph3d/Main.java

@@ -1,7 +1,26 @@
+/*
+ * Copyright (C) 2023 The Android Open Source Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
 package com.support.constraintlayout.extlib.graph3d;
 
 import javax.swing.*;
 
+/**
+ * Simple driver for the Graph3dPanel
+ */
 public class Main {
     public static void main(String[] args) {
         JFrame frame =  new JFrame("3d Plot");

desktop/graph3d/com/support/constraintlayout/extlib/graph3d/Matrix.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) 2020 The Android Open Source Project
+ * Copyright (C) 2023 The Android Open Source Project
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -15,7 +15,6 @@
  */
 package com.support.constraintlayout.extlib.graph3d;
 
-
 import java.text.DecimalFormat;
 import java.util.Arrays;
 

desktop/graph3d/com/support/constraintlayout/extlib/graph3d/Object3D.java

@@ -1,7 +1,23 @@
+/*
+ * Copyright (C) 2023 The Android Open Source Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
 package com.support.constraintlayout.extlib.graph3d;
 
 /**
- * This represents 3d Object in this system
+ * This represents 3d Object in this system.
  */
 public class Object3D {
     protected float[] vert;

desktop/graph3d/com/support/constraintlayout/extlib/graph3d/Scene3D.java

@@ -20,7 +20,7 @@
 import java.util.Arrays;
 
 /**
- * This renders a 3 Dimentional surface of a function.
+ * This renders 3Dimensional Objects.
  */
 public class Scene3D {
     private static final String TAG = "SurfaceGen";

desktop/graph3d/com/support/constraintlayout/extlib/graph3d/objects/AxisBox.java

@@ -1,8 +1,26 @@
+/*
+ * Copyright (C) 2023 The Android Open Source Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
 package com.support.constraintlayout.extlib.graph3d.objects;
 
 import com.support.constraintlayout.extlib.graph3d.Object3D;
 import com.support.constraintlayout.extlib.graph3d.Scene3D;
 
+/**
+ * Draws box along the axis
+ */
 public class AxisBox extends Object3D {
     int color = 0xFFFF3233;
     public AxisBox() {

desktop/graph3d/com/support/constraintlayout/extlib/graph3d/objects/Surface3D.java

@@ -1,7 +1,25 @@
+/*
+ * Copyright (C) 2023 The Android Open Source Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
 package com.support.constraintlayout.extlib.graph3d.objects;
 
 import com.support.constraintlayout.extlib.graph3d.Object3D;
 
+/**
+ * Plots a surface based on Z = f(X,Y)
+ */
 public class Surface3D extends Object3D {
     final int SIZE = 100; // the number of point on the side total points = SIZE*SIZE
     private Function mFunction;