README - inline ALL tutorial sources

This commit is contained in:
heck 2023-04-08 19:59:52 +02:00
parent 3e9212447b
commit 384b74c661

444
README.md
View file

@ -186,6 +186,42 @@ In this chapter you learn 1 of 2 operators that can count.
* `C` - Count (rate / modulo)
```orca
.........................................................
.........................................................
....####...####..#....#.#....#.#####.######.#####........
...#....#.#....#.#....#..#...#...#...#......#....#.......
...#......#....#.#....#.#.#..#...#...#####..#....#.......
...#......#....#.#....#.#..#.#...#...##.....#####........
...#....#.#....#.#....#.#...##...#...#......#...##.......
....####...####...####..#....#...#...######.#....##......
.........................................................
.........................................................
...#.outputs.framenr.divided.by.rate.modulo.range.#......
.........................................................
.........................................................
...................#.rate.#.#.range.#....................
.........................................................
..........................1C8............................
...........................6.............................
.........................................................
.........................................................
...............#.These.are.the.default.#.................
.........................................................
.........................................................
...........................C.............................
...........................6.............................
.........................................................
.........................................................
.........................................................
...........#.increment.every.8.frame.up.to.3.#...........
.........................................................
..........................8C4............................
...........................2.............................
.........................................................
.........................................................
```
### 2. Track
The track lets us store a list and access its elements.
@ -194,6 +230,46 @@ The track lets us store a list and access its elements.
You guessed it, using a counter you can now iterate the elements of a list
```orca
.........................................................
.........................................................
.........................................................
.........#######..#####.....#.....#####..#....#..........
............#....##....#...#.#...#.....#.#...#...........
............#....#.....#..#...#..#.......#..#............
............#....######..#.....#.#.......####............
............#....#...#...#######.#.......#..##...........
............#....#....#..#.....#.#.....#.#...##..........
............#....#.....#.#.....#..#####..#....###........
.........................................................
..........#.Track.output.one.element.of.a.list.#.........
.........................................................
.............#.4.elements.#.#.the.list.is.abcd.#.........
.........................................................
........#.outputs.the.#..04Tabcd.........................
........#...element...#....a.............................
........#.....nr.0....#..................................
.........................................................
.........................................................
.........................................................
........#.attach.a.counter.to.the.index.operand.#........
.........................................................
........................4C4..............................
.........................24Tabcd.........................
...........................c.......#.YAY.#...............
.........................................................
.........................................................
.........................................................
.........................................................
.........................................................
.........#.use.the.track.output.as.the.notenr.#..........
.........................................................
........................4C8..............................
....................#..D168TceghcEgh.....................
........................;14g.............................
.........................................................
```
### 3. Variables
In this chapter you learn all the operators related to variables:
@ -201,12 +277,89 @@ In this chapter you learn all the operators related to variables:
* `V` - Variable, r/w single (Write: name / val | Read: - / name)
* `K` - Kontakt, read multiple (Read: count / names)
```orca
.................................................................
..#....#...##...#####..#...##...#####..#......######..####.......
..#....#..#..#..#....#.#..#..#..#....#.#......#......#...........
..#....#.#....#.#....#.#.#....#.#####..#......#####...####.......
..#....#.######.#####..#.######.#....#.#......#...........##.....
...#..#..#....#.#...#..#.#....#.#....#.#......#......#....##.....
....##...#....#.#....#.#.#....#.#####..######.######..####.......
.................................................................
.................................................................
..................#.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..................................
.................................................................
.................................................................
```
### 4. CakeTracker
**Putting it all together**
Using the values of our list (in track) as note-numbers, we are now the new-age melody heroes.
Enjoy the eternal bleeps of the spotless beethoven.
```orca
.........................................................................................
.......#####.......................#######...............................................
......#.....#...##...#....#.######....#....#####....##....####..#....#.######..####......
......#........#..#..#...#..#.........#....#....#..#..#..#....#.#...#..#......#....#.....
......#.......#....#.####...#####.....#....#....#.#....#.#......####...####...#....#.....
......#.......######.#..#...#.........#....#####..######.#......#..#...##.....#####......
......#.....#.#....#.#...#..#.........#....#...#..#....#.#....#.#...#..##.....#...#......
.......#####..#....#.#....#.######....#....#....#.#....#..####..#....#.######.#....#.....
.........................................................................................
...........#.combining.the.result.of.first.bleeps.with.the.track.and.variable.#..........
.........................................................................................
.........................................................................................
.........................................................................................
..........................................C..............................................
..........................................18Tfheiokl.....................................
..........................................aVh............................................
.........................................................................................
.........................................................................................
.........................................................................................
..........................................D2..Va.........................................
...........................................;14h..........................................
.........................................................................................
.........................................................................................
.........................................................................................
..........................................D3..Va.........................................
..........................................*;23h..........................................
.........................................................................................
.........................................................................................
.........................................................................................
..........................................D1..Va.........................................
..........................................*;52hf2........................................
.........................................................................................
.........................................................................................
.........................................................................................
..........................................D7..Va.........................................
...........................................;33h3z........................................
.........................................................................................
.........................................................................................
..................#.results.in.eternal.bleeps.of.the.spotless.beethoven.#................
.........................................................................................
.........................................................................................
```
### Congrats
Congratulations beethoven went home crying.
@ -230,6 +383,27 @@ In this chapter you learn (almost) all the operators to generate and manipulate
* `B` - Subtract (operand / operand)
* `M` - Multiply (operand / operand)
```orca
.........................................................................................
.........................................................................................
.........................................................................................
............##...#####..#.#####.#....#.#....#.######.#....#.#####.#..#####...............
...........#..#..#....#.#...#...#....#.##..##.#......##...#...#...#.#....#...............
..........##...#.#....#.#...#...######.#.##.#.#####..#.#..#...#...#.#....................
..........######.#####..#...#...#....#.#....#.#......#..#.#...#...#.#....................
..........#....#.#...#..#...#...#....#.#....#.#......#...##...#...#.#....#...............
..........#....#.#....#.#...#...#....#.#....#.######.#....#...#...#..####................
.........................................................................................
.........................................................................................
....#.increment.#....#.count.#..#.random.#...#.add.#...#.subtract.#..#.multiply.#........
.........................................................................................
.........................................................................................
..........I..............C...........R.........2A3.........2B3...........2M3.............
..........g..............1...........s..........5...........1.............6..............
.........................................................................................
.........................................................................................
```
### 2. Variables
In this chapter you learn all the operators related to variables:
@ -237,6 +411,39 @@ In this chapter you learn all the operators related to variables:
* `V` - Variable, r/w single (Write: name / val | Read: - / name)
* `K` - Kontakt, read multiple (Read: count / names)
```orca
.................................................................
..#....#...##...#####..#...##...#####..#......######..####.......
..#....#..#..#..#....#.#..#..#..#....#.#......#......#...........
..#....#.#....#.#....#.#.#....#.#####..#......#####...####.......
..#....#.######.#####..#.######.#....#.#......#...........##.....
...#..#..#....#.#...#..#.#....#.#....#.#......#......#....##.....
....##...#....#.#....#.#.#....#.#####..######.######..####.......
.................................................................
.................................................................
..................#.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..................................
.................................................................
.................................................................
```
### 3. Writer
There are a number of operators to write data into the grid.
@ -244,6 +451,46 @@ In this chapter we only look at one:
* `X` - Write (x, y / data )
```orca
.................................................
.................................................
...#.....#.######..###.#######.#######.#######...
...#..#..#.#.....#..#.....#....#.......#.....#...
...#..#..#.#.....#..#.....#....#.......#.....#...
...#..#..#.######...#.....#....#####...######....
...#..#..#.#...#....#.....#....#.......#...#.....
...#..#..#.#....#...#.....#....#.......#....#....
....##.##..#.....#.###....#....######..#.....#...
.................................................
.................................................
.................................................
.................................................
....#.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.....
.................................................
```
### 4. Flying Operators
In this chapter you learn about all the _flying_ operators `\o/ \o/ \o/`:
@ -253,6 +500,74 @@ In this chapter you learn about all the _flying_ operators `\o/ \o/ \o/`:
* `N` - North
* `S` - South
```orca
.........................................................................................................................
.........................................................................................................................
...######.#......#...#.#.#....#..####....#######.######..#######.######.....#....#######.#######.######...#####..........
...#......#.......#.#..#.##...#.#....#...#.....#.#.....#.#.......#.....#...#.#......#....#.....#.#.....#.#.....#.........
...#####..#........#...#.#.#..#.#........#.....#.#.....#.#.......#.....#..#...#.....#....#.....#.#.....#.#...............
...#......#........#...#.#..#.#.#..###...#.....#.######..#####...######..#.....#....#....#.....#.######...#####..........
...#......#........#...#.#...##.#....#...#.....#.#.......#.......#...#...#######....#....#.....#.#...#.........#.........
...#......#####....#...#.#....#..####....#.....#.#.......#.......#....#..#.....#....#....#.....#.#....#..#.....#.........
.........................................#######.#.......#######.#.....#.#.....#....#....#######.#.....#..#####..........
.........................................................................................................................
.....................................#.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.....................................................................................................................
.........................................................................................................................
.........................................................................................................................
.........................................................................................................................
.........................................................................................................................
.........................................................................................................................
.........................................................................................................................
.........................................................................................................................
.........................................................................................................................
.........................................................................................................................
```
### 5. Scope
**Putting it all together**
@ -260,6 +575,70 @@ In this chapter you learn about all the _flying_ operators `\o/ \o/ \o/`:
Yay, by now we have already learned 15 operators, more than half of them all.
Now we can combine them to create a 'scope' to visualize and debug any variable values.
```orca
.................................................
.................................................
.....#####...#####..#######.######..#######......
....#.....#.#.....#.#.....#.#.....#.##...........
....#.......#.......#.....#.#.....#.##...........
.....#####..#.......#.....#.######..####.........
.........##.#.......#.....#.#.......##...........
....#....##.#.....#.#.....#.#.......##...........
.....#####...#####..#######.#.......########.....
.................................................
....#.use.the.writer.to.visualize.and.debug.#....
.................................................
.................................................
.................................................
..........................D1.....................
..........................*......................
.........................1iz.....................
..........#.var.a.#.....aVf......................
.................................................
.................................................
.................................................
.......Cz.Va.....................................
.......w.Xf......................................
..Va.....ijklmnopqrstuvwxy0123456789abcdefgh.....
..fXE............................................
.##.........................................##...
.##.........................................##...
.##.........................................##...
.##.........................................##...
.##.........................................##...
.##.........................................##...
.##.........................................##...
.##.........................................##...
.##.........................................##...
.##.........................................##...
.##.........................................##...
.##.........................................##...
.##.........................................##...
.##.........................................##...
.##.........................................##...
.##.........................................##...
.##.........................................##...
.##.........................................##...
.##.........................................##...
.##.........................................##...
.##.........................................##...
.##.........................................##...
.##.........................................##...
.##.........................................##...
.##.........................................##...
.##.........................................##...
.##.........................................##...
.##.........................................##...
.##.........................................##...
.##.........................................##...
.##.........................................##...
.##.........................................##...
.##.........................................##...
.##.........................................##...
.##.........................................##...
.................................................
```
### 6. ScopeHero
**Putting it even togetherererer**
@ -267,6 +646,71 @@ Now we can combine them to create a 'scope' to visualize and debug any variable
What is even more fun than 1 scope, is 3 scopes.
Let generate 2 'signals', add them together to create a third signal, and use our scope technique to visualize whats going on.
```orca
................................#####...#####..#######.######..#######.#.....#.#######.######..#######...................................
...............................#.....#.#.....#.#.....#.#.....#.#.......#.....#.#.......#.....#.#.....#...................................
...............................#.......#.......#.....#.#.....#.#.......#.....#.#.......#.....#.#.....#...................................
................................#####..#.......#.....#.######..#####...#######.####....######..#.....#...................................
....................................##.#.......#.....#.#.......#.......#.....#.#.......#...#...#.....#...................................
...............................#....##.#.....#.#.....#.#.......#.......#.....#.#.......#....#..#.....#...................................
................................#####...#####..#######.#.......#######.#.....#.######..#.....#.#######...................................
.........................................................................................................................................
...................................................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........................................
.##.........................................##.##.........................................##.##.........................................#
.##.........................................##.##.........................................##.##.........................................#
.##.........................................##.##.........................................##.##.........................................#
.##.........................................##.##.........................................##.##.........................................#
.##.........................................##.##.........................................##.##.........................................#
.##.........................................##.##.........................................##.##.........................................#
.##.........................................##.##.........................................##.##.........................................#
.##.........................................##.##.........................................##.##.........................................#
.##.........................................##.##.........................................##.##.........................................#
.##.........................................##.##.........................................##.##.........................................#
.##.........................................##.##.........................................##.##.........................................#
.##.........................................##.##.........................................##.##.........................................#
.##.........................................##.##.........................................##.##.........................................#
.##.........................................##.##.........................................##.##.........................................#
.##.........................................##.##.........................................##.##.........................................#
.##.........................................##.##.........................................##.##.........................................#
.##.........................................##.##.........................................##.##.........................................#
.##.........................................##.##.........................................##.##.........................................#
.##.........................................##.##.........................................##.##.........................................#
.##.........................................##.##.........................................##.##.........................................#
.##.........................................##.##.........................................##.##.........................................#
.##.........................................##.##.........................................##.##.........................................#
.##.........................................##.##.........................................##.##.........................................#
.##.........................................##.##.........................................##.##.........................................#
.##.........................................##.##.........................................##.##.........................................#
.##.........................................##.##.........................................##.##.........................................#
.##.........................................##.##.........................................##.##.........................................#
.##.........................................##.##.........................................##.##.........................................#
.##.........................................##.##.........................................##.##.........................................#
.##.........................................##.##.........................................##.##.........................................#
.##.........................................##.##.........................................##.##.........................................#
.##.........................................##.##.........................................##.##.........................................#
.##.........................................##.##.........................................##.##.........................................#
.##.........................................##.##.........................................##.##.........................................#
.##.........................................##.##.........................................##.##.........................................#
.........................................................................................................................................
.........................................................................................................................................
```
### Congrats
Congratulations!!! You are hardcore! your mum must be so proud of you! All that bloody brain acrobatics without even one bleep, a real martyr.