Vulcan を Workshop モジュールに埋め込む

Vulcan ウィジェットを使用して、Vulcan を Workshop モジュールに埋め込めます。このウィジェットは、スタンドアロンアプリケーションと同じ3D ビューポートとツールを提供します。また、入力、出力、インターフェースを Workshop 変数に接続することで、Vulcan がモジュール内のほかのウィジェットと連携できます。

Vulcan を Workshop モジュールに埋め込むには、ウィジェットの追加、CAD オブジェクトの選択、ウィジェットの設定という3つのステップを実行します。

Workshop に Vulcan ウィジェットを追加する

Vulcan を表示する Workshop セクションで、+ アイコンまたは + ウィジェットを追加を選択してウィジェットメニューを開き、Vulcan ウィジェットを検索して選択します。

CAD オブジェクトを選択する

Vulcan で表示するには、CAD オブジェクトが1つ以上必要です。CAD オブジェクトとは、cad_media_reference タイプクラスを持つプロパティがあるオントロジーオブジェクトです。完全なスキーマについては、CAD オブジェクトを参照してください。

入力 > モデルでモデルを追加し、モデルオブジェクトを CAD オブジェクトを含む Workshop オブジェクトセットに設定します。Vulcan はセット内の最初のオブジェクトを読み込みます。複数のモデルを表示するには、オブジェクトセットごとに個別のモデルエントリーを追加します。

ウィジェットを設定する

Vulcan ウィジェットの設定は、次のセクションで構成されています。

入力

入力セクションでは、ウィジェットが使用するオントロジーデータとシナリオを制御します。

• モデル： CAD モデル入力の繰り返し可能なリストです。
  • モデルオブジェクト： モデルを含むオブジェクトセットです。
  • オプション： このモデルにのみ適用される設定です。変換とパーツの色分けは、以下の戻り値スキーマで説明する関数の出力を受け取ります。
    • アノテーションオブジェクト： モデルに関連付けられた注釈のオブジェクトセットです。各オブジェクトは注釈スキーマに従う必要があります。
    • 変換： パーツインスタンスまたはアセンブリの変換のオーバーライドです。変換の戻り値スキーマを参照してください。
    • 選択されたパーツIDと選択されたパーツインスタンスID： 現在の選択を表す双方向の文字列変数です。パーツIDは、このモデル内のそのパーツのすべてのインスタンスを選択します。パーツインスタンスIDは、特定の1個のインスタンスを選択します。
    • パーツの色分け： 色と不透明度のオーバーライドです。パーツの色分けの戻り値スキーマを参照してください。
    • フォールバック色： このモデル内の、色が割り当てられていないパーツに使用する CSS の色の値です。この値は、そのモデルに対してグローバルなフォールバック色をオーバーライドします。
• 測定オブジェクトと断面平面オブジェクト： 表示する測定と適用する断面平面を含むオブジェクトセットです。オブジェクトは、対応する測定または断面平面のスキーマに従う必要があります。
• シナリオ： オントロジーオブジェクトを読み込むときに使用する Workshop の主要シナリオです。

変換の戻り値スキーマ

変換は、次のフィールドを持つ構造体のリストを受け取ります。

行列の値は、[m11, m21, m31, m41, m12, m22, m32, m42, m13, m23, m33, m43, m14, m24, m34, m44] の順序で指定する必要があります。Vulcan は、ID がないエントリーや行列が無効なエントリーを無視します。

パーツの色分けの戻り値スキーマ

パーツの色分けは、次のフィールドを持つ構造体のリストを受け取ります。

モデルに反映されるには、各構造体で color、opacity、selectedOpacity のいずれかを1つ以上定義する必要があります。シーンの色分けツールでも色が割り当てられている場合は、シーンの色分けの値が優先されますが、設定された不透明度の値は引き続き適用されます。

インタラクション

カメラの対象点、位置、ズームのバインディングは双方向に機能します。インタラクションセクションでは、次のカメラとシーンのインタラクションの状態を Workshop 変数に接続します。

• カメラの対象点 X / Y / Z： カメラが向いている点です。3つの座標すべてを設定します。
• カメラの位置 X / Y / Z： カメラの場所です。3つの座標すべてを設定します。
• カメラズーム： カメラのズームレベルです。
• クリック X / Y / Z： ユーザーが最後に選択したモデルのパーツ上の点の3D座標を出力する数値変数です。選択した点を再構成するには、3個の変数すべてをバインドします。

スタイル

色の項目には CSS の色の値を指定できます。スタイルセクションでは、次の設定でシーンのデフォルトの外観を制御します。

• フォールバック色： 色が割り当てられていないパーツの色です。モデル固有のフォールバック色がある場合は、そのモデルに対して優先されます。
• 背景色： 3Dビューポートの背景色です。

インターフェース

すべてのオプションはデフォルトでオンになっています。インターフェースセクションでは、利用可能なインターフェース要素を制御します。

• サイドバーを表示、ツールバーを表示、ギズモを表示： シーンツリーのサイドバー、上部のツールバー、方向ギズモの表示設定を制御します。
• コンテキストメニューを有効にする： ユーザーがパーツのコンテキストメニューを開けるようにします。
• デフォルトでサイドバーを展開： ウィジェットが最初に読み込まれたときにサイドバーを開きます。

シーン

デフォルトでは、Vulcan は仕上げるモード、正投影カメラ、Orbit コントロールを使用します。モードの切り替えとパーツ情報はオン、自動回転はオフになっています。シーンセクションでは、次の設定で Vulcan によるモデルの表示方法とナビゲーション方法を制御します。

• デフォルトモード： 初期のシーンモードです。
  • 仕上げる： 組み立て済みのモデルと完全なシーンツリーを表示します。
  • グリッド： 重複のないパーツを並べ替え可能なグリッドで表示します。
  • コンポーネント： 選択したコンポーネントにフォーカスします。
• モードの切り替えを有効にする： シーンモードを変更するためのコントロールを表示します。
• カメラモード： 正投影またはパースペクティブカメラを使用します。
• コントロールモード： Orbit または Trackball のカメラコントロールを使用します。
• シーンの自動回転を有効にする： シーンを自動的に回転させます。
• 仕上げるモードの設定 > 選択時のパーツ情報を有効にする： ユーザーが仕上げるモードでパーツを選択したときに、パーツ情報を表示します。

ツール

ツールセクションでは、モジュールに不要な機能を非表示にできます。すべての設定はデフォルトでオンになっています。設定をオフにすると、そのツールのコントロールが埋め込みウィジェットから削除されます。各ツールの詳細は、ツールページで説明しています。

アクション

アクションセクションでは、ユーザーが作成したコンテンツを保存するオントロジーアクションを指定します。注釈アクション、測定アクション、断面平面アクションを使用して、コンテンツの種類ごとにアクションを選択します。

アクションを設定しない場合、Vulcan は必要なパラメーターのタイプクラスを持つアクションを見つけ、一致するアクションからユーザーが選択できるようにします。アクションを設定すると、保存に使用できるアクションがそのアクションに限定され、追加のアクションパラメーターに対してデフォルト値やユーザー入力項目を用意できます。Vulcan は、アクションタイプに記載されたツール固有の値を指定します。

出力

出力が1つ以上設定されている場合、ユーザーは測定ツールから Workshop に送信する測定を選択できます。出力セクションでは、次の設定を通じて、選択した測定を Workshop 変数に送信します。

• 測定のシーン距離： 測定した合計距離を、モデルのシーン単位の数値として出力します。
• 測定の単位距離： 同じ距離を、ユーザーが選択した表示単位で書式設定した文字列（12.30 mm など）として出力します。モデルの単位が認識されない場合、出力には units を使用します。