パラメーターの設定

概要

　TuneEditorは出力イメージ(jpegファイル)のレイアウトや文字/ドットの設定、キーボード割り当てなど、さまざまな設定項目を変更できるようになっています。

パラメーターの設定方法

　パラメーターを設定する方法は3種類あり、それぞれ以下のような特徴を有しています。

設定方法	長所	短所
アクセスURLからの設定	パラメーターごとブックマークしておくことが可能。	実行中に変更できない（ページの再ロードが必要）。
メンテナンス用ダイアログボックスからの設定	実行中に変更することが可能。	1つずつしか設定できない。ページを再ロードした時にこのダイアログボックスを使って1つずつ再設定する必要がある。
.cfgファイルからの設定	複数の設定をまとめておくことが可能。	ページを再ロードした時に設定ファイルを読み込み直す必要がある。

アクセスURLからの設定

　TuneEditorにアクセスするためのURLの直後に複数のパラメーターを指定することができます。その形式は以下のようになっています。

http://〜TuneEditorへのアクセスアドレス〜?キーワード=値&キーワード=値・・・

　つまり、URLと最初のパラメーターの間は疑問符（?）で区切り、パラメーター自体は「キーワード=値」という形式をとり、複数のパラメーターを指定する場合にはパラメーター設定間をアンパサンド（&）で区切るというものです。また、パラメーターに空白が含まれる場合、空白を「%20」に置き換えてください。

　※ なお、パラメーターのキーワードは大・小文字を区別するので、指定時には間違わないようにしてください。

　例：

https://mmurak.github.io/tuneEditor/tuneEditor4.html?FullBaseline=0&sf=75

メンテナンス用ダイアログボックスからの設定

　TuneEditorの実行中に、Ctrlキー+Kを入力することで、メンテナンス用ダイアログボックスが開きます。この画面から「キーワード=値」という形式でパラメーターを指定することができます。

　この方法で設定したパラメーターは、ブラウザーのタブをクローズ／再ロードするまで有効となります。

　※ なお、パラメーターのキーワードは大・小文字を区別するので、指定時には間違わないようにしてください。

.cfgファイルからの設定

　ファイル入力ボタンから.cfg形式のファイルを読み込み、複数のパラメーターを一度に設定することができます。この設定はブラウザーのタブをクローズ／再ロードするまで有効となります。

　この方法ではまず、テキストエディターを使用してパラメーター設定ファイルを作成します。ファイルの拡張子は「.cfg」とし、その形式は以下の通りです。

　例：

FullBaseline=0
sf=75
　・
　・
　・

　※ なお、パラメーターのキーワードは大・小文字を区別するので、指定時には間違わないようにしてください。

パラメーターの設定内容

描画領域全体のレイアウト

　TuneEditorは出力イメージを作成するにあたり、最小の幅（CanvasMinWidth）と最小の高さ（CanvasMinHeight）という設定値から最小限の描画領域を作成し、その上下左右に余白（CanvasTopMargin, CanvasBottomMargin, CanvasLeftMargin, CanvasRightMargin）を確保するようになっています。

　なお、この最小限の描画領域の幅は、入力された行が長くなっていくと必要に応じて自動拡張されます。また、高さも改行が入力されるたびに、TSM行の高さ（TSMHeight）と、行間表記を使う場合にはその高さ（DotsAreaHeight）が加味されて自動的に拡張していくようになっています。

　指定できるパラメーターとそのデフォルト値は、このページにまとめています。

TSM領域に関するパラメーター

　TSM領域に関するパラメーターは以下の通りです。

パラメーター名	意味
TSMHeight	TSM領域の高さをピクセル単位で指定します。
TSMBaseLineOffset	該当行のTSM領域の最上部から見た文字のベースラインの位置をピクセル単位で指定します。
FontName	フォント名称を指定します。
FontSize	フォントサイズを指定します。なお、この使用は非推奨です（このパラメーターは通常の文字のサイズを指定するものであり、現時点ではTSM記号のサイズは変更されません--つまり使用すると文字とTSM記号のサイズのバランスが崩れてしまうのです）。

行間表示領域に関するパラメーター

　行間表示領域に関するパラメーターは以下の通りです。

パラメーター名	意味
DotsSwitch	行間表示の使用有無を「0」か「1」で指定します。
DotsAreaHeight	行間表示領域の高さをピクセル単位で指定します。
TopLineOffset	該当行の行間表示領域の最上部から見た上限ラインの位置をピクセル単位で指定します。
BottomLineOffset	該当行の行間表示領域の最上部から見た下限ラインの位置をピクセル単位で指定します。
DotSSize	最小サイズのドット径をピクセル単位で指定します。
DotMSize	中サイズのドット径をピクセル単位で指定します。
DotLSize	最大サイズのドット径をピクセル単位で指定します。
GlideMagFactor	現在未使用。
DotDistributionPattern	ドットの分布パターンを「0」〜「2」で指定します（詳細は後述）。
CentrelineSwitch	長瀬線（中央部の点線）の描画有無を「0」か「1」で指定します。

ドットの配置パターン（DotDistributionPattern）について

　上下線の間にサイズの異なるドットを縦方向に配分しようとした場合、いくつかのパターンが考えられます。

設定「0」：ドットの外周が上下線に接する位置を大/中/小のドットごとに計算し、中間の音は均等割りで配置する。

デメリット：この場合、同じ高さの音でもドットのサイズが異なっている場合、音が高くなればなるほど、あるいは低くなればなるほど中心の高さが異なってしまう。
設定「1」：最大のドットの外周が上下線に接する際のドットの中心位置を算出し、すべてのサイズのドットでその中心位置を使用するようにする。なお中間の音は均等割りで配置する。

デメリット：この場合、大サイズ以外のドットの外周は上下線に接することがなくなる。
設定「2」：ドットの高さが最低/最高の場合にドットの外周が上下線に接するようにし、それ以外の場合には設定「1」を採用する。

デメリット：この場合、上昇調/下降調でドットを並べた場合、大サイズ以外のドットが直線上に並ばないケースが出てくる。

　なお、TuneEditorではこれら3つの戦略を起動時に選択することが可能になっています。

キーボード割り当て

　各種のキーボード割り当ても変更することができますが、OSが規定しているキーボードショートカットと衝突しないようなかたちで指定する必要があります。衝突させてしまうと、思いがけない副作用に頭を抱えることになるかもしれません。

　詳細はまとめのページを参照してください。