add more methods to the Text class

Author: mikebarkmin

CHANGELOG.md

@@ -3,6 +3,28 @@ name: Changelog
 index: 4
 ---
 
+## 3.6.0
+
+- 🚀 Feat: Add method `setTextSize` to the Text-class
+
+```java
+Text myText = new Text();
+myText.setTextSize(48);
+```
+
+- 🚀 Feat: Allow custom fonts for Text-objects. Custom fonts can be added like a costume for a Sprite-object. Each Text-object does have a default font named `default`.
+
+```java
+Text myText = new Text();
+myText.addFont("playful", "opensans.odt");
+myText.switchFont("playful");
+
+// get the text-object, which is used for the think and speak bubble
+Text spriteText = new Sprite().getText();
+```
+
+- 📝 Docs: Add example `Shakespeare` which shows the usage of the new methods of the Text-class
+
 ## 3.5.0
 
 - 💻 OS: Added Linux ARM 32-bit and ARM 64-bit versions

docs/de/book/examples/shakespeare.md

@@ -0,0 +1,14 @@
+---
+name: Shakespeare
+lang: de
+---
+
+# Shakespeare
+
+Ein Beispiel, das die Nutzung der Text-Klasse zeigt.
+
+![shakespeare example](/assets/shakespeare.gif)
+
+## Quelltext
+
+- Java: https://github.com/openpatch/scratch-for-java/tree/main/examples/java/Shakespeare

docs/de/book/reference/extensions/text/addFont.json

@@ -0,0 +1,24 @@
+{
+  "template": "method",
+  "related": [],
+  "name": "addFont()",
+  "scratchblock": "add font (name) (file path)",
+  "class": "Text",
+  "description": "Fügt eine Schriftart dem Text hinzu.",
+  "syntax": [
+    ".addFont(name, filePath)"
+  ],
+  "returns": "void",
+  "parameters": [
+    {
+      "name": "name",
+      "description": "Der Name der Schriftart",
+      "type": "String"
+    },
+    {
+      "name": "filePath",
+      "description": "Der Pfad zur Schriftartdatei. Die Datei muss im ttf oder otf format vorliegen.",
+      "type": "String"
+    }
+  ]
+}

docs/de/book/reference/extensions/text/getCurrentFontIndex.json

@@ -0,0 +1,10 @@
+{
+  "template": "method",
+  "related": [],
+  "scratchblock": "font [number v]",
+  "name": "getCurrentFontIndex()",
+  "class": "Text",
+  "description": "Gibt den aktuellen index der Schriftart zurück.",
+  "syntax": [".getCurrentFontIndex()"],
+  "returns": "int"
+}

docs/de/book/reference/extensions/text/getCurrentFontName.json

@@ -0,0 +1,10 @@
+{
+  "template": "method",
+  "related": [],
+  "scratchblock": "font [name v]",
+  "name": "getCurrentFontName()",
+  "class": "Text",
+  "description": "Gibt den Namen der aktuellen Schriftart zurück.",
+  "syntax": [".getCurrentFontName()"],
+  "returns": "String"
+}

docs/de/book/reference/extensions/text/nextFont.json

@@ -0,0 +1,10 @@
+{
+  "template": "method",
+  "related": [],
+  "scratchblock": "next font",
+  "name": "nextFont()",
+  "class": "Text",
+  "description": "Wechselt die Schriftart zur nächsten in der Liste.",
+  "syntax": [".nextFont()"],
+  "returns": "void"
+}

docs/de/book/reference/extensions/text/setTextSize.json

@@ -0,0 +1,16 @@
+{
+  "template": "method",
+  "related": [],
+  "name": "setTextSize()",
+  "class": "Text",
+  "description": "Setzt die Größe des Textes.",
+  "syntax": [".setTextSize(size)"],
+  "returns": "void",
+  "parameters": [
+    {
+      "name": "size",
+      "description": "Die Größe des Textes",
+      "type": "int"
+    }
+  ]
+}

docs/de/book/reference/extensions/text/switchFont.json

@@ -0,0 +1,17 @@
+{
+  "template": "method",
+  "related": [],
+  "scratchblock": "switch font to [ v]",
+  "name": "switchFont()",
+  "class": "Text",
+  "description": "Wechselt die Schriftart aus eine bestimmte.",
+  "syntax": [".switchFont(name)"],
+  "returns": "void",
+  "parameters": [
+    {
+      "name": "name",
+      "description": "Der Name der Schriftart",
+      "type": "String"
+    }
+  ]
+}

docs/de/public/assets/shakespear.gif

@@ -0,0 +1,13 @@
+---
+name: Shakespeare
+---
+
+# Shakespeare
+
+An example showing the use of the Text class. 
+
+![shakespeare example](/assets/shakespeare.gif)
+
+## Source Code
+
+- Java: https://github.com/openpatch/scratch-for-java/tree/main/examples/java/Shakespeare