What's New in Director 8.5 > The 3D Cast Member > Groups

 

Groups

Groups are collections of models and other objects that have been formally associated with one another. These associations can be created in your 3D modeling software or with Lingo. Each 3D cast member has a default group called world, which is the cast member itself.

Groups simplify the rotation and translation of models by allowing all members of a group to be moved together with a single command. A group has a name, a transform, and a parent, and can also have children. It has no other properties.

The following commands and properties can be used to perform basic group operations:

Command

Function

Returns

group.count

Returns the number of group objects included in the cast member.

Integer.

group(name)

Returns the group named name.

Returns the group object named name if it exists. Returns void if the object does not exist.

group[index]

Returns the group at the designated position in the index. The index number can change if groups are added or deleted.

Returns the group object at that index number if it exists. Returns void if the object does not exist at that index number.

newGroup(name)

Creates a new group and adds it to the group object list.

Returns a new group object with a unique name. If the name isn't unique, returns a Lingo error.

deleteGroup(name)

Deletes the group named name. Lingo references to this group persist but can do nothing.

TRUE (1) if the group named name exists. FALSE (0) if the group named name doesn't exist.

deleteGroup[index]

Deletes the group with the given index number. Lingo references to this group persist but can do nothing.

TRUE (1) if the group with this index number exists. FALSE (0) if the group with this index number doesn't exist.