From f865d0a4aa8d722bc8ba7651d3b49afec0ce2e00 Mon Sep 17 00:00:00 2001 From: Breval Ferrari Date: Thu, 1 May 2025 19:38:48 -0400 Subject: [PATCH 1/2] fix typo in default instrument --- doc/cli-design.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/cli-design.txt b/doc/cli-design.txt index 5bf59b0..15e0016 100644 --- a/doc/cli-design.txt +++ b/doc/cli-design.txt @@ -14,7 +14,7 @@ options: -n NOTE[,...], --notes NOTE[,...] available notes: a list of comma-separated alphabetical note names -e EXPR, --expression EXPR - signal expression (instrument) to generate music samples (you can use the floating-point number t for the current time in seconds, n for the indice of the currently playing note in the list of available notes starting with 0 and N for the number of available notes) [default: sin(2*PI*n*(442+442*((n+1)/N))*t)] + signal expression (instrument) to generate music samples (you can use the floating-point number t for the current time in seconds, n for the indice of the currently playing note in the list of available notes starting with 0 and N for the number of available notes) [default: sin(2*PI*(442+442*((n+1)/N))*t)] exporting music: -E, --export From 574460a098121671e0449af3fc652c3cde1ea4e0 Mon Sep 17 00:00:00 2001 From: Breval Ferrari Date: Thu, 1 May 2025 19:57:17 -0400 Subject: [PATCH 2/2] add l default variable and note length expression with classic MML default --- doc/cli-design.txt | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/doc/cli-design.txt b/doc/cli-design.txt index 15e0016..119b5b9 100644 --- a/doc/cli-design.txt +++ b/doc/cli-design.txt @@ -2,7 +2,7 @@ A flexible music programming language powered by math. usage: -cmd [FILENAME | -c SHEET_MUSIC | --syntax | --examples | --example ] [-e EXPR] -n NOTE[,...] [-E [-f {"stdout" | FORMAT}]] [-v CHAR=VALUE] +cmd [FILENAME | -c SHEET_MUSIC | --syntax | --examples | --example ] [-e EXPR] [-l EXPR] -n NOTE[,...] [-E [-f {"stdout" | FORMAT}]] [-v CHAR=VALUE] arguments: FILENAME file path to your .blp sheet music [default: read from stdin] @@ -14,7 +14,9 @@ options: -n NOTE[,...], --notes NOTE[,...] available notes: a list of comma-separated alphabetical note names -e EXPR, --expression EXPR - signal expression (instrument) to generate music samples (you can use the floating-point number t for the current time in seconds, n for the indice of the currently playing note in the list of available notes starting with 0 and N for the number of available notes) [default: sin(2*PI*(442+442*((n+1)/N))*t)] + signal expression (instrument) to generate music samples (you can use the floating-point number t for the current time in seconds, n for the indice of the currently playing note in the list of available notes starting with 0 and N for the number of available notes) [default: "sin(2*PI*(442+442*((n+1)/N))*t)"] + -l EXPR, --length EXPR + expression to generate note length in seconds [default: "2^(2-log_2(l))*(60/T)"] exporting music: -E, --export @@ -24,7 +26,7 @@ options: advanced sheet music tweaking: -v VARIABLE=VALUE, --variable VARIABLE=VALUE - add a variable named VARIABLE (an single letter) for the sheet music and all expressions and set its initial value to VALUE (you can override n, t and T) + add a variable named VARIABLE (an single letter) for the sheet music and all expressions and set its initial value to VALUE (you can override n, t, l and T which is the only way to set the initial tempo) -m NAME:EXPANSION, --macro MACRO:EXPANSION add a macro named NAME (single character, must not be alphanumeric) which expands to EXPANSION when called in the sheet music -s NAME:VARIABLE=EXPR, --slope VARIABLE=EXPR