What's New in Director 8.5 > Working with Models and Model Resources > Groups > Group properties

 

Group properties

The properties of the group determine its particular appearance and relationship to the rest of the 3D world.

Use these properties to work with groups:

Property

Access

Description

Value

name

Get

Unique string name.

Any string.

parent

Get and set

This group's parent; either another object or the 3D cast member itself.

An object or cast member.

child.count

Get

Number of children (but not grandchildren) of a given group.

An integer.

transform

Get and set

Lingo transform object representing this group's position and orientation relative to its parent's position and orientation.

transform.position gives the relative position.

transform.rotation gives the relative rotation.

Set: a transform object.

Get: reference to a transform object.

userData

Get and set

A property list containing all properties assigned to the group. Users can add, remove, get, and set properties on this list.

The default list includes the properties assigned in the 3D modeling tool. User properties are then added.

boundingSphere

Get

A list containing a vector and a floating-point value. The vector represents the position of the group in world space. The floating-point value represents the radius of the bounding sphere that contains the group and its children.

A list, with the default value of [vector(0,0,0), 0.0].

worldPosition

Get

Position of the group in world coordinates. A quick shortcut for group.getWorldTransform(). ¬ position

A vector object.

pointAtOrientation

Get and set

A list of two orthogonal vectors, [objectRelativeDirection, objectRelativeUp], that control how the groups pointAt() method works.

A vector list.