commit ffc8fe3d3114437ae83066bf8c3a4dbe8e328422
parent f39e214e99d9a0682af1f4d69c00db4bb298f8f5
Author: Adam <[email protected]>
Date: Sun, 10 Feb 2019 16:24:34 -0600
Update README.MD
Diffstat:
| M | README.MD | | | 30 | ++++++++++++++++++++++++++++-- |
1 file changed, 28 insertions(+), 2 deletions(-)
diff --git a/README.MD b/README.MD
@@ -18,9 +18,35 @@ YLX LY5 2X5 Y2L 2LY X25 YLX YLL
# I Love Cookies
Signal & CV Sequencer. Uses Text as input. Because after all, don't we all love cookies?
-Knobs are labeled with lowercase letters: a-z. Inputs are labeled with uppercase letters A-Z. Programming in the sequence: ~abcd~ will sequentially output the values of knobs a, b, c, and finally d. It will then loop back to step 0: knob a again. An exact voltage can be programmed by enclosing the value in square brackets. For example: `<4.20>`. Surrounding
+Knobs are labeled with lowercase letters: a-z. Inputs are labeled with uppercase letters A-Z. Programming in the sequence: ~abcd~ will sequentially output the values of knobs a, b, c, and finally d. It will then loop back to step 0: knob a again. An exact voltage can be programmed by enclosing the value in square brackets. For example: `<4.20>`. Following a sequence of values (lowercase, uppercase, or exact value) with "@8" will loop the sequence after 8 steps. 8 is not a special value, any number works after the "@" symbol. Here is an example with some I Love Cookies inputs their equivalents:
-All of the following are valid ILC programs:
+~~~~
+Input Equivalent Input
+
+a@3 aaa
+ab@5 ababa
+<1><0>@8 <1><0><1><0><1><0><1><0>
+abcde@8 abcdeabc
+abcdef@3 abc
+~~~~
+
+## Randomization
+
+Enclosing values (lowercase letter, uppercase letter, or exact voltage) in curl braces {} will randomly select one of the values with equal probability. For example, ~{ab}~ will choose either "a" or "b" at each clock step. ~{g<2.55>}~ will output either the value of knob "g" or 2.55 volts with equal probability.
+
+## Square Bracket Expansion
+
+Enclosing comma-separated sequences with square brackets allows for even more complex patterns to be generated.
+
+~~~~
+Input Equivalent Input Comment
+
+[ab,c]@4 ababcccc 4 steps of "ab", then 4 steps of "c"
+[A,cde]@5 AAAAAcdecd 5 steps from input "A", then 5 steps of "cde"
+~~~~
+
+
+All of the following are valid I Love Cookies programs:
~~~~
<4.20>
{abc}
