User Guide

Chapter 19496
Groups
Groups have many of the same properties and commands as models, except that you need to
substitute the word group for the word model when writing Lingo scripts. A group can contain
models, lights, cameras, or other groups.
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.
bounding
Sphere
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]
.
world
Position
Get Position of the group in world coordinates. A quick
shortcut for
group.getWorldTransform(). position
A vector object.
pointAt
Orientation
Get and set A list of two orthogonal vectors,
[objectRelativeDirection,
objectRelativeUp]
, that control how the
groups
pointAt() method works.
A vector list.