CreateTransformGroup

導入

v5.0

詳細

入力リストのオブジェクトを変換グループ オブジェクトの子にします。 変換グループは、多数のオブジェクトをグループ変換の子にすることができる特殊なヌルです。 デフォルトでは変換グループは表示されません。 変換グループを表示するには、[カメラの表示/非表示] > [オブジェクト] > [コントロール オブジェクト] > [変換グループ]を選択します。 転送グループは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