# TWELITE STAGEの設定

`Windows` `macOS` `Linux` `RasPi` `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> <code>RasPi</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> <code>RasPi</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) 書換完了後の画面
l: (         0) LTOを行わない
```

| 設定                    | 内容                                                                                                                                                                                                    |
| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ビルド時のmakeジョブ数         | <p><code>Windows</code> <code>macOS</code> <code>Linux</code> <code>RasPi</code> <br>ビルドを行う際の並列ジョブ数です。適切な数を設定することでビルド時間の短縮を期待できます。<br>規定値0は(物理プロセッサ数-1)でジョブ数を計算しています。目安としては論理プロセッサ数を上限とすると良いでしょう。</p> |
| codeでフォルダを開く (VSCode) | `Windows` `macOS` `Linux` 1を設定することでOS標準のフォルダウインドウの替わりにcodeコマンド（VS Code）でフォルダを開きます。                                                                                                                    |
| 書換完了後の画面              | <p><code>Windows</code> <code>macOS</code> <code>Linux</code> <code>RasPi</code> <code>M5Stack</code><br>1を設定することでインタラクティブモード画面の替わりに、ターミナルを開きます。</p><p>2を設定することで、書換メニューに戻ります。</p>                     |
| LTOを行わない              | `Windows` WindowのコンパイラはLTOの仕組みにより少しだけ小さいバイナリを生成することが可能ですがリンクに時間がかかります。この手順を省略しより高速なリンクを可能とします。                                                                                                        |

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

```
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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://stage.twelite.info/1.0-1/usage/screens/main_menu/settings.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.