> For the complete documentation index, see [llms.txt](https://portalgraphvr.gitbook.io/portalgraphdokyumento/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://portalgraphvr.gitbook.io/portalgraphdokyumento/portalgraphapurinoi/app-settings.md).
# Portalgraphアプリ設定項目
Portalgraphを利用して作られたアプリケーションの設定画面の設定項目について解説します。
## メイン設定画面
F12キーを押すと設定画面が開かれます。設定画面は「カメラ」「トラッカー／カスタム」の2つのタブに分かれており、Webカメラで手軽に使いたい場合は「カメラ」タブ、VIVEトラッカーや複数画面構成など細かく設定したい場合は「トラッカー／カスタム」タブを選択します。\
（※以下のスクリーンショットは旧バージョンのものです。項目は下記の各タブ・共通項目に引き継がれています。）
### 共通項目（どちらのタブでも画面下部に表示）
* IPD…左右の目の距離（mm）。通常は変更する必要はありません。
* カメラ固定…視点を固定する際にチェックします。位置設定ボタンを押すとカウントダウンが始まるので、カウントダウン終了時の座標に視点が固定されます。
* フルスクリーン…排他的フルスクリーンとフルスクリーンウィンドウ（ボーダーレス）を切り替えます。環境によって表示のちらつきや入力遅延が変わることがあるので、気になる場合は切り替えて試してください。
* 閉じる（Esc）…設定画面を閉じます。
### カメラタブ
Webカメラ1台で手軽に使うための簡易設定タブです。3D表示方式（既定はAnaglyph）と画面サイズ（インチ）を入力すれば設定完了です。入力欄からフォーカスを外すとその場で反映されるので、ボタンを押す必要はありません。\
「手動調整」ボタンから、画面中心の位置・向きを矢印キーで直接調整する画面を開くこともできます。\
上級モードをチェックすると、画面サイズ（メートル単位、幅×高さ）・カメラ位置（上下左右中央＋XYZオフセット）・カメラ角度の詳細項目に切り替わります（下記「カメラトラッキング設定画面」と同じ項目です）。\
初心者が難しいことを考えずにすぐ使えるようにするため、このタブで値を反映するとビュー数（画面数）が自動的に1画面になり、トラッカーアプリ自動起動とトラッカー位置（Camera/Eye Center相当）も自動的に設定されます。
### トラッカー／カスタムタブ
VIVEトラッカーや複数画面構成など、細かく設定したい場合のタブです。カメラタブで設定した内容を引き継いだ上で、さらにカスタマイズできます。
* トラッカー位置…顔に対するトラッカーの位置をドロップダウンから選択します（Camera/Eye Center、Forehead等のプリセット）。プリセットで合わない場合は、目座標・目回転を直接数値で入力してカスタマイズできます。
* ビュー数、スクリーン、オフセット、スケール…マルチスクリーンやサブディスプレイでPortalgraphを表示する場合に設定します。「ビュー数」で表示画面数を設定し、「スクリーン」で画面番号を指定（メインスクリーンが1）、オフセットとスケールは画面内を部分的に使う場合に設定します。左下がオフセット(0,0）になります。変更後は適用をクリックすると反映されます。画面数、画面番号を変更した場合はアプリの再起動が必要になります。
* トラッカーアプリ自動起動…チェックされている場合、アプリ起動時に自動で下のドロップダウン・テキストボックスで指定されたトラッカーアプリが起動します。「起動」ボタンを押すと、その場で起動を試すこともできます。
* 次へ(N)…複数画面構成の詳細なキャリブレーションや、画面ごとにトラッカー/カメラを使い分けたい場合は、ここからキャリブレーション画面に進みます。
## キャリブレーション設定画面
「トラッカー／カスタム」タブで「次へ(N)」をクリックするとキャリブレーション画面が開きます。
（※上のスクリーンショットは旧バージョンのものです。各画面に画面番号と画面サイズ（メートル単位。トリムされている場合はその領域のサイズ）を示す枠が表示されるほか、3D・Inputのドロップダウン、「トラッカー」「カメラ」「手動調整」「画面トリム」の4つのボタン、「全クローズ(Esc)」「閉じる（Esc）」が表示されます。）
・3Dのドロップダウン・・・3D表示方式が選択できます。選択可能な値は以下です。\
\
Side-By-Side…左右分割\
Top-And-Bottom…上下分割\
Anaglyph…赤青メガネモード。右側に表示されてるドロップダウンで色の分離方式が選択可能です（ほとんどのケースではDuboisで問題ありません）\
No 3D…平面表示されます。右側のドロップダウンで右目映像と左目映像が選択できます。\
2 Outputs…右目映像を別の出力端子に出力します。右側のドロップダウンでどの画面に出力するか選択します。
・Inputのドロップダウン・・・入力デバイスを選択します（既定はMouse）。
・トラッカー／カメラ／手動調整／画面トリムの4つのボタンから、行いたいキャリブレーションの種類を選びます。
## 画面トリム
キャリブレーション設定画面で「画面トリム」をクリックすると、矢印キーで表示範囲を直接調整できる画面が開きます。プロジェクターの投影範囲が実際のスクリーンからはみ出している場合など、細かい位置合わせをしたいときに使用します。
・矢印キー…表示範囲（オフセット）を上下左右に移動します。\
・Shift+矢印キー…表示範囲のサイズ（スケール）を変更します。
画面上に現在のオフセットとスケールの値が表示されます。これはメイン設定画面の「オフセット」「スケール」と同じ値なので、後からメイン設定画面で数値を直接編集することもできます。調整が終わったらOKで確定、キャンセルで元に戻せます。
## カメラトラッキング設定画面
キャリブレーション画面で「カメラ」をクリックすると、カメラトラッキングのキャリブレーション画面が開かれます（メイン設定画面の「カメラ」タブも同じ項目を内包しています）。
カメラが画面中央のすぐ上に存在し真正面を向いていて、PC画面が16:9のアスペクト比の場合は、この画面で画面のインチ数を入力しOKをクリックすれば設定は完了です。
上級モードをチェックすると詳細設定が現れます。
・画面サイズ…使用モニターの画面サイズをメートル単位で入力します。
・カメラ位置…カメラの取り付け位置。ドロップダウンで上下左右中央を選び、テキストボックスでそこからの距離をメートル単位で入力します。XYZはそれぞれ、画面に向かって右、上、奥方向が正方向になります。\
・カメラ角度…カメラが画面に対して垂直でない場合に入力します。
## トラッカー設定画面
キャリブレーション画面で「トラッカー」をクリックするとトラッカー設定画面が開きます。
・画面サイズ…使用モニターの画面サイズをメートル単位で入力します。
・画面角度補正…もしも画面が垂直または水平の場合、こちらで選択するとキャリブレーション時に自動でその角度に補正します。
・トラッカー位置…キャリブレーション時に画面にトラッカーを合わせる際の位置を指定します。通常はCenterで良いですが、プロジェクタースクリーンを使って画面中央が柔らかくて安定しなかったり、3Dテレビで画面の反射でトラッカーの動作が安定しない場合等に影響を受けづらい場所を指定したりします。