headsUpDisplay

 ________________________
|    |    |    |    |    |
|    |    |    |    |    |
| 0  | 1  | 2  | 3  | 4  |
|    |    |    |    |    |
|____|____|____|____|____|
|    |    |    |    |    |
|    |    |    |    |    |
| 5  | 6  | 7  | 8  | 9  |
|    |    |    |    |    |
|____|____|____|____|____|

各セクションは、上記のとおり 0 から 9 までの番号で表されます。たとえば、上列の左から 2 行目の場合、セクションは次のように定義されます。-sec 1

ヘッドアップ ディスプレイが重なり合って文字が煩雑になることを回避するため、それぞれの行には表示の優先順位が定義されていて、各セクションの表示にも優先順位が設定されています。この優先順位に従って、画面スペースが狭まって行のセクション幅が重なり合うと、HUD は優先順位が一番低いセクションを自動的に除去します。これらのセクションは非表示になり、除去されたことを伝える警告メッセージが表示されます。この処理は、最優先のセクションのみが残るまで継続されます。

それぞれの行の優先順位は、次のように定義されます(上列を例に挙げます)。セクション 0 が最優先され、セクション 4 が 2 番目と、外側のセクションの優先順位が最も高くなります。次にセクション 2 、続くセクション 1 と 3 の優先順位は等しく、共に優先順位が最も低くなります。この優先順位の構造は、下列にも適用されます。外側の 2 セクションが最優先され、中央のセクションが続き、残りの 2 セクションの優先順位が最も低くなります。

つまりビューポートの幅が狭まって上列のセクションが重なり始めた場合、まずセクション 1 と 3 がビューから除去され、続いてセクション 2 が、最後にセクション 4 が除去されます。ブロック レイアウトについても、同様の説明が以下に記されています。

各セクションに表示されるブロック数は、各セクションにあるブロックのサイズとウィンドウの現在のサイズによって決まります。ブロック数は 0 から始まり、必要に応じて増加します。

結果として生じる各 HUD の出力文字列は、次に挙げる justify、padding、labelWidth、dataWidth などのフォーマット フラグで定義するパラメータで、各ブロック内でフォーマットされます。レイアウトは下図のとおりです。

 __________________________________________
|     |     |        |         |     |     |
|  P  |  J  |   LW   |   DWX   |  J  |  P  |
|_____|_____|________|_________|_____|_____|
P = 幅のサブブロック、パディング
J = ブロック全体の行端揃え
LW = 幅のサブブロック、labelWidth
DWX = 特定数の幅のサブブロック、特定数のデータ要素用の dataWidth

ブロック レイアウト

上図は、各ブロックのレイアウトを示しています。幅: パディング、labelWidth、dataWidth はそれぞれのフラグで定義されます。ブロックのレイアウトの詳細: まずブロックのパディングが計算されます。次に上図の 2 つの主要サブブロック(LW と DWX)がブロックの左右マージンの間で位置揃えされ、一緒に配置されます。主要サブブロックの幅はその内容に関わらず、変化しません。上図で唯一特有のサブブロックは X (特定数)のサブブロックを表す DWX サブブロックのみで、X はコマンドが返すデータ要素の数です。

ブロックの位置決め

上部セクションのブロックは主要ビューポートの上端から始まり、下部セクションは下端から始まります。ブロックは、ビューポートの中間から動的に非表示になります。したがって、比較的多いブロック数はビューポートへと引き寄せられません。

最後に、単一ブロックを占有できる HUD の数は一つです。占有されているブロックに HUD をさらに配置しようとするとエラーになります。HUD を配置する際の注意点です。

attributeChange: このスクリプトは、現在選択されているノードのすべてのアトリビュート変更に対応します。

connectionChange: このスクリプトは、現在選択されているノードのすべての接続変更に対応します。

instanceChange: このスクリプトは、現在選択されているノードのすべてのインスタンス変更に対応します。

このフラグは照会モードで、すべての nodeChanges の値を対(nodeChange の名前に続きその値)で返します。

警告: (パフォーマンス警告)
         対象のノード変更が HUD スクリプトによって引き起こされた場合、nodeChange トリガを選択ベースのトリガにアタッチするとパフォーマンスが著しく低下することがあります。

         したがって、HUD コマンドやスクリプトを簡潔にし、用途をデータの読み出しに限定するように努めてください。アトリビュートの修正、接続やインスタンスの作成は、パフォーマンスの低下につながります。

使用可能なプリセットの説明を次に記します。

cameraNames

HUD が寄せているビューごとに、ビューが使用しているカメラ名をデータ ブロック内に返します。

polyVerts

カメラから見える頂点の数に関する 3 つの値をデータブロック内に返します。

• 第 1 の値: カメラから見えるアクティブと非アクティブな頂点の数を表します。
• 第 2 の値: カメラから見えるアクティブ オブジェクトのみにある頂点の数を表します。
• 第 3 の値: カメラから見えるアクティブな頂点の数を表します。

polyEdges

カメラから見えるエッジの数に関する 3 つの値をデータブロック内に返します。3 つの値の順序は、polyVerts プリセットと同様です。

polyFaces

カメラから見えるフェースの数に関する 3 つの値をデータ ブロック内に返します。3 つの値の順序は、polyVerts プリセットと同様です。

polyUVs

カメラから見える UV の数に関する 3 つの値をデータブロック内に返します。3 つの値の順序は、polyVerts プリセットと同様です。

polyTriangles

カメラから見える三角の数に関する 3 つの値をデータ ブロック内に返します。3 つの値の順序は、polyVerts プリセットと同様です。

frameRate

フレーム レートと「fps」文字列の両方を含む単一の文字列をデータ ブロック内に返します。これはリフレッシュごとに更新されます。

viewAxis

HUD 内のグリッド軸の向きを描画します。これはリフレッシュごとに更新されます。このプリセットはすべてのアトリビュート フラグに対応しますが、プリセットに影響を与えるのは、block alignment と block size などのブロック アトリビュート関連のフラグに限定されます。このプリセットのブロック寸法は、blockSize -「large」、blockWidth -「50」で、ピクセルの領域は 50x50 になります。

distanceFromCamera

ビューのカメラから、ビュー内で選択したオブジェクトが含まれるバウンディング ボックスの中心までの距離をデータ ブロック内に返します。

照会モードでは、このフラグに値が必要になります。