> For the complete documentation index, see [llms.txt](https://manual.karamba3d.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://manual.karamba3d.com/jp/3-konpnentorifarensu/3.8-utilities/3.9.19-head-up-display-legend.md).

# 3.9.19 ヘッドアップディスプレイ凡例

Grasshopperの標準Legendコンポーネントは、色とテキストのペアを表示することができ、構造解析から得られるカラープロットを解釈するのに役立ちます。ただし、1つの制限は、ヘッドアップディスプレイ（HUD）をサポートしていないことです。ここでKaramba3D Legendコンポーネントが価値を発揮します（図3.9.19.1参照）。これは画面上に固定されたままで、凡例の外観をカスタマイズするためのいくつかのオプションを提供します。

<figure><img src="https://147116332-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz9HWyQapP9tu9mJjh5O9%2Fuploads%2Fgit-blob-fff849704cb8e3b703eda40e8b7b9eae0231ca00%2FhudDisplay.png?alt=media" alt=""><figcaption><p>図3.9.19.1: 複数のビューポートにおけるKaramba3Dヘッドアップディスプレイ凡例。</p></figcaption></figure>

**Legendコンポーネントの入力プラグ:**

* 「**C**」は色のリストを想定します。
* 「**T**」は対応するテキストのリストを受け入れます。
* 「**S**」は凡例をスケーリングできます。値「1」はビューポートの全サイズに対応します。
* 「**TS**」凡例のテキストサイズをスケーリングするためのビューポート依存の係数。
* 「**VP**」凡例を表示するビューポート名のリストを受け取ります。デフォルトでは、凡例はすべてのアクティブなビューポートに表示されます。

追加のカスタマイズオプションは、コンポーネントを右クリックすると開かれるコンポーネントのコンテキストメニュー（図3.9.19.2参照）からアクセスできます。

<figure><img src="https://147116332-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz9HWyQapP9tu9mJjh5O9%2Fuploads%2Fgit-blob-815a9bb427e91b5d831f25ccf6a42a860361f1be%2Fhuddisplaycontextmenu.png?alt=media" alt="" width="375"><figcaption><p>図3.9.19.2: Karamba3D凡例コンポーネントのコンテキストメニューオプション。</p></figcaption></figure>

**コンテキストメニューオプションには以下が含まれます:**

* **Position:** 凡例が表示されるビューポートの側を選択できます。この設定は、凡例が垂直方向に配置されるか水平方向に配置されるかも決定します。
* **Justification:** 選択された側の凡例の整列を定義します。オプションには「Left」、「Center」、「Right」が含まれます。垂直方向に配置された凡例の場合、これは「Top」、「Center」、「Bottom」に対応します。
* **Show header separately:** Karamba3Dコンポーネントが結果を色とテキストのペアとして出力する場合、最初のテキスト項目は通常、量を記述するヘッダーとして機能します。対応する最初の色は通常、現在の数値範囲を下回る値を示します。このオプションを有効にすると、最初の色が非表示になり、凡例エントリの残りの上にヘッダーテキストが配置されます。

このアイデアを提案し、初期実装を提供してくれたRudolf Neumerkelに特別な感謝を捧げます。

{% embed url="<https://youtu.be/339gbdnZKUM?si=WkZsKtNnFtcFBYRs>" %}

{% file src="/files/VfzQzSGkdGVPQHdvtW0h" %}