breval/blip
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

add l default variable and note length expression with classic MML

Browse source 
default
This commit is contained in:
Breval Ferrari 2025-05-01 19:57:17 -04:00
parent f865d0a4aa
commit 574460a098
Signed by: breval
GPG key ID: A2EEBF62257FF960
1 changed files with 5 additions and 3 deletions
Download patch file Download diff file Expand all files Collapse all files

8
doc/cli-design.txt
View file

@ -2,7 +2,7 @@ A flexible music programming language powered by math.
usage:
cmd [FILENAME | -c SHEET_MUSIC | --syntax | --examples | --example <n>] [-e EXPR] -n NOTE[,...] [-E [-f {"stdout" | FORMAT}]] [-v CHAR=VALUE]
cmd [FILENAME | -c SHEET_MUSIC | --syntax | --examples | --example <n>] [-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