Vuforia Studio のナビゲーション > 「プロジェクト」枠 > リソース > 3D モデル構造の境界ボックスと位置データのエクスペリエンスへの取り込み
3D モデル構造の境界ボックスと位置データのエクスペリエンスへの取り込み
PTC.Structure API は、3D モデルの各部品の境界ボックスと位置に関する情報を提供します。この情報をエクスペリエンスで使用することにより、モデルまたはモデル内の個々の部品を基準にしてウィジェット (3D イメージ、ラベルなど) を配置できます。
* 
この API を使用するには、モデルのインポート時に、「エクスペリエンスの CAD メタデータへのアクセスを許可」チェックボックスをオンにする必要があります。
API は、境界ボックスと位置情報を取得するための関数呼び出しと、この情報を表示および操作するために使用される JavaScript オブジェクトのセットで構成されています。PTC.Structure API を使用するには、最初に、構造情報を取得する 3D モデルの Id を指定して、fromId(…) 関数を呼び出す必要があります。この関数は JavaScript Promise を返します。
これらの API は、Promise に基づいています。Promise の詳細については、https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise を参照してください。
例:
PTC.Structure.fromId(‘model-1’).then( (structure) => {
	      // Do something with ‘structure’ 
});
構造 API 関数
宣言
パラメータ
説明
getBounds (idpath)
• {string|string[]} idpath - '/0/1' などの ID パス、または ['/0/1', '/0/2'] などの ID パスの配列。
• {string|string[]} propName - (オプション) 例: 'Display Name' または ['Display Name', 'Part ID Path']
• {string|string[]} categoryName - (オプション) 例: 'PROE Parameters'
指定された idpath および propName の ID パスまたはプロパティ値を表すメタデータオブジェクトを取得します。
この関数は、指定された idpath を表すメタデータオブジェクトを返します。propName が指定されている場合は、コンポーネントのプロパティの値が返されます。
例:
     PTC.Metadata.fromId('model-1').then( (metadata) => {
       var result = metadata.get('/0/6', 'Display Name')
     });
getLocation (idpath)
• {string|string[]} propName - (オプション) 例: 'Display Name' または ['Display Name', 'Part ID Path']
• {string|string[]} categoryName - (オプション) 例: 'PROE Parameters'
この関数は、1 つのコンポーネントからのすべての文字列プロパティの値を返します。使用可能なデータ/コンポーネントがない場合は未定義になります。指定した propName が配列の場合、値の string[] を返します。
例:
     PTC.Metadata.fromId('model-1').then( (metadata) => {
       var result = metadata.get('/0/1').getProp('Display Name');
     });
Structure.Bounds オブジェクト
Structure.Bounds オブジェクトは 3D 空間での軸平行境界ボックス (AABB) を表します。
Structure.Bounds オブジェクトプロパティ
プロパティ
説明
min
プロパティ x、y、z を持つオブジェクトとして表される境界ボックスの最小範囲と、これら 3 つの値を配列として返す asArray メソッド。
例:
PTC.Structure.fromId(‘model-1’).then( (structure) => {
    var bounds = structure.getBounds(‘/0/6’);
    var min_X = bounds.min.x;
}
max
プロパティ x、y、z を持つオブジェクトとして表される境界の最大範囲と、これら 3 つの値を配列として返す asArray メソッド。
例:
PTC.Structure.fromId(‘model-1’).then( (structure) => {
    var bounds = structure.getBounds(‘/0/6’);
    var max_X = bounds.max.x;
}
center
プロパティ x、y、z を持つオブジェクトとして表される境界ボックスの中心点と、これら 3 つの値を配列として返す asArray メソッド。
例:
PTC.Structure.fromId(‘model-1’).then( (structure) => {
    var bounds = structure.getBounds(‘/0/6’);
    var center_X = bounds.center.x;
}
corners
プロパティ x、y、z を持つオブジェクトとして表される境界ボックスの 8 つのコーナー点の配列と、これら 3 つの値を配列として返す asArray メソッド。
例:
PTC.Structure.fromId(‘model-1’).then( (structure) => {
    var bounds = structure.getBounds(‘/0/6’);
    var one_corner = bounds.corners[0];
    var one_corner_X = one_corner.x
}
Structure.Bounds オブジェクト関数
宣言
パラメータ
説明
transform (位置、回転、スケール)
• {number[]|string[]|string} position - 3 つの数値の配列 ([0,0,5])、数値を表す文字列の配列 ([‘0’,’0’,’5’])、またはコンマで区切られた 3 つの数値から成る 1 つの文字列 (‘0,0,5’) として指定される、必要な変換の位置成分。
• {number[]|string[]|string} rotation - 3 つの数値の配列 ([0,0,5])、数値を表す文字列の配列 ([‘0’,’0’,’5’])、またはコンマで区切られた 3 つの数値から成る 1 つの文字列 (‘0,0,5’) として指定される、必要な変換の回転成分。省略した場合、回転変換は適用されません。
• {number[]|string[]|string|number} scale - 3 つの数値の配列 ([0,0,5])、数値を表す文字列の配列 ([‘0’,’0’,’5’])、コンマで区切られた 3 つの数値から成る 1 つの文字列 (‘0,0,5’)、または均一のスケール係数を指定する 1 つの数値として指定される、必要な変換のスケール成分。省略した場合、スケール係数として 1 が使用されます。
指定した位置変換、回転変換、スケール変換が行われ、元の境界ボックスを囲む軸平行境界ボックスを表す新しい境界オブジェクトを返します。
元の境界オブジェクトはこの操作によって変更されません。
例:
PTC.Structure.fromId(‘model-1’).then( (structure) => {
    var bounds = structure.getBounds(‘/0/6’); 
    var rotated_bounds = bounds.transform([0,0,0], [45, 0, 0], 1);
}
Structure.Location オブジェクト
Structure.Location オブジェクトは、位置 (直線移動オフセット) と回転 (回転方向) から成る 3D 空間内の位置を表します。
Structure.Location オブジェクトプロパティ
プロパティ
説明
matrix
列-主配列として表される位置を示す 4x4 変換行列。
position
プロパティ x、y、z を持つオブジェクトとして表される位置の位置成分と、これら 3 つの値を配列として返す 'asArray' メソッド。
例:
PTC.Structure.fromId(‘model-1’).then( (structure) => {
    var location = structure.getLocation(‘/0/6’);
    var pos_X = location.position.x;
}
rotation
位置の回転成分。回転オブジェクトとして表されます。
例:
PTC.Structure.fromId(‘model-1’).then( (structure) => {
    var location = structure.getLocation(‘/0/6’);
    var rot = location.rotation;
}
Structure.Location オブジェクト関数
宣言
パラメータ
説明
transform (位置、回転、スケール)
• {number[]|string[]|string} position - 3 つの数値の配列 ([0,0,5])、数値を表す文字列の配列 ([‘0’,’0’,’5’])、またはコンマで区切られた 3 つの数値から成る 1 つの文字列 (‘0,0,5’) として指定される、必要な変換の位置成分。
• {number[]|string[]|string} rotation - 3 つの数値の配列 ([0,0,5])、数値を表す文字列の配列 ([‘0’,’0’,’5’])、またはコンマで区切られた 3 つの数値から成る 1 つの文字列 (‘0,0,5’) として指定される、必要な変換の回転成分。省略した場合、回転変換は適用されません。
• {number[]|string[]|string|number} scale - 3 つの数値の配列 ([0,0,5])、数値を表す文字列の配列 ([‘0’,’0’,’5’])、コンマで区切られた 3 つの数値から成る 1 つの文字列 (‘0,0,5’)、または均一のスケール係数を指定する 1 つの数値として指定される、必要な変換のスケール成分。省略した場合、スケール係数として 1 が使用されます。
指定した位置変換、回転変換、スケール変換が行われ、元の位置を表す新しい位置オブジェクトを返します。
元の位置オブジェクトはこの操作によって変更されません。
例:
PTC.Structure.fromId(‘model-1’).then( (structure) => {
    var location = structure.getLocation(‘/0/6’); 
    var moved_location = location.transform([5,0,0], [0, 0, 0], 1);
}
Structure.Rotation オブジェクトプロパティ
Structure.Rotation オブジェクトは 3D 空間での回転または回転方向を表します。
Structure.Rotation オブジェクト
プロパティ
説明
matrix
列-主配列として表される回転を示す 3x3 回転行列。
Structure.Rotation オブジェクト関数
宣言
パラメータ
説明
asEuler ()
回転のオイラー表示を取得します。これは、プロパティ x、y、z を持つオブジェクトとして表され、これら 3 つの値を配列として返す asArray メソッドです。値は角度です。
例:
PTC.Structure.fromId(‘model-1’).then( (structure) => {
    var location = structure.getLocation(‘/0/6’);
    var euler_array = location.rotation.asEuler().asArray();
}
使用例
// Get the Structure information for model-1
  PTC.Structure.fromId('model-1').then ( (structure) => {
      // Get the properties of the 'model-1' widget
      var widgetProps = $scope.view.wdg['model-1'];
    
      // Get the bounding box information for part '/0/6'
      var bbox = structure.getBounds('/0/6');
    
      // Transform the bounding box to account for the 'model-1' widget's location
      var xform_bbox = bbox.transform(
          [widgetProps.x, widgetProps.y, widgetProps.z],
          [widgetProps.rx, widgetProps.ry, widgetProps.rz],
          widgetProps.scale);
      // Move '3DImage-1' to the center of the bounding box
      $scope.view.wdg['3DImage-1'].x = xform_bbox.center.x;
      $scope.view.wdg['3DImage-1'].y = xform_bbox.center.y; 
      $scope.view.wdg['3DImage-1'].z = xform_bbox.center.z;
      // Get the location information for part '/0/2/8'
      var loc = structure.getLocation('/0/2/8');
    
      // Transform the location to account for the 'model-1' widget's location
      var xform_loc = loc.transform(
          [widgetProps.x, widgetProps.y, widgetProps.z],
          [widgetProps.rx, widgetProps.ry, widgetProps.rz],
          widgetProps.scale);
    
      // Get the rotational component as euler angles
      var rot = xform_loc.rotation.asEuler();
    
      // Rotate '3DImage-2' to match the rotation
      $scope.view.wdg['3DImage-2'].rx = rot.x;
      $scope.view.wdg['3DImage-2'].ry = rot.y; 
      $scope.view.wdg['3DImage-2'].rz = rot.z;
  });
これは役に立ちましたか?