RemoveTransformGr oup

Introduced

5.0

Description

Removes all transform groups specified in the input list. Children of the transform group are reparented under the parent of the transform group. The global positions of the children remain unchanged when the transform group is removed.

Scripting Syntax

    RemoveTransformGroup( [InputObjs] )

Parameters

Parameter | Type | Description
InputObjs | String | List of transform groups to remove. Default Value: Selected objects

Examples

JScript Example

    /*
       This example will transform group a cone twice, making a hierarchy 3 objects deep.
       Each object will be offset by 5 units in Y. Then the transform groups will both be
       removed using RemoveTransformGroup Note the cone's position remains unchanged when
       removing the groups.
    */

    // 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");
    oXfmGroup.LocalTranslation = pos;
    var oXfmGroup2 = CreateTransformGroup(null, "cone");
    oXfmGroup2.LocalTranslation = pos;

    var oGroupColl = new ActiveXObject("XSI.Collection");
    oGroupColl.Add(oXfmGroup);
    oGroupColl.Add(oXfmGroup2);

    RemoveTransformGroup( oGroupColl );

See Also

CreateTransformGroup

Autodesk Softimage v7.5