VexFlow オクターブ

VexFlow 使い方に戻る。

概要

　オクターブも時間系の処理が必要っぽいね。ある範囲をオクターブを上げたり下げたりして演奏するための記号です。音域の広いピアノやギターのパートなんかではよく見られる記譜法です。五線譜の上にあるときはオクターブを上げて、五線譜の下にあるときはオクターブを下げたりすることを指示できます。ギターは低い音の範囲が狭いので、オクターブ下はあまり使われないですね。でもE/3あたりをずっと演奏するときは追加線だらけの楽譜になるので、オクターブ下を使ってもよいかもしれません。E/3(ミ)～A/3(シ)の範囲ですね。

　TextBracketというクラスを使って実現するもので8vaの他にもいろいろな指示ができます。アルペジオやライトハンド奏法なども同じ仕組みが使えると思います。Muteの範囲指定も同じかな。一音Muteには使えないですね。ここまでいろいろ勉強してきましたが、まだまだ表記できない技術が残っています。楽譜って案外複雑な世界だったんだなって思えますね。吹奏楽部で活動していても、2年目くらいでもまだ、しらない記号出てきたりしたときは、深い！って思ったものです。で、楽典の本で調べてみたら載ってなかったりもするし。本しかない時代だったからな大変だったよね。昭和は。

　

オクターブ

　コードは以下のとおりです。

<div id="yonet202403Mid_Output01"></div>
<script>
///////////////////////
(function(){
class Position {
  constructor(x, y) {
    this.x = x;
    this.y = y;
  }
}
var VF = Vex.Flow;
const Instrument1 = new Position(0, 0);
const Instrument2 = new Position(0, 0);
(function(){
const {
  Factory,
  Stave,
  StaveNote,
  Formatter,
  Voice,
  StaveTie,
  BarLine,
  StaveConnector,
  Modifier,
  RenderContext,
  TextDynamics,
  Articulation,
  TextNote,
  Crescendo,
  Renderer
} = Vex.Flow;

let nscale = 0.64;
let nwidth = 1040;
let nheight = 720;

let nHeadMargin = 70;
let nStaveWidth = 350;

const f = new Factory({ 
  renderer: { elementId: 'yonet202403Mid_Output01', width: nwidth, height: nheight * nscale }
  });
const ctx = f.getContext();
ctx.scale(nscale, nscale);

const defaultStyle = {
  lineWidth: ctx.lineWidth,
  strokeStyle: ctx.strokeStyle,
};



for (let i = 0; i <= nwidth * (1 / nscale); i += 10) {
  ctx.beginPath();
  ctx.moveTo(0 + i, 0);
  ctx.lineTo(0 + i, nheight);
  if (i % 100 === 0){
    ctx.setLineWidth(1);
    ctx.setStrokeStyle('rgba(200, 200, 200, 0.8)');
  }
  else{
    ctx.setLineWidth(0.5);
    ctx.setStrokeStyle('rgba(230, 230, 230, 0.8)');
  }
  ctx.stroke();
}

for (let i = 0; i <= nheight; i += 10) {
  ctx.beginPath();
  ctx.moveTo(0, i);
  ctx.lineTo(nwidth * (1 / nscale), i);
  if (i % 100 === 0){
    ctx.setLineWidth(1);
    ctx.setStrokeStyle('rgba(200, 200, 200, 0.8)');
  }
  else{
    ctx.setLineWidth(0.5);
    ctx.setStrokeStyle('rgba(230, 230, 230, 0.8)');
  }
  ctx.stroke();
}

ctx.lineWidth = defaultStyle.lineWidth;
ctx.strokeStyle = defaultStyle.strokeStyle;

const stave1 = new Stave(80, 150, nHeadMargin + nStaveWidth).setContext(ctx);
stave1.setClef("treble").setContext(ctx);
stave1.setTimeSignature('4/4').setContext(ctx);
stave1.setSection("A", 0);
stave1.setMeasure(1);
stave1.setTempo({ duration: "q", dots: 0, bpm: 120 }, 0);
stave1.setBegBarType(VF.Barline.type.REPEAT_BEGIN);//BarLine.type.REPEAT_BEGIN

Instrument1.x = stave1.x - 30;
Instrument1.y = stave1.y + 90; 

stave1.draw();


const notes1 = [
  new StaveNote({ keys: ["d/5"], duration: "8", stem_direction: -1 }),
  new StaveNote({ keys: ["e/5"], duration: "8", stem_direction: -1 }),
  new StaveNote({ keys: ["f/5"], duration: "8", stem_direction: -1 }),
  new StaveNote({ keys: ["g/5"], duration: "8", stem_direction: -1 }),
  new StaveNote({ keys: ["a/5"], duration: "8", stem_direction: -1 }),
  new StaveNote({ keys: ["b/5"], duration: "8", stem_direction: -1 }),
  new StaveNote({ keys: ["c/6"], duration: "8", stem_direction: -1 }),
  new StaveNote({ keys: ["d/6"], duration: "8", stem_direction: -1 }),
];
notes1[0].addModifier(new VF.Articulation('a.').setPosition(3));
notes1[1].addModifier(new VF.Articulation('av').setPosition(3));
notes1[2].addModifier(new VF.Articulation('a>').setPosition(3));
notes1[3].addModifier(new VF.Articulation('a^').setPosition(3));
notes1[4].addModifier(new VF.Articulation('a-').setPosition(3));
notes1[5].addModifier(new VF.Articulation('a+').setPosition(3));
notes1[6].addModifier(new VF.Articulation('ao').setPosition(3));
notes1[7].addModifier(new VF.Articulation('a|').setPosition(3));

Formatter.FormatAndDraw(ctx, stave1, notes1);

var stave2 = new Vex.Flow.Stave(stave1.width + stave1.x, stave1.y, nStaveWidth);
var stave1002 = new Vex.Flow.Stave(stave1.width + stave1.x, stave1.y + 120, 0);
stave2.setEndBarType(VF.Barline.type.REPEAT_BOTH);
stave2.setMeasure(2);
stave2.setTempo({ name: "Andante", note: "8", bpm: 120 }, 0);
stave2.setContext(ctx).draw();

var note2_1 = new Vex.Flow.StaveNote({ keys: ["F/4"], duration: "8" });
var note2_2 = new Vex.Flow.StaveNote({ keys: ["C/5"], duration: "8", stem_direction: -1 });
var note2_3 = new Vex.Flow.StaveNote({ keys: ["D/4"], duration: "8" });
var note2_4 = new Vex.Flow.StaveNote({ keys: ["C/4"], duration: "8" });
var note2_5 = new Vex.Flow.StaveNote({ keys: ["G/4"], duration: "8" });
var note2_6 = new Vex.Flow.StaveNote({ keys: ["F/4"], duration: "8" });
var note2_7 = new Vex.Flow.StaveNote({ keys: ["G/4"], duration: "8" });
var note2_8 = new Vex.Flow.StaveNote({ keys: ["F/4"], duration: "8" });

note2_1.addModifier(new VF.Articulation('am').setPosition(4));
note2_2.addModifier(new VF.Articulation('a@a').setPosition(3));
note2_3.addModifier(new VF.Articulation('a@u').setPosition(4));
note2_4.addModifier(new VF.Articulation('a-').setPosition(4));
note2_4.addModifier(new VF.Articulation('a.').setPosition(4));

var stave2Voice = new Vex.Flow.Voice({ num_beats: 4, beat_value: 4 });
stave2Voice.addTickables([note2_1, note2_2, note2_3, note2_4, note2_5, note2_6, note2_7, note2_8]);

var formatter2 = new Vex.Flow.Formatter().joinVoices([stave2Voice]);//.format([stave2Voice], nStaveWidth);
formatter2.formatToStave([stave2Voice], stave2);

stave2Voice.draw(ctx, stave2);

var Dynamics2_1 = new Vex.Flow.TextDynamics({ text: "sfz", duration: "2" });
var Dynamics2_3 = new Vex.Flow.TextDynamics({ text: "p", duration: "4" });
var Dynamics2_4 = new Vex.Flow.TextDynamics({ text: "f", duration: "4" });
var stave2VoiceDynamics = new Vex.Flow.Voice({ num_beats: 4, beat_value: 4 });
stave2VoiceDynamics.addTickables([Dynamics2_1, Dynamics2_3, Dynamics2_4]);


var Dynamics_formatter2 = new Vex.Flow.Formatter().joinVoices([stave2VoiceDynamics]);
Dynamics_formatter2.format([stave2VoiceDynamics], nStaveWidth);

stave2VoiceDynamics.draw(ctx, stave1002);

var note2_1_X = note2_1.getAbsoluteX();
var staveFrom1To4_Y = note2_1.getStave().getYForLine(2.5);

const stave3 = new Stave(stave2.width + stave2.x, stave1.y, nStaveWidth).setContext(ctx);
stave3.setEndBarType(VF.Barline.type.NONE);
stave3.setSection("B", 0);
stave3.setMeasure(3);
stave3.draw();


const stave4 = new Stave(stave3.width + stave3.x, stave1.y, nStaveWidth).setContext(ctx);
stave4.setBegBarType(VF.Barline.type.NONE);
stave4.setEndBarType(VF.Barline.type.REPEAT_END);
stave4.setMeasure(4);
stave4.draw();

const notes4 = [
  new StaveNote({ keys: ["c/4", "e/4", "g/4", "b/4"], duration: "4" }),
  new StaveNote({ keys: ["d/4", "f/4", "a/4", "c/5"], duration: "4" }),
  new StaveNote({ keys: ["e/4", "g/4", "b/4", "d/5"], duration: "4" }),
  new StaveNote({ keys: ["f/4", "a/4", "c/5", "e/5"], duration: "4" })
];
notes4[0].addStroke(0, new VF.Stroke(3));
notes4[1].addStroke(0, new VF.Stroke(4));
notes4[2].addStroke(0, new VF.Stroke(3));
notes4[3].addStroke(0, new VF.Stroke(4));

var stave4Voice = new Vex.Flow.Voice({ num_beats: 4, beat_value: 4 });
stave4Voice.addTickables(notes4);

var formatter4 = new Vex.Flow.Formatter().joinVoices([stave4Voice]);
formatter4.format([stave4Voice], nStaveWidth);

var vibrato4 = new VF.VibratoBracket({
  start: notes4[1],
  stop: notes4[3],
});
vibrato4.setLine(2);

stave4Voice.draw(ctx, stave4);

vibrato4.setContext(ctx).draw();

const stave5 = new Stave(stave1.x, stave1.y + 200, nHeadMargin + nStaveWidth).setContext(ctx);
stave5.addClef("treble").setContext(ctx);
stave5.addTimeSignature('4/4').setContext(ctx);
stave5.setSection("C", 0);
stave5.setMeasure(5);
stave5.setEndBarType(VF.Barline.type.SINGLE);

stave5.draw();

var connector = new VF.StaveConnector(stave1, stave5);
connector.setType(VF.StaveConnector.type.SINGLE);
connector.setContext(ctx);
connector.draw();

const notes5 = [
  new StaveNote({ keys: ["a/4"], duration: "q" }),
  new StaveNote({ keys: ["b/4"], duration: "q" }),
  new StaveNote({ keys: ["c/5"], duration: "q" }),
  new StaveNote({ keys: ["d/5"], duration: "q" }),
];

var stave5Voice = new Vex.Flow.Voice({ num_beats: 4, beat_value: 4 });
stave5Voice.addTickables(notes5);

var formatter5 = new Vex.Flow.Formatter().joinVoices([stave5Voice]);
formatter5.format([stave5Voice], nStaveWidth);


var vibrato5 = new VF.VibratoBracket({
  start: notes5[3],
  stop: null,
});
vibrato5.setLine(2);
vibrato5.setHarsh(true);

stave5Voice.draw(ctx, stave5);

vibrato5.setContext(ctx).draw();

const tie3 = new StaveTie({
  first_note: notes5[1],
  last_note: notes5[2],
  first_indices: [0],
  last_indices: [0],
});

const tie4 = new StaveTie({
  first_note: notes5[2],
  last_note: notes5[3],
  first_indices: [0],
  last_indices: [0],
});

tie3.setContext(ctx).draw();
tie4.setContext(ctx).draw();

const stave6 = new Stave(stave5.width + stave5.x, stave5.y, nStaveWidth).setContext(ctx);
stave6.setEndBarType(VF.Barline.type.DOUBLE);
stave6.setMeasure(6);

stave6.draw();

const notes6 = [
  new StaveNote({ keys: ["e/5"], duration: "q", stem_direction: -1 }),
  new StaveNote({ keys: ["f/5"], duration: "q", stem_direction: -1 }),
  new StaveNote({ keys: ["g/5"], duration: "q", stem_direction: -1 }),
  new StaveNote({ keys: ["a/5"], duration: "q", stem_direction: -1 }),
];

Formatter.FormatAndDraw(ctx, stave6, notes6);

const tie5 = new StaveTie({
  first_note: notes5[3],
  last_note: notes6[0],
  first_indices: [0],
  last_indices: [0],
});

tie5.setContext(ctx).draw();


const stave7 = new Stave(stave6.width + stave6.x, stave5.y, nStaveWidth).setContext(ctx);
stave7.setMeasure(7);
stave7.draw();

const notes7 = [
  new StaveNote({ keys: ["a/4"], duration: "q" }),
  new StaveNote({ keys: ["b/4"], duration: "q" }),
  new StaveNote({ keys: ["c/5"], duration: "q" }),
  new StaveNote({ keys: ["d/5"], duration: "q" }),
];

var stave7Voice = new Vex.Flow.Voice({ num_beats: 4, beat_value: 4 });
stave7Voice.addTickables(notes7);

var formatter7 = new Vex.Flow.Formatter().joinVoices([stave7Voice]);
formatter7.format([stave7Voice], nStaveWidth);

var bracket7top = new VF.TextBracket({
  start: notes7[1],
  stop: notes7[3],
  text: "8",
  superscript: "va",
  position: 1
});
bracket7top.setLine(2);

var bracket7bottom = new VF.TextBracket({
  start: notes7[1],
  stop: notes7[3],
  text: "8",
  superscript: "vb",
  position: -1
});
bracket7bottom.setLine(4);
bracket7bottom.render_options.bracket_height = 40;
bracket7bottom.render_options.line_width = 2;
bracket7bottom.render_options.show_bracket = true;
bracket7bottom.setDashed(true, [2, 2]);
bracket7bottom.font.size = 15;
bracket7bottom.setDashed(false);
bracket7bottom.render_options.underline_superscript = false;
bracket7bottom.setFont({
  weight: "bold",
  family: "Arial",
  size: 15
});

stave7Voice.draw(ctx, stave7);

bracket7top.setContext(ctx).draw();
bracket7bottom.setContext(ctx).draw();

const stave8 = new Stave(stave7.width + stave7.x, stave5.y, nStaveWidth).setContext(ctx);
stave8.setMeasure(8);
stave8.draw();


const stave9 = new Stave(stave5.x, stave5.y + 200, nHeadMargin + nStaveWidth).setContext(ctx);
stave9.setMeasure(9);
stave9.draw();

var connector9 = new VF.StaveConnector(stave5, stave9);
connector9.setType(VF.StaveConnector.type.SINGLE);
connector9.setContext(ctx);
connector9.draw();

var connector9_2 = new VF.StaveConnector(stave5, stave9);
connector9_2.setType(VF.StaveConnector.type.BRACKET);
connector9_2.setContext(ctx);
//connector9_2.setText('E.Guitar');
connector9_2.draw();

Instrument2.x = stave1.x - 30;
Instrument2.y = stave5.y + ((stave9.y - stave5.y) / 2) + 90; 


const stave10 = new Stave(stave9.width + stave9.x, stave9.y, nStaveWidth).setContext(ctx);
stave10.setMeasure(10);
stave10.draw();


const stave11 = new Stave(stave10.width + stave10.x, stave9.y, nStaveWidth).setContext(ctx);
stave11.setMeasure(11);
stave11.draw();


const stave12 = new Stave(stave11.width + stave11.x, stave9.y, nStaveWidth).setContext(ctx);
stave12.setMeasure(12);
stave12.draw();

})();

const svgElement2 = document.querySelector('#yonet202403Mid_Output01 svg');
svgElement2.style.backgroundColor = '#F5F5F5';

var svgContainer = document.getElementById('yonet202403Mid_Output01');

var svgElement = svgContainer.querySelector('svg');

var newText = document.createElementNS('http://www.w3.org/2000/svg', 'text');
newText.setAttribute('x', '100');
newText.setAttribute('y', '100');
newText.setAttribute('font-family', 'Hiragino Kaku Gothic Pro, メイリオ, MS Gothic, sans-serif');
newText.setAttribute('font-size', '50');
newText.setAttribute('fill', 'black');
newText.textContent = 'TestTitle - subTitle - lyrics: yo-net, music: yo-net';

svgElement.appendChild(newText);


var newText2 = document.createElementNS('http://www.w3.org/2000/svg', 'text');
newText2.setAttribute('x', Instrument1.x);
newText2.setAttribute('y', Instrument1.y);
newText2.setAttribute('font-family', 'Bravura, VexFlow, Arial, sans-serif');
newText2.setAttribute('font-size', '20pt');
newText2.setAttribute('fill', 'black');
newText2.textContent = 'Vocal';

var textGroup2 = document.createElementNS('http://www.w3.org/2000/svg', 'g');
textGroup2.setAttribute('transform', 'rotate(-90 ' + Instrument1.x + ' ' + Instrument1.y + ')');

textGroup2.appendChild(newText2);

svgElement.appendChild(textGroup2);

var newText3 = document.createElementNS('http://www.w3.org/2000/svg', 'text');
newText3.setAttribute('x', Instrument2.x);
newText3.setAttribute('y', Instrument2.y);
newText3.setAttribute('font-family', 'Bravura, VexFlow, Arial, sans-serif');
newText3.setAttribute('font-size', '20pt');
newText3.setAttribute('fill', 'black');
newText3.textContent = 'E.Guitar';

var textGroup3 = document.createElementNS('http://www.w3.org/2000/svg', 'g');
textGroup3.setAttribute('transform', 'rotate(-90 ' + Instrument2.x + ' ' + Instrument2.y + ')');

textGroup3.appendChild(newText3);

svgElement.appendChild(textGroup3);

///////////////////////////
//直線による描画の例
///////////////////////////
var crescendoX = 900; // X座標
var crescendoY = 290; // Y座標
var crescendoWidth = 200; // クレシェンドの幅
var crescendoHeight = 20; // クレシェンドの高さ

// 新しいグループ要素の作成
var newGroup = document.createElementNS('http://www.w3.org/2000/svg', 'g');
newGroup.setAttribute('transform', 'translate(0, 0)');

// クレシェンドの線のパスを作成
var path = document.createElementNS('http://www.w3.org/2000/svg', 'path');
var pathStr = 'M ' + crescendoX + ' ' + crescendoY +
    ' L ' + (crescendoX + crescendoWidth) + ' ' + (crescendoY - crescendoHeight / 2) +
    ' L ' + crescendoX + ' ' + (crescendoY - crescendoHeight);
path.setAttribute('d', pathStr);
path.setAttribute('stroke', 'black');
path.setAttribute('stroke-width', '1');
path.setAttribute('fill', 'none'); // パスを透明にする
newGroup.appendChild(path);

// グループ要素の追加
svgElement.appendChild(newGroup);

///////////////////////////
//Bravuraフォントのデクレシェンド記号
///////////////////////////
var crescendo4X = 1110; // X座標1110
var crescendo4Y = 295; // Y座標290
var crescendo4Width = 80; // クレシェンドの幅
var crescendo4Height = 100; // クレシェンドの幅

// クレシェンド記号のフォント設定
var fontSize4 = 50; // フォントサイズ
var fontFamily4 = "Bravura, Arial"; // Bravuraフォントファミリー
var textContent4 = "\uE53F"; // デクレシェンド記号

// テキスト要素の作成
var newText4 = document.createElementNS('http://www.w3.org/2000/svg', 'text');
newText4.setAttribute('id', 'crescendoText'); // テキスト要素にIDを付ける
newText4.setAttribute('x', 0);
newText4.setAttribute('y', 0);
newText4.setAttribute('font-family', fontFamily4);
newText4.setAttribute('font-size', fontSize4);
newText4.setAttribute('fill', 'black');
newText4.textContent = textContent4;

// SVG要素にテキストを追加
svgElement.appendChild(newText4);

requestAnimationFrame(function() {
    var textWidth = document.getElementById('crescendoText').getBBox().width;
    var textHeight = document.getElementById('crescendoText').getBBox().height;

    // クレシェンドの幅に応じて縦方向のスケーリング
    var horizontalScale = crescendo4Width / textWidth;
    var verticalScale = 1.2;//crescendo4Height / textHeight; // ここは実際に表示される大きさをみてから固定で設定するべき。なぜならグリフ毎に縦横比が違うので、一筋なわではいかないから。

    newText4.setAttribute('transform', 'translate(' + crescendo4X + ',' + crescendo4Y + ') scale(' + horizontalScale + ',' + verticalScale + ')');

    // クレシェンド記号をSVG要素に追加する
    svgElement.appendChild(newText4);
});

})();
</script>

　TextBracketクラスのオブジェクトを生成するときのコンストラクタの引数は以下のような意味になっています。

第一引数：各種キーを保持した配列を設定できます。

• start

　横方向のテキストブラケット開始位置となるStaveNoteクラスのオブジェクトの音符配列の要素番号を示します。

• stop

　横方向のテキストブラケット終了位置となるStaveNoteクラスのオブジェクトの音符配列の要素番号を示します。

• text

　ブラケットの最初に挿入する文字を指定します。

• superscript

　上付き文字を指定します。オクターブ記号の8vaや8vbの英文字部分を上付きにする風習を実現するべく、装備された要素だと思われます。

• position

　五線譜の上側にテキストブラケットを表示する場合は1を設定し、下側にテキストブラケットを表示する場合は-1を設定します。

　ここからは、TextBracketクラスのオブジェクトのメンバ関数について紹介していきます。

• .setLine()

　引数に縦方向のオフセット量を設定できます。positionが1の場合は上側にオフセットするのが正の数で下側にオフセットは負の数になります。positionが-1の場合は、その逆になります。

• .setDashed()

　破線と実線の切り替えを指定する関数です。

第一引数：ブール値でtrueなら破線を描くようになり、falseなら直線を描きます。

第二引数：2要素の数値配列で、配列の0番目の要素に実線部分の長さ、1番目の要素に空白部分の長さを指定します。第一引数がtrueのときしか、役に立たないのが第二引数です。

• .setFont()

　テキストブラケットのtext要素とsuperscript要素のフォントについて設定する関数です。

第一引数：フォント設定に関する設定のオブジェクトをキー値を伴って設定します。

• weight

　フォントの太さを指定します。"bold"で太字です。

• family

　フォントファミリ名を設定します。

• size

　フォントの大きさを設定します。

　ここからはTextBracketクラスのオブジェクトのメンバ変数について紹介していきます。

• .render_options.bracket_height

　ブラケットの高さを設定します。数値

• .render_options.line_width

　ブラケットの線の太さを設定します。数値

• .render_options.show_bracket

　ブラケットの高さを記す線を描画するかしないかをブール値で設定します。trueで描画する。falseで描画しないという設定です。

• .font.size

　フォントの大きさを指定します。数値

• .render_options.underline_superscript

　スーパースクリプトの下に線を引くかどうかをブール値で設定します。trueで描画する。falseで描画しないという設定です。

　テキストブラケットの設定が終わったらTextBracketオブジェクトに対して.setContext(ctx).draw()という描画実行指示をする関数を指定します。

　

VexFlow 使い方に戻る。