Adds members to a group.

You can add objects in branch mode, so that properties assigned to the group are inherited by the objects and their children. For example, if you have a hierarchy A->B->C and you add object A to a group in branch mode, then any material assigned to the group applies not only to A but also to B and C.

You can use Group.IsMember to check if an object is a branch member of a group. To change the branch setting of a group member, you have to remove the object and then add it back to the group.

Note: Use AddToPartition to add members to a Partition Group.

Scripting Syntax

oBoolean = Group.AddMember( NewMember, [BranchMember] );

Return Value


True if the members were added successfully, and False otherwise.


Parameter Type Description
NewMember XSICollection or SceneItem Members to add.
BranchMember Boolean True to add objects in branch mode.

Default Value: False


JScript Example

NewScene(null, false );
var a = ActiveSceneRoot.AddGeometry( "Cube", "MeshSurface", "A");
a.length.value = 2;
var b = a.AddGeometry("Cube", "MeshSurface", "B");
b.length.value = 2;
Translate( b, 5 );
var c = b.AddGeometry("Cube", "MeshSurface", "C");
c.length.value = 2;
Translate( c, 5 );
// create group
var group = ActiveSceneRoot.AddGroup();
// add members to group
group.AddMember( a, true );
group.AddMember( b, false );
logmessage( "number of members : " + group.members.Count );
// determine which members were added in branch
for ( var i = 0; i < group.members.count; i++ )
        var member = group.members(i);
        var bBranchMember = group.members(i).BranchFlag ? "true" : "false";
        logmessage( member + " branch member " + bBranchMember );
logmessage( "Extended group members = " + group.expandedmembers.getastext() );
//INFO : number of members : 2
//INFO : A branch member true
//INFO : B branch member false
//INFO : Extended group members = A,B,C