Skip to content

Latest commit

 

History

History
214 lines (149 loc) · 6.03 KB

README_ja.md

File metadata and controls

214 lines (149 loc) · 6.03 KB
Raw

テキスト音楽サクラ(Rust版) / ピコサクラ

「ドレミ」や「cde」のテキストをMIDIファイルに変換するコンパイラです。手軽に音楽を作成できるツールです。 Rustで作られておりマルチプラットフォーム(macOS/Windows/Linux/WebAssembly)で動作します。

リポジトリ

どこまで作ったか

  • ブラウザで手軽に音楽を再生できるピコサクラを実装しました。
  • サクラv2と比べると機能は少ないですが、使えるコマンドの一覧がこちらにあります。
  • 内部構造についての説明がこちらにあります。

実装予定だが未実装

  • & タイ Slur(type[,value,range]) タイ記号"&"の異音程(スラー)の動作を変更する。type=0:グリッサンド/1:ベンド/2:ゲート/3:アルペジオ

未実装で実装予定なし

  • onCycle命令
  • FOR IF WHILE FUNCTION (別途スクリプト言語からMMLを動的に生成する方が実用的かと)

ピコサクラ - インストールについて

Web版が「こちら(ピコサクラ)」です。 ブラウザ上で手軽にMIDIファイルを再生できます。

ダウンロードして使いたい場合、コマンドライン版が使えます。以下より各OSのバイナリをダウンロードしてください。

最新版のコンパイル (Rust)

最初に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

Rhythm macro

リズムマクロでは、大文字、小文字に関わらず、１文字１命令として扱われる。 リズムマクロの定義は「$文字{定義}」のように記述する。

// リズムマクロの定義(ただし以下のものはデフォルトで定義済み...再定義も可能)
$b{n36,}
$h{n42,}
$o{n46,}
// 新規でリズムマクロを定義
$S{n37,}
CH(10)
//Rhythm のサンプル
Rhythm{
　[4　l8
　　　brSr bbsr r-1
　　　hoho hoho
　]
}

サクラv1/v2とサクラRust版の違い

サクラ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`
「ドミソ」「レファラ」「ミソシ」「ドミソ」

先行指定とCCやPBの連続書き込み

先行指定が使えます。

  • 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

参考