mirror of
https://gitea.heck.live/heck/Orca-Workshop.git
synced 2024-11-21 23:39:13 +01:00
README - inline ALL tutorial sources
This commit is contained in:
parent
3e9212447b
commit
384b74c661
1 changed files with 444 additions and 0 deletions
444
README.md
444
README.md
|
@ -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.
|
||||
|
|
Loading…
Reference in a new issue