# TWELITE STAGEの設定

`Windows` `macOS` `Linux` `M5Stack` 

各種設定を行います。

{% hint style="warning" %}
この画面のメニューはマウス操作できません。
{% endhint %}

以下の解説のメニュー中では、プラットフォームによっては存在しない項目がありますが、全てを列挙して解説します。

共通メニュー以外の色設定については、解説を省略します。

### ルートメニュー

```
共通設定
 ターミナル
 標準アプリ ビューア
 ＰＡＬ ビューア
 グランサー(簡易モニタ)
 コマンダー
 アプリ書換
 インタラクティブモード
ｾｰﾌﾞﾃﾞｰﾀ ﾕｰﾃｨﾘﾃｨ(ﾀﾞﾝﾌﾟ/消去)
情報
```

### 共通設定

```
a: (      0x00) 起動アプリ指定
G: (      0x00) 画面サイズ・描画方法
F: (          ) シリアルデバイスID
k: (         1) PS/2キーボードレイアウト
f: (0x00FFFFFF) 文字色
b: (0x005A0032) 背景色
```

| 設定             | 内容                                                                                                                                                                                                                         |
| -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 起動アプリ          | <p>TWELITE STAGE始動時にビューアアプリに移動する設定です。設定値は1..{ビューアアプリメニューで列挙されている数}です。<br>※ シリアルデバイスIDを設定しておかないと、始動時に接続するシリアルデバイス選択画面で入力待ちになります。</p>                                                                                        |
| 画面サイズ・描画方法     | <p><code>Windows</code> <code>macOS</code> <code>Linux</code> XYの２桁の文字で指定します(X:画面サイズ Y:描画方法) </p><ul><li> X 0:640x480 1:960x720 2:1280x720 3:1280x960 4:1920x1080 5:320x240</li><li>Y 0:LCD風 1:CRT風 2:ぼやけ 3:ブロック</li></ul> |
| シリアルデバイスID     | <p><code>Windows</code> <code>macOS</code> <code>Linux</code> 設定はシリアルデバイス名または数値の1..9 を指定します。<br>※ 数値の場合はデバイス列挙順になります。</p>                                                                                                  |
| PS/2キーボードレイアウト | `M5Stack` PS/2キーボードのレイアウトを指定します。0が英語、1が日本語レイアウトです。主に記号の配列が違います。                                                                                                                                                            |
| 文字色・背景色        | <p>文字色、背景色を指定します。共通設定の色設定値は他の画面の設定にも継承されます。他の画面で未設定の場合は共通設定の色設定が採用されます。</p><p>色はRGB 24bitを１６進数で指定しますが、内部的には16bit 565 形式に値が丸められます。</p>                                                                                      |

### アプリ書換

```
f: (0x00FFFFFF) 文字色
b: (0x005A0032) 背景色
j: (         0) ビルド時のmakeジョブ数
v: (         0) codeでフォルダを開く(VSCode)
n: (         0) 書換完了後の画面
```

| 設定                    | 内容                                                                                                                                                                            |
| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ビルド時のmakeジョブ数         | <p><code>Windows</code> <code>macOS</code> <code>Linux</code> ビルドを行う際の並列ジョブ数です。適切な数を設定することでビルド時間の短縮を期待できます。<br>規定値0は論理プロセッサ数の半分でジョブ数を計算しています。目安としては論理プロセッサ数を上限とすると良いでしょう。</p> |
| codeでフォルダを開く (VSCode) | `Windows` `macOS` `Linux` 1を設定することでOS標準のフォルダウインドウの替わりにcodeコマンド（VS Code）でフォルダを開きます。                                                                                            |
| 書換完了後の画面              | `Windows` `macOS` `Linux` `M5Stack`1を設定することでインタラクティブモード画面の替わりに、ターミナルを開きます。                                                                                                    |

### セーブデータユーティリティ

```
r: Read sector.
R: Read ALL sectors.
e: Erase sector.
E: Erase ALL sectors.
```

この画面ではデータセーブ領域のメンテナンスを行うユーティリティです。EEPROM(64バイトを１セクタとして最大60セクタ、3840バイト)をエミュレートしています。

| 設定 | 内容                                                |
| -- | ------------------------------------------------- |
| r  | セクタを読み出します。0..59を入力すると、入力したセクタ番号のセクタの内容を表示します。    |
| R  | （YESを入力すると全セクタの読み出しを行いますが、一番最後の部分しか表示されません）       |
| e  | セクタを消去(0xFF)します。0..59を入力すると、入力したセクタ番号のセクタが消去されます。 |
| E  | YESを入力すると全セクタを消去します。                              |

{% hint style="info" %}
`Windows` `macOS` `Linux` では`TWELITE_Stage.sav`ファイルに保存されます。\
`M5Stack`ではフラッシュメモリのEEPROMエミュレート領域に保存されます。
{% endhint %}