注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。

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

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

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

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

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

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

Vulcan で表示するには、CAD オブジェクトが1つ以上必要です。CAD オブジェクトは、vulcan:cad_media_reference タイプクラスを持つ Media Reference プロパティを備えたオントロジーオブジェクトです。設定手順については、はじめるを参照してください。完全なスキーマについては、CAD オブジェクトを参照してください。

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

ウィジェットを設定する

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

入力

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

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

変換の戻り値スキーマ

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

項目必須種類説明
idはい文字列変換するパーツインスタンスまたはアセンブリの ID。
transformはい数値の配列列優先順で4×4の変換行列を表す、正確に16個の有限の数値。

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

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

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

項目必須種類説明
partInstanceIdsはい文字列の配列スタイルを設定するパーツインスタンスまたはアセンブリの ID(1つ以上)。
colorいいえ文字列#0055ff や rgb(0, 85, 255) などの CSS の色の値。
opacityいいえ数値基本の不透明度。透明を表す 0 から不透明を表す 1 までの値です。
selectedOpacityいいえ数値選択時またはハイライト時の不透明度。同じく 0 から 1 までの尺度を使用します。

各構造体がモデルに影響を与えるには、color、opacity、selectedOpacity のうち1つ以上を定義する必要があります。シーンの色分けツールでも色が割り当てられている場合は、シーンの色分けの値が優先され、設定済みの不透明度の値は引き続き有効です。

インタラクション

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

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

スタイル

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

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

インターフェース

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

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

シーン

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

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

ツール

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

設定機能
注釈ツールを有効にするモデルのパーツへの注釈の作成。
メッシュスタイル設定ツールを有効にする個々のメッシュの外観の制御。
測定ツールを有効にするモデル上の点間の距離の測定。
断面表示ツールを有効にする切断平面を使用したモデルの断面表示。
変換ツールを有効にするパーツとアセンブリの再配置。
シーンの色分けツールを有効にするプロパティまたは関数に基づくパーツの色分け。

アクション

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

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

出力

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

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