Differences

This shows you the differences between two versions of the page.

--- turtle_graphics [2024/09/02 10:12] – frchris
+++ turtle_graphics [2024/09/12 14:27] (current) – [Make Your own Picture] frchris
@@ Line 4: / Line 4: @@
 ===== History =====
-In the 1960s, an educational programming language called Logo was developed. It is best known for teaching programming with turtles! The turtles were graphical or robotic turtles that were controlled with simple commands like go forward or turn right. Here’s a photo of a robot turtle from the 1960s.
+In the 1960s, an educational programming language called Logo was developed. It is best known for teaching programming with turtles! The turtles were graphical or robotic turtles that were controlled with simple commands like go forward, turn, raise and lower a pen.  Moving the turtle with the pen down would draw a picture. Here’s a photo of a robot turtle from the 1960s.
 {{::oldturtle1.png?400|}}
@@ Line 11: / Line 11: @@
 {{::turtlegraphicshistory.jpg?400|}}  {{::screen_shot_2022-08-27_at_8.48.01_am.png?400|}}
-This was later used (in a simulated state) to teach newer programming languages as they get invented. Here we have the Java incarnation of Turtle Graphics.
+This was later used (in a simulated state) to teach newer programming languages as they get invented. Here we have two Java incarnations of Turtle Graphics.
 [[https://handwiki.org/wiki/Turtle_graphics|Read more about it here]] or [[https://en.wikipedia.org/wiki/Turtle_graphics|here]]
@@ Line 19: / Line 19: @@
 [[https://github.com/bhoffman0/CSAwesome/raw/master/_sources/Unit2-Using-Objects/TurtleJavaSwingCode.zip|TurtleJavaSwingCode.zip]] has the Sources needed to make turtles with your own code on your own machine.  See Section 2.1 of the [[http://runestone.academy|Runestone Academy]] Book [[https://runestone.academy/ns/books/published/csawesome/index.html?mode=browsing|CSAwsome]].
-THe class Main has the main method
+Here is the class diagram of ''SimpleTurtle'' the superclass of ''Turtle''.  any subclass of ''SimpleTurtle'' has these attributes and methods:
+{{::superturtle_class_diagrampng.png?400|}}
+The class Main has the main method
 <code java>
 public class Main {
@@ Line 39: / Line 43: @@
 ===== Java "Animated" APLU Turtle =====
+An animated version from Berne, Switzerland has so many classes, they put them all in a Library.  This library is in a file called {{ ::jturtle-0.1.1.jar |jturtle-0.1.1.jar}}.  [[https://mathorama.com/wiki/doku.php?id=how_to_install_the_library_in_bluej| Click here for instructions on how to install it in BlueJ]], and [[https://mathorama.com/wiki/doku.php?id=how_to_install_the_library_in_eclipse|click here for instructions to install a .jar library in Eclipse]]
 The [[http://www.aplu.ch/home/apluhomex.jsp?site=65|APLU.ch]] Java Utility Package **ch.aplu.turtle** Description
@@ Line 48: / Line 53: @@
 You will need download this jar file and add it to your Libraries (Java Build Path in Eclipse, Library Tab in Preferences in BlueJ):
-{{ ::jturtle-0.1.1.jar |jturtle.jar}} Library of classes to draw with a turtle.  You can get the latest version 21st Century version [[https://sourceforge.net/projects/jturtle/|here]]
+{{ ::jturtle-0.1.1.jar |jturtle-0.1.1.jar}} Library of classes to draw with a turtle.  You can get the latest version 21st Century version [[https://sourceforge.net/projects/jturtle/|here]]
+==== Make Your own Picture====
+Here is an example of a Turtle instance that can make a hexagon, fill it in with a color, and "autographs" it:
-Here's a simple sample program which shows how to use the Java Turtle Package:
+<code java>
+import ch.aplu.turtle.*;
+import java.awt.Color;
+/**
+ *
+ * @author (Your Name)
+ * @version September 0, 2024
+ */
+public class MyPicture {
+	public static void main(String[] args) {
+        Turtle hexter = new Turtle(Color.GREEN);
+        hexter.setPos(100,-50);
+        for (int i=0; i< 6; i++) {
+        	hexter.forward(100);
+        	hexter.right(-60);
+        }
+        hexter.setPos(0,0);
+        hexter.setFillColor(Color.BLUE);
+	hexter.fill();
+        Turtle t = new Turtle(hexter);
+        t.setPenColor(Color.RED);
+	t.setPos(-200, 180);
+	t.hideTurtle();
+        t.label( "by My name");
+	}
+}
+</code>
+Here is the [[http://www.aplu.ch/classdoc/turtle/index.html|Turtle API]] (documentation in the Javadoc style)
+The default turtle coordinate system: doubles -200.0..+200.0 in both directions (zero at center; x to left, y upward). (Turtle coordinates are rounded to to 400 x 400 pixel coordinates).
+Unless special constructors are used, new turtles are shown in a new window.
+Defaults when a turtle is created:
+Coordinates: (0, 0) (center of window)
+Heading: north
+Speed: 200 (coordinates per seconds)
+Lab Scoring:
+  - Adds the [[https://www.mathorama.com/wiki/lib/exe/fetch.php?media=jturtle-0.1.1.jar|jturtle-0.1.1.jar]] library in either BlueJ or Eclipse
+  - Your name as @author in a comment
+  - The date as @version in a comment
+  - Makes a Turtle that is visable
+  - Draws a shape
+  - Fills the shape with a color
+  - Autographs their work with a label
+  - (8th point: Has more than one shape with an additional Turtle instance
+  - (9th or 10th point: Has unique and creative work of art
+Here's an example program which demonstrates how to use some of the fancy methods Turtle class from the APLU:
 <code java>
@@ Line 119: / Line 182: @@
 [[https://mathorama.com/mov/TurtleExample.mp4|Watch what this code does]]
-=== Make Your own Picture===
-<code java>
-import ch.aplu.turtle.*;
-import java.awt.Color;
-/**
- *
- * @author (Your Name)
- * @version September 0, 2024
- */
-public class MyPicture {
-	public static void main(String[] args) {
-        Turtle hexter = new Turtle(Color.GREEN);
-        hexter.setPos(100,-50);
-        for (int i=0; i< 6; i++) {
-        	hexter.forward(100);
-        	hexter.right(-60);
-        }
-        hexter.setPos(0,0);
-        hexter.setFillColor(Color.BLUE);
-	    hexter.fill();
-        Turtle t = new Turtle(hexter);
-        t.setColor(Color.RED);
-		t.setPos(-200, 180);
-	    t.hideTurtle().label( "by My name");
-	}
-}
-</code>
-Here is the [[http://www.aplu.ch/classdoc/turtle/index.html|Turtle API]] (documentation in the Javadoc style)