CreateTransformGroup
v5.0
Reparents the objects in the input list under a transform group
object. A transform group is a special type of null that allows you
to parent a number of objects for group transformations. Transform
groups are not visible by default. Transform groups can be made
visible in Camera Visibility > Objects > Control Objects >
Transform Groups. Note that a transform group is not the same as a
Group. Unlike transform groups,
groups are not 3D objects and do not affect the parenting of their
members.
This command positions a transform group null at the location of
the nearest common ancestor of all the objects in the input list.
If there are no input objects, the transform group will be placed
under the scene root. The command branch selects the new transform
group.
Note: Bones cannot be part of a transform group because they cannot
be reparented.
oReturn = CreateTransformGroup( [Name], [InputObjs] ); |
Returns the transform-group (an X3DObject object).
| Parameter | Type | Description |
|---|---|---|
| Name | String | Name of the group
Default Value: "Group" |
| InputObjs | String | List of objects to put in
the group.
Default Value: Selected objects |
/*
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
|