From e54bc60495be4fea0158845397a652d9a81c0abc Mon Sep 17 00:00:00 2001
From: heck <heck@pep.foundation>
Date: Sat, 8 Apr 2023 01:58:55 +0200
Subject: [PATCH] Add Tutorial: 'Scopehero'

---
 tutorials/scopehero/1_arithmetic.orca       | 25 ++++++
 tutorials/scopehero/2_variables.orca        | 33 ++++++++
 tutorials/scopehero/3_writer.orca           | 41 ++++++++++
 tutorials/scopehero/4_flying_operators.orca | 65 +++++++++++++++
 tutorials/scopehero/5_scope.orca            | 81 +++++++++++++++++++
 tutorials/scopehero/6_scopehero.orca        | 89 +++++++++++++++++++++
 6 files changed, 334 insertions(+)
 create mode 100644 tutorials/scopehero/1_arithmetic.orca
 create mode 100644 tutorials/scopehero/2_variables.orca
 create mode 100644 tutorials/scopehero/3_writer.orca
 create mode 100644 tutorials/scopehero/4_flying_operators.orca
 create mode 100644 tutorials/scopehero/5_scope.orca
 create mode 100644 tutorials/scopehero/6_scopehero.orca

diff --git a/tutorials/scopehero/1_arithmetic.orca b/tutorials/scopehero/1_arithmetic.orca
new file mode 100644
index 0000000..cb1e640
--- /dev/null
+++ b/tutorials/scopehero/1_arithmetic.orca
@@ -0,0 +1,25 @@
+.........................................................................................
+.........................................................................................
+.........................................................................................
+............##...#####..#.#####.#....#.#....#.######.#....#.#####.#..#####...............
+...........#..#..#....#.#...#...#....#.##..##.#......##...#...#...#.#....#...............
+..........##...#.#....#.#...#...######.#.##.#.#####..#.#..#...#...#.#....................
+..........######.#####..#...#...#....#.#....#.#......#..#.#...#...#.#....................
+..........#....#.#...#..#...#...#....#.#....#.#......#...##...#...#.#....#...............
+..........#....#.#....#.#...#...#....#.#....#.######.#....#...#...#..####................
+.........................................................................................
+.........................................................................................
+....#.increment.#....#.count.#..#.random.#...#.add.#...#.subtract.#..#.multiply.#........
+.........................................................................................
+.........................................................................................
+..........I..............C...........R.........2A3.........2B3...........2M3.............
+..........g..............1...........s..........5...........1.............6..............
+.........................................................................................
+.........................................................................................
+.........................................................................................
+.........................................................................................
+.........................................................................................
+.........................................................................................
+.........................................................................................
+.........................................................................................
+.........................................................................................
diff --git a/tutorials/scopehero/2_variables.orca b/tutorials/scopehero/2_variables.orca
new file mode 100644
index 0000000..f7cda50
--- /dev/null
+++ b/tutorials/scopehero/2_variables.orca
@@ -0,0 +1,33 @@
+.................................................................
+..#....#...##...#####..#...##...#####..#......######..####.......
+..#....#..#..#..#....#.#..#..#..#....#.#......#......#...........
+..#....#.#....#.#....#.#.#....#.#####..#......#####...####.......
+..#....#.######.#####..#.######.#....#.#......#...........##.....
+...#..#..#....#.#...#..#.#....#.#....#.#......#......#....##.....
+....##...#....#.#....#.#.#....#.#####..######.######..####.......
+.................................................................
+.................................................................
+..................#.Write.a.variable.#...........................
+.................................................................
+............................2C.........R8........................
+................aV2........bV1.......cV7.........................
+.................................................................
+.................................................................
+.................................................................
+..................#.Read.a.variable.#............................
+.................................................................
+.................Va.........Vb........Vc.........................
+.................2..........1.........7..........................
+.................................................................
+.................................................................
+.................................................................
+..................#.Read.mutliple.vars.#.........................
+.................................................................
+.................................................................
+..........................3Kabc......#.reads.a.b.and.c.#.........
+............................217..................................
+.................................................................
+.................................................................
+.................................................................
+.................................................................
+.................................................................
diff --git a/tutorials/scopehero/3_writer.orca b/tutorials/scopehero/3_writer.orca
new file mode 100644
index 0000000..857ec19
--- /dev/null
+++ b/tutorials/scopehero/3_writer.orca
@@ -0,0 +1,41 @@
+.................................................
+.................................................
+...#.....#.######..###.#######.#######.#######...
+...#..#..#.#.....#..#.....#....#.......#.....#...
+...#..#..#.#.....#..#.....#....#.......#.....#...
+...#..#..#.######...#.....#....#####...######....
+...#..#..#.#...#....#.....#....#.......#...#.....
+...#..#..#.#....#...#.....#....#.......#....#....
+....##.##..#.....#.###....#....######..#.....#...
+.................................................
+.................................................
+.................................................
+.................................................
+....#.X.writes.the.right.operand.to.x.and.y.#....
+.................................................
+....#.xy.................#.......................
+....#....data.but.only.1.#.......................
+.................................................
+.................................................
+.................................................
+......11X0.......................................
+.................................................
+.........0.......................................
+.................................................
+.................................................
+.################################################
+.................................................
+..........................D1.....................
+..........................*......................
+..........................iz..#.just.increment.#.
+..........#.var.a.#.....aVs...#.to.z.#...........
+.................................................
+.................................................
+.......Cz.Va.....................................
+.......n.Xs......................................
+.........56789abcdefghijklmnopqrstuvwxy01234.....
+.................................................
+.................................................
+.................................................
+.................................................
+.................................................
diff --git a/tutorials/scopehero/4_flying_operators.orca b/tutorials/scopehero/4_flying_operators.orca
new file mode 100644
index 0000000..3b75261
--- /dev/null
+++ b/tutorials/scopehero/4_flying_operators.orca
@@ -0,0 +1,65 @@
+.........................................................................................................................
+.........................................................................................................................
+...######.#......#...#.#.#....#..####....#######.######..#######.######.....#....#######.#######.######...#####..........
+...#......#.......#.#..#.##...#.#....#...#.....#.#.....#.#.......#.....#...#.#......#....#.....#.#.....#.#.....#.........
+...#####..#........#...#.#.#..#.#........#.....#.#.....#.#.......#.....#..#...#.....#....#.....#.#.....#.#...............
+...#......#........#...#.#..#.#.#..###...#.....#.######..#####...######..#.....#....#....#.....#.######...#####..........
+...#......#........#...#.#...##.#....#...#.....#.#.......#.......#...#...#######....#....#.....#.#...#.........#.........
+...#......#####....#...#.#....#..####....#.....#.#.......#.......#....#..#.....#....#....#.....#.#....#..#.....#.........
+.........................................#######.#.......#######.#.....#.#.....#....#....#######.#.....#..#####..........
+.........................................................................................................................
+.....................................#.There.are.4.flying.operators.#....................................................
+.........................................................................................................................
+.........................................................................................................................
+..............................................#.type.them.in.the.box.#...................................................
+..............................................000000000000000000000000...................................................
+..............................................0......................0...................................................
+..............................................0......................0...................................................
+.................................#.E.east..#..0......................0...................................................
+.................................#.W.west..#..0......................0...................................................
+.................................#.N.nord..#..0......................0...................................................
+.................................#.S.south.#..0......................0...................................................
+..............................................0......................0...................................................
+..............................................0......................0...................................................
+..............................................0......................0...................................................
+..............................................000000000000000000000000...................................................
+.........................................................................................................................
+.........................................................................................................................
+..###############################################################################################################........
+.........................................................................................................................
+..#.now.try.the.writer.with.the.E.operator.#.............................................................................
+.........................................................................................................................
+.........................................................................................................................
+.........................................................................................................................
+...11XE..................................................................................................................
+.........................................................................................................................
+......E..................................................................................................................
+.........................................................................................................................
+.........................................................................................................................
+.........................................................................................................................
+.........................................................................................................................
+.........................................................................................................................
+.........................................................................................................................
+.........................................................................................................................
+.........................................................................................................................
+..###############################################################################################################........
+.........................................................................................................................
+..#.visualize.a.counter.by.using.it.on.the.y.param.of.the.writer.#.......................................................
+.........................................................................................................................
+.........................................................................................................................
+#.C8.....................................................................................................................
+..4XE....................................................................................................................
+.........................................................................................................................
+.........................................................................................................................
+.........................................................................................................................
+.........................................................................................................................
+...E.....................................................................................................................
+.........................................................................................................................
+.........................................................................................................................
+.........................................................................................................................
+.........................................................................................................................
+.........................................................................................................................
+.........................................................................................................................
+.........................................................................................................................
+.........................................................................................................................
+.........................................................................................................................
diff --git a/tutorials/scopehero/5_scope.orca b/tutorials/scopehero/5_scope.orca
new file mode 100644
index 0000000..6837207
--- /dev/null
+++ b/tutorials/scopehero/5_scope.orca
@@ -0,0 +1,81 @@
+.................................................
+.................................................
+.....#####...#####..#######.######..#######......
+....#.....#.#.....#.#.....#.#.....#.##...........
+....#.......#.......#.....#.#.....#.##...........
+.....#####..#.......#.....#.######..####.........
+.........##.#.......#.....#.#.......##...........
+....#....##.#.....#.#.....#.#.......##...........
+.....#####...#####..#######.#.......########.....
+.................................................
+....#.use.the.writer.to.visualize.and.debug.#....
+.................................................
+.................................................
+.................................................
+..........................D1.....................
+..........................*......................
+.........................1iz.....................
+..........#.var.a.#.....aVf......................
+.................................................
+.................................................
+.................................................
+.......Cz.Va.....................................
+.......w.Xf......................................
+..Va.....ijklmnopqrstuvwxy0123456789abcdefgh.....
+..fXE............................................
+.##.........................................##...
+.##.........................................##...
+.##.........................................##...
+.##.........................................##...
+.##.........................................##...
+.##.........................................##...
+.##.........................................##...
+.##.........................................##...
+.##.........................................##...
+.##.........................................##...
+.##.........................................##...
+.##.........................................##...
+.##.........................................##...
+.##.........................................##...
+.##.........................................##...
+.##.........................................##...
+.##.........................................##...
+.##.........................................##...
+.##.........................................##...
+.##.........................................##...
+.##.........................................##...
+.##.........................................##...
+.##.........................................##...
+.##.........................................##...
+.##.........................................##...
+.##.........................................##...
+.##.........................................##...
+.##.........................................##...
+.##.........................................##...
+.##.........................................##...
+.##.........................................##...
+.##.........................................##...
+.##.........................................##...
+.##.........................................##...
+.##.........................................##...
+.................................................
+.................................................
+.................................................
+.................................................
+.................................................
+.................................................
+.................................................
+.................................................
+.................................................
+.................................................
+.................................................
+.................................................
+.................................................
+.................................................
+.................................................
+.................................................
+.................................................
+.................................................
+.................................................
+.................................................
+.................................................
diff --git a/tutorials/scopehero/6_scopehero.orca b/tutorials/scopehero/6_scopehero.orca
new file mode 100644
index 0000000..6f4622f
--- /dev/null
+++ b/tutorials/scopehero/6_scopehero.orca
@@ -0,0 +1,89 @@
+................................#####...#####..#######.######..#######.#.....#.#######.######..#######...................................
+...............................#.....#.#.....#.#.....#.#.....#.#.......#.....#.#.......#.....#.#.....#...................................
+...............................#.......#.......#.....#.#.....#.#.......#.....#.#.......#.....#.#.....#...................................
+................................#####..#.......#.....#.######..#####...#######.####....######..#.....#...................................
+....................................##.#.......#.....#.#.......#.......#.....#.#.......#...#...#.....#...................................
+...............................#....##.#.....#.#.....#.#.......#.......#.....#.#.......#....#..#.....#...................................
+................................#####...#####..#######.#.......#######.#.....#.######..#.....#.#######...................................
+.........................................................................................................................................
+...................................................D1...........................D1.......................................................
+...................................................*............................*........................................................
+..................................................1iz.......#.increment.#.......i8.......................................................
+.................................................hB4.........#.bounce.#.........4B4......................................................
+...................................#.var.a.#....aVd............................bV0....#.var.b.#..........................................
+.........................................................................................................................................
+.........................................................................................................................................
+...........................................................#.add.a.and.b.#...............................................................
+.........................................................................................................................................
+................................................................Va..Vb...................................................................
+................................................................dYdA0....................................................................
+.................................................................cVd.....................................................................
+...............................................................#.var.c#..................................................................
+.......Cz.Va.........................................Cz.Vb.........................................Cz.Vc.................................
+.......m.Xd..........................................m.X0..........................................m.Xd..................................
+..Va.....0123456789abcdefghhgfedcba987654321....Vb.....23432101234321012343210210123432101....Vc.....24666668aceeeeegikljhfdecaaaaa86422.
+..dXE...........................................0XE...........................................dXE........................................
+.##.........................................##.##.........................................##.##.........................................#
+.##.........................................##.##.........................................##.##.........................................#
+.##.........................................##.##.........................................##.##.........................................#
+.##.........................................##.##.........................................##.##.........................................#
+.##.........................................##.##.........................................##.##.........................................#
+.##.........................................##.##.........................................##.##.........................................#
+.##.........................................##.##.........................................##.##.........................................#
+.##.........................................##.##.........................................##.##.........................................#
+.##.........................................##.##.........................................##.##.........................................#
+.##.........................................##.##.........................................##.##.........................................#
+.##.........................................##.##.........................................##.##.........................................#
+.##.........................................##.##.........................................##.##.........................................#
+.##.........................................##.##.........................................##.##.........................................#
+.##.........................................##.##.........................................##.##.........................................#
+.##.........................................##.##.........................................##.##.........................................#
+.##.........................................##.##.........................................##.##.........................................#
+.##.........................................##.##.........................................##.##.........................................#
+.##.........................................##.##.........................................##.##.........................................#
+.##.........................................##.##.........................................##.##.........................................#
+.##.........................................##.##.........................................##.##.........................................#
+.##.........................................##.##.........................................##.##.........................................#
+.##.........................................##.##.........................................##.##.........................................#
+.##.........................................##.##.........................................##.##.........................................#
+.##.........................................##.##.........................................##.##.........................................#
+.##.........................................##.##.........................................##.##.........................................#
+.##.........................................##.##.........................................##.##.........................................#
+.##.........................................##.##.........................................##.##.........................................#
+.##.........................................##.##.........................................##.##.........................................#
+.##.........................................##.##.........................................##.##.........................................#
+.##.........................................##.##.........................................##.##.........................................#
+.##.........................................##.##.........................................##.##.........................................#
+.##.........................................##.##.........................................##.##.........................................#
+.##.........................................##.##.........................................##.##.........................................#
+.##.........................................##.##.........................................##.##.........................................#
+.##.........................................##.##.........................................##.##.........................................#
+.........................................................................................................................................
+.........................................................................................................................................
+.........................................................................................................................................
+.........................................................................................................................................
+.........................................................................................................................................
+.........................................................................................................................................
+.........................................................................................................................................
+.........................................................................................................................................
+.........................................................................................................................................
+.........................................................................................................................................
+.........................................................................................................................................
+.........................................................................................................................................
+.........................................................................................................................................
+.........................................................................................................................................
+.........................................................................................................................................
+.........................................................................................................................................
+.........................................................................................................................................
+.........................................................................................................................................
+.........................................................................................................................................
+.........................................................................................................................................
+.........................................................................................................................................
+.........................................................................................................................................
+.........................................................................................................................................
+.........................................................................................................................................
+.........................................................................................................................................
+.........................................................................................................................................
+.........................................................................................................................................
+.........................................................................................................................................
+.........................................................................................................................................