サクラはMML(Music Macro Language)からMIDIファイルに変換するコンパイラです。 「ドレミ」や「cde」のテキストをMIDIファイルに変換するコンパイラです。 Rustで作られておりマルチプラットフォーム(macOS/Windows/Linux/WebAssembly)で動作します。
サクラは2000年以前に開発された歴史ある音楽制作ツールです。 MMLとは、「cde」のようなテキストで楽譜を表す記法です。 簡単に音楽を作れるツールです。Rustで作られており、macOS、Windows、Linux、WebAssemblyで動きます。 「オンラインソフト大賞2001」で入賞し、高校の情報の教科書にも載りました。
- mmlbbs6 --- サクラ曲掲示板6にたくさんの曲が投稿されています。
オンラインチュートリアルを用意しています。ブラウザ上で音を聞きながらコマンドを覚えられます。
Web版が「こちら(ピコサクラ)」です。 ブラウザ上で手軽にMIDIファイルを再生できます。
ダウンロードして使いたい場合、コマンドライン版が使えます。以下より各OSのバイナリをダウンロードしてください。
最初にRustをインストールしておいてください。
$ git clone https://github.com/kujirahand/sakuramml-rust.git
$ cd sakuramml-rust
$ cargo build --relase
すると、target/release/sakurammlが作成されます。
楽譜情報をテキストに記述します。例えば「test.mml」というファイルに記述します。 それを、"test.mml"を"test.mid"に変換するには、コマンドラインで以下のようにコマンドを実行します。
$ sakuramml test.mml
音階4 ドレミファソラシ↑ド↓シラソファミレド
o4 cdefgab>c<bagfedc
トラック1 チャンネル1 音符1 ドミソー
TR=1 CH=1 l1 ceg^
音符1「ドミソ」
l4 `ceg` `dfa`8 `egb`8 `ceg`
TIME(小節:拍:ステップ)を使うと任意の小節に移動できます。
// 先頭に移動
TIME(1:1:0) cdef
TIME(1:1:0) efga
// 2小節目に移動
TIME(2:1:0) cdef
SUB{...}を使うと、タイムポインタをSUBの直前に戻すことが可能です。気軽に和音を演奏できます。
SUB{ cdef c }
SUB{ efga e }
rrrr g
リズムマクロでは、大文字、小文字に関わらず、１文字１命令として扱われる。 リズムマクロの定義は「$文字{定義}」のように記述する。
// リズムマクロの定義(ただし以下のものはデフォルトで定義済み...再定義も可能)
$b{n36,}
$h{n42,}
$o{n46,}
// 新規でリズムマクロを定義
$S{n37,}
CH(10)
//Rhythm のサンプル
Rhythm{
[4 l8
brSr bbsr r-1
hoho hoho
]
}
サクラv1/v2と敢えて変更した点があります。
本バージョンでは、ステップモードの指定方法が異なります。v1/v2では、音長の指定を「l%96」のように書くと、その後ずっとステップ指定になっていました。 しかし、ステップモードで音符を指定することはほとんどないため、本バージョンでは、一時的にステップ指定ができますが、その後もステップ指定になるわけではありません。ステップ指定は一時的のみ使えます。
// 以下二行は同じ意味
l%96 cde
c4d4e4
従来、連符は『Div{...}』と記述していましたが、『Div』を省略して、『{ceg}』のように記述できます。
l4 Div{cde} f Div{gab} >c<
l4 {cde} f {gab} >c<
伸ばす記号「^」も1音と数えるので便利。
l4 {cde}c {gfe}d {c^d} e {d^e} f
連符はネストできます。
l1 { c d {efe} d } c
「(」でベロシティを8下げ、「)」でベロシティを8上げます。
v127 c ( c ( c (( c )) c ) c ) c
「c0e0g」のように、0を指定した和音は、サポートしません。普通に以下のように指定してください。
`ceg` `dfa` `egb` `ceg`
「ドミソ」「レファラ」「ミソシ」「ドミソ」
先行指定が使えます。
- v.onTime(low, high, len, ...) / 省略形 v.T(low,high,len,...)
- v.onNote(v1, v2, v3, ...) / 省略形 v.N(v1,v2,v3,...)
- t.onNote(v1, v2, v3, ...) / 省略形 t.N(v1,v2,v3,...)
- (ControllChange または PB または p).onTime(low, high, len, ...)
v.onTime(0,127,!1)l8cccccccc
BR(2) PB.onTime(-8192,0,!4) l4c PB(0) efg^
以下のようにしてマクロを定義できます。
// マクロの定義
STR P1 = {cdefg}
#P1 = {cdefg}
// マクロを展開
P1
#P1
マクロに引数を指定してマクロの内容を置換できます。マクロの中に「#?1」「#?2」「#?3」...を定義しておくと、その部分がマクロの直後に書いた引数で置換されます。
// マクロの定義
#Unison = { Key=#?2 Sub{ #?1 } Key=0 #?1 }
// マクロの展開
#Unison{cde},7
- サクラ(Rust版)のコマンド一覧 --- command.md
- サクラ(v2版)のコマンド一覧 --- https://sakuramml.com/doc/command/index.htm
- 音色一覧 --- voice.md