CreateTransformGroup

導入

v5.0

カテゴリ

group

詳細

入力リストのオブジェクトを変換グループ オブジェクトの子にします。 変換グループは、多数のオブジェクトをグループ変換の子にすることができる特殊なヌルです。 デフォルトでは変換グループは表示されません。 変換グループを表示するには、[カメラの表示/非表示] > [オブジェクト] > [コントロール オブジェクト] > [変換グループ]を選択します。 転送グループは Group とは異なる点に注意してください。 変換グループとは異なり、グループは 3D オブジェクトであり、グループ メンバの親には影響しません。

このコマンドは、入力リスト内のすべてのオブジェクトのうち、共通の親に最も近いオブジェクトに変換グループのヌルを置きます。 入力オブジェクトが存在しない場合、変換グループはシーン ルートの下に配置されます。 コマンド ブランチは新しい変換グループを選択します。

注: ボーンには親子関係を設定できないため、転送グループには含められません。

スクリプト構文

oReturn = CreateTransformGroup( [Name], [InputObjs] );

戻り値

変換グループを戻します(X3DObject オブジェクト)。

パラメータ

パラメータ タイプ 詳細
Name 文字列 グループ名

デフォルト値: 「Group」

InputObjs 文字列 グループに配置するオブジェクトのリスト

デフォルト値: 選択されたオブジェクト

JScript の例

/*
        This example will transform group a cone twice, making a hierarchy 3 objects deep. 
        Each object will be offset by 5 units in Y.
*/
// Make transform groups visible in the camera view
SetValue("Camera.camvis.objctrltransfogroups", true, null);
// Create and position the cone
var oCone = CreatePrim("Cone", "MeshSurface");
var pos = XSIMath.CreateVector3();
pos.Set(0,5,0);
oCone.LocalTranslation = pos;
// Transform group the cone and offset the group 5 units in Y
var oXfmGroup = CreateTransformGroup(null, "cone");
LogMessage("---1st group created---");
LogMessage("1st group's parent:" + oXfmGroup.Parent);
LogMessage("1st group         :" + oXfmGroup.Name);
LogMessage("1st group's child :" + oXfmGroup.Children(0));
oXfmGroup.LocalTranslation = pos;
// Group the cone again offset the new group.
var oXfmGroup2 = CreateTransformGroup(null, "cone");
//Move the Transform Group up
oXfmGroup2.LocalTranslation = pos;
LogMessage("-----------------------");
LogMessage("---2nd group created---");
LogMessage("1st group's parent:" + oXfmGroup.Parent);
LogMessage("1st group         :" + oXfmGroup.Name);
LogMessage("1st group's child :" + oXfmGroup.Children(0));
LogMessage("-----------------------");
LogMessage("2nd group's parent:" + oXfmGroup2.Parent);
LogMessage("2nd group         :" + oXfmGroup2.Name);
LogMessage("2nd group's child :" + oXfmGroup2.Children(0));
/////////////////////////////////////
// Output from running this script:
/////////////////////////////////////
//INFO : ---1st group created---
//INFO : 1st group's parent:Scene_Root
//INFO : 1st group         :transfogroup
//INFO : 1st group's child :cone
//INFO : -----------------------
//INFO : ---2nd group created---
//INFO : 1st group's parent:Scene_Root
//INFO : 1st group         :transfogroup
//INFO : 1st group's child :transfogroup1
//INFO : -----------------------
//INFO : 2nd group's parent:transfogroup
//INFO : 2nd group         :transfogroup1
//INFO : 2nd group's child :cone

関連項目

RemoveTransformGroup