コンソール
コンソールは、診断や試行のためのエンジン独自のウィンドウです。エンジンが報告する内容 (構成の問題、失敗したスクリプト、代替の描画に切り替わったプラグイン) を表示し、スクリプトが出力する内容を表示し、その場でスクリプトを書いて実行できるエディターを備えています。
コンソールを開く
トレイ メニューの コンソールを表示 を選ぶか (トレイ アイコン)、アクションから UIShowConsole 組み込み関数を実行します (たとえば、ホットキーに割り当てます)。メッセージ受信時 (下記) で求めない限り、コンソールが自動的に開くことはありません。
構成がパスワードで保護されている場合、コンソールは開くときに、パスワードがまだ記憶されていない限りパスワードを求めます (セキュリティ)。コンソールが開いている間は、記憶されたパスワードの期限は切れません。UIShowConsole は、パスワードを求めている間も含めてコンソールが開くまで待ち、開かなかった場合 (たとえばパスワードの確認がキャンセルされた場合) は false を返します。
コンソールは閉じるボタンで閉じます。閉じると、使っていたメモリが解放されます。
3 つのセクション
上部のボタン ① で、3 つのセクションを切り替えます。各セクションには独自のツール バーがあります。
| セクション | 表示内容 | ツール バー |
|---|---|---|
| システム | エンジンが報告する内容: 前回の読み込み時の構成についてのお知らせ、失敗したアクションとスクリプトとその理由、描画できなかったため組み込みの描画に切り替わったプラグインなど。 | コピー、クリア、メッセージ受信時 |
| ユーザー | すべてのアクションから、スクリプトが UtilityPrint で出力するすべての内容。 | コピー、クリア、メッセージ受信時 |
| スクリプト | 出力ウィンドウの上にあるスクリプト エディター。 | 実行、すべて停止、コンソールを隠す、スクリプト ヘルプ、コピー、貼り付け、クリア |
コピー は、選択したテキスト、または何も選択されていない場合はセクション全体をコピーします。クリア はセクションを空にします。
スクリプト セクションの表示中は、新しい システム と ユーザー の行もその出力ウィンドウに表示されるため、セクションを切り替えずに実行中のスクリプトを監視できます。
コンソールが閉じている間
コンソールが閉じている間に届いた行は失われません。一時ファイルに保持され、次にコンソールを開いたときに表示されます。Input.Observer が終了すると、それらは削除されます。ただし、エンジンのシャットダウン イベントが出力した内容は例外で、次のセッションのコンソールに表示されます。
システム と ユーザー のツール バーにある メッセージ受信時 ① で、コンソールが閉じている間に新しい行が届いたときの動作を選びます。
| 選択肢 | 起こること |
|---|---|
| 何もしない | 行はコンソールを開くまで待機します。既定です。 |
| UIShowMessageBox を表示 | 行はメッセージ ボックスにもポップアップ表示されます。 |
| コンソールを開く | コンソールがそのセクションで開きます。 |
コンソールが開いている場合、新しい行は単に追加されるだけで、ボックスがポップアップしたりセクションが切り替わったりすることはありません。同じ選択肢が、コンソール ページの 新しいシステム メッセージ と 新しいユーザー メッセージ にもあります。
スクリプトを実行する
- コンソールの スクリプト セクションを開きます。
- エディターにスクリプトを入力するか貼り付けます。Input.Observer のスクリプト言語を使います (スクリプト言語)。
- 実行 ② を選ぶか、F5 キーを押します。テキストを選択している場合は選択範囲だけが実行され、そうでない場合はエディター全体が実行されます。
- 出力とエラーは、エディターの下の出力ウィンドウに表示されます。コンソールを隠す で、そのウィンドウの表示と非表示を切り替えます。
- ここで実行するスクリプトはアクションと同じように動作します。すべての組み込み関数を使え、終わるか停止されるまで実行されます。すべて停止 は、このスクリプトだけでなく、実行中のすべてのスクリプトとアクションを停止します。
- セーフ モードでスクリプトが実行されるのはここだけです。そのため、ほかに何も実行されていない状態で調査や修復を行えます (トラブルシューティング)。
- エディターは、入力中に組み込み関数の名前を補完します。Ctrl+Space キーですべてが一覧表示され、領域名とピリオドを入力するとその領域の組み込み関数が一覧表示されます。組み込み関数を選ぶと、そのパラメーターがヒントに表示され、現在のパラメーターが強調表示されます。右クリック メニューには、選択した行に対する コメント化 と コメント解除 があります。
- エディターのテキストは、
console.tomlに保存されてセッションをまたいで保持されます。
スクリプト ヘルプ ③ は、Input.Observer が使用している言語 (その言語のヘルプがない場合は英語) で、ヘルプ ウィンドウ (ヘルプ ウィンドウ) にスクリプト言語リファレンスを開きます。
コンソール ページ
詳細モード。 コンソール ページは、シンプル モードでは非表示になります。その設定は引き続き有効です。
構成ウィンドウの コンソール ページには、コンソールの設定があります。適用 または 保存して閉じる を選ぶと有効になります。
| 設定 | 動作 | 既定値 | 範囲 |
|---|---|---|---|
| コンソールの行数の上限 | セクションの行数がこの値に達すると、新しい行が届くたびに古い行が削除されます。0 にするとすべて保持します。次の行から有効になります。 | 5000 行 | 0～1000000 |
| コンソールを閉じたときにメモリを解放する | コンソールを閉じるとすぐに、そのメモリを Windows に返します。その直後のマウスまたはキーボードのイベントが、ごくわずかに遅くなる場合があります。 | オン | オンまたはオフ |
| 新しいシステム メッセージ | コンソールが閉じている間に新しい システム の行が届いたときの動作: 何もしない、メッセージ ボックス、コンソールを開く (上記の メッセージ受信時 と同じ) | 何もしない | — |
| 新しいユーザー メッセージ | ユーザー の行について同じもの | 何もしない | — |
| エンジンのウィンドウのフォント | コンソールのラベルとボタン、およびエンジンのダイアログ (パスワード、ライセンス) のフォントとサイズ | Segoe UI、12 pt | 6～72 pt |
| エンジンのエディターのフォント | コンソールのセクションとスクリプト エディターのフォントとサイズ | Consolas、13 pt | 6～72 pt |
開いているコンソールは、閉じて開き直すまで現在のフォントのままです。