<     > 

AddMember (Group)

Introduced

5.0

Description

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

Group.AddMember( NewMember, [BranchMember] )

C# Syntax

Boolean Group.AddMember( Object in_member, Boolean in_bBranchMember );

Parameters

Return Value

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

Examples

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

Autodesk Softimage v7.5     <     >