From 384b74c661af152cc97322c29b402cbd2816b579 Mon Sep 17 00:00:00 2001 From: heck Date: Sat, 8 Apr 2023 19:59:52 +0200 Subject: [PATCH] README - inline ALL tutorial sources --- README.md | 444 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 444 insertions(+) diff --git a/README.md b/README.md index d85d915..7f50216 100644 --- a/README.md +++ b/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.