version 3.2.0

Author: mikebarkmin

.env

@@ -23,7 +23,7 @@ function s4j_examples_run() {
     java_dir=${java_file_path%/*}
     pushd $java_dir;
     java_filename="${java_file%.*}"
-    lib=$(s4j_workdir)/distribution/scratch-standalone-linux-amd64.jar
+    lib=$(s4j_workdir)/distribution/scratch4j-linux-amd64.jar
     javac -cp "$lib:." $java_file
     echo $PWD
     echo $java_file
@@ -40,8 +40,8 @@ function s4j_examples_run_all() {
         java_dir=${f%/*}
         java_name="${java_file%.*}"
         pushd $java_dir
-        javac -cp "$root/distribution/scratch-standalone-linux-amd64.jar:." $java_file
-        java -cp "$root/distribution/scratch-standalone-linux-amd64.jar:." $java_name
+        javac -cp "$root/distribution/scratch4j-linux-amd64.jar:." $java_file
+        java -cp "$root/distribution/scratch4j-linux-amd64.jar:." $java_name
         popd
     done
 }

.gitignore

@@ -7,3 +7,4 @@ classes
 *.class
 *.ctxt
 docs/en/public/reference
+docs/en/book/changelog.md

CHANGELOG.md

@@ -3,6 +3,41 @@ name: Changelog
 index: 4
 ---
 
+## 3.2.0
+
+- 🚀 Feat: Introducing the new class `Window`. Every Scratch for Java program can have on `Window`-object. A `Window`-object contains one stage object, which can be change during the runtime. This allows for using multiple stages in your program. For example, you could have one stage for the menu, one for the game and one for the credits.
+
+```java
+public class Prog {
+    public static void main(String[] args) {
+        Window myWindow = new Window();
+        Stage stage1 = new Stage();
+        Stage stage2 = new Stage();
+        myWindow.addStage("one", stage1);
+        myWindow.addStage("two", stage2);
+
+        myWindow.switchStage("two");
+    }
+}
+```
+
+- 🚀 Feat: The class Text became more usable as a standalone Drawable. You can now create a Text-object with the default constructor `new Text()`. The created Text-object will in `TextStyle.PLAIN`, meaning having nothing drawn around it and be freely placeable on the stage.
+    - The background color can now be set by passing a Color-object. `setBackgroundColor(Color c)`
+    - The text color can now be set by passing a Color-object. `setTextColor(Color c)`
+
+- 🐎 Perf: Scratch for Java now used an OpenGL renderer, which increases the performance by many times.
+- 🐎 Perf: The collision detection got improved.
+- 💥 BREAKING: `setSize` got removed from the Stage class. Since the switch to the OpenGL Renderer you can only set the size of the Stage or Window at the constructor.
+
+```java
+public class MyStage extends Stage {
+    public MyStage() {
+        super(800, 400)
+        // this.setSize(800, 400);
+    }
+}
+```
+
 ## 3.1.1
 
 - 🐛 Fix: setSize did not affect getWidth and getHeight.
@@ -14,7 +49,7 @@ index: 4
 
 ## 3.0.0
 
-Scratch for Java will from now on focus on being a standalone library. Even though it can be used in processing.
+Scratch for Java will from now on focus on being a standalone library. Therefore, it can not be used in Processing anymore.
 
 ## 2.1.0
 

build.sh

@@ -1,4 +1,104 @@
 ---
 name: Differences to Scratch
 index: 2
----
+---
+
+# Differences to Scratch
+
+Probably the most noticeable differences to Scratch are the following:
+
+- The coordinated start in the top left hand side corner and **not** in the center.
+- There is not wait-block on a Sprite-level, you need to use [Timers](/reference/sprite/sensing/getTimer).
+
+If you want to achieve something like this inside a Sprite:
+
+:::scratchblock
+when green flag clicked
+forever
+next costume
+wait (1) seconds
+:::
+
+You can use a timer.
+
+```java
+public class Cat extends Sprite {
+    // executes 60-times a second, if the sprite is added to a stage.
+    public void run() {
+        if (this.getTimer().everyMillis(1000)) {
+            this.nextCostume();
+        }
+    }
+}
+```
+
+
+- There is no Sprite library, you have to search the internet.
+- There is no Sound library, you have to search the internet.
+- There are not build-in editors, you have to use external tools like [GIMP](https://www.gimp.org/), [Inkscape](https://inkscape.org/), [Audacity](https://www.audacityteam.org/) and so on.
+- If you want to share your project with others, you have to used external sharing platforms like Nextcloud, iCloud, Dropbox or better a code sharing platform like GitHub.
+- You **can not** use a forever loop. This will halt you program.
+
+If you want to achieve something like this inside a Sprite:
+
+:::scratchblock
+when green flag clicked
+forever
+move (10) steps
+:::
+
+You can use the run-method of the Sprite-class.
+
+```java
+public class Cat extends Sprite {
+    // executes 60-times a second, if the sprite is added to a stage.
+    public void run() {
+        this.move(10);
+    }
+}
+```
+
+- If you want to have a variable for all sprites, you have to use a static attribute. Static attributes are available across all objects.
+
+```java
+public class Cat extends Sprite {
+    public static int hitCounter = 1;
+}
+
+public class MyProgram {
+    public MyProgram() {
+        Cat.hitCounter += 1;
+    }
+}
+```
+
+- There are no send, broadcast or receive message methods, you need to make use of custom-methods and object-references.
+
+```java
+public class Sender extends Sprite {
+    private Receiver receiver;
+
+    public Sender(Receiver aReceiver) {
+        receiver = aReceiver;
+    }
+
+    public whenClicked() {
+        aReceiver.receive("Hello");
+    }
+
+}
+
+public class Receiver extends Sprite {
+    public void receive(String text) {
+        this.say(text);
+    }
+}
+
+public class MyProgram {
+    Stage myStage = new Stage();
+    Receiver myReceiver = new Receiver();
+    myStage.add(myReceiver);
+    Sende mySender = new Sender(myReceiver);
+    myStage.add(mySender);
+}
+```

data/loading.png

@@ -11,11 +11,11 @@ You can install this library via three ways in BlueJ.
 
 First, you need to download the Scratch for Java jar for your operating system.
 
-::download[Windows Jar]{src="https://github.com/openpatch/scratch-for-java/releases/latest/download/scratch-standalone-windows-amd64.jar"}
+::download[Windows Jar]{src="https://github.com/openpatch/scratch-for-java/releases/latest/download/scratch4j-windows-amd64.jar"}
 
-::download[Linux Jar]{src="https://github.com/openpatch/scratch-for-java/releases/latest/download/scratch-standalone-linux-amd64.jar"}
+::download[Linux Jar]{src="https://github.com/openpatch/scratch-for-java/releases/latest/download/scratch4j-linux-amd64.jar"}
 
-::download[MacOS Jar]{src="https://github.com/openpatch/scratch-for-java/releases/latest/download/scratch-standalone-macosx-universal.jar"}
+::download[MacOS Jar]{src="https://github.com/openpatch/scratch-for-java/releases/latest/download/scratch4j-macosx-universal.jar"}
 
 ### Project-by-project
 
@@ -37,48 +37,12 @@ If you have installed BlueJ via the installer you probably find the "userlib" fo
 - MacOS: `/Application/BlueJ/BlueJ.app/Resources/java/userlib`
 - Linux: `/usr/share/bluej/userlib/`
 
-## Processing
-
-### Install with the Contribution Manager
-
-Add contributed Libraries by selecting the menu item _Sketch_ → _Import Library..._ → _Add Library..._ This will open the Contribution Manager, where you can browse for Scratch, or any other Library you want to install.
-
-Not all available Libraries have been converted to show up in this menu. If a Library isn't there, it will need to be installed manually by following the instructions below.
-
-### Manual Install
-
-Contributed Libraries may be downloaded separately and manually placed within the `libraries` folder of your Processing sketchbook. To find (and change) the Processing sketchbook location on your computer, open the Preferences window from the Processing application (PDE) and look for the "Sketchbook location" item at the top.
-
-By default, the following locations are used for your sketchbook folder:
-
-- For Mac users, the sketchbook folder is located inside `~/Documents/Processing`
-- For Windows users, the sketchbook folder is located inside `My Documents/Processing`
-
-Download Scratch from https://github.com/openpatch/scratch-for-java/releases/latest
-
-Unzip and copy the contributed Library's folder into the `libraries` folder in the Processing sketchbook. You will need to create this `libraries` folder if it does not exist.
-
-The folder structure for Library Scratch should be as follows:
-
-```
-Processing
-  libraries
-    Scratch
-      examples
-      library
-        Scratch.jar
-      reference
-      src
-```
-
-Some folders like `examples` or `src` might be missing. After Library Scratch has been successfully installed, restart the Processing application.
-
 ## Standalone
 
 You need to add the Jar file for your operating system to the classpath.
 
-::download[Windows Jar]{src="https://github.com/openpatch/scratch-for-java/releases/latest/download/scratch-standalone-windows-amd64.jar"}
+::download[Windows Jar]{src="https://github.com/openpatch/scratch-for-java/releases/latest/download/scratch4j-windows-amd64.jar"}
 
-::download[Linux Jar]{src="https://github.com/openpatch/scratch-for-java/releases/latest/download/scratch-standalone-linux-amd64.jar"}
+::download[Linux Jar]{src="https://github.com/openpatch/scratch-for-java/releases/latest/download/scratch4j-linux-amd64.jar"}
 
-::download[MacOS Jar]{src="https://github.com/openpatch/scratch-for-java/releases/latest/download/scratch-standalone-macosx-universal.jar"}
+::download[MacOS Jar]{src="https://github.com/openpatch/scratch-for-java/releases/latest/download/scratch4j-macosx-universal.jar"}