<Group> Data Interface

Provides script language access to C++ objects of this type.

Class HierarchyType » Node » Group

Function Members

Function members are as follows:

Return Type Function Name Documentation
int32AddChildAdds a child <Node> to a <Group>.
int32ChildCountByTypeReturns the count of child <Node> objects of the specified type.
int32ChildrenAreAllTypeReturns true if all child <Node> objects are the type specified.
int32ClearTransformResets to zero the position and orientation and resets to 1 the scale.
int32CloneChildrenToBufferClones the child <Node> objects and transfers ownership of them to the specified <NodeBuffer>.
int32DeleteAllChildrenDeletes all child <Node> objects from a <Group>. After the function returns, any dependencies on child <Node> objects will have been cleared.
int32DeleteChildDeletes a child <Node> from a <Group>. Clears any dependencies on the <Node> and then frees the memory allocated for the <Node>.
<Node>FindChildFinds a child by name and type. A <Node> object indicates success, nullptr indicates failure.
<Node>FindChildByNameTraverseTraverses the hierarchy below this <Group> and finds the first child that matches the name and type values submitted to this function.
<Node>FindChildTraversePerforms a breadth-first search using this <Group> as the search root, and returns the first child of the specified type. Returns a <Node> pointer that must be cast to the expected type.
<Node>FirstChildReturns a pointer to the first child, or nullptr if this <Node> has no children.
<Node>FirstChildFromSetOfTypesReturns a pointer to the first child <Node> that matches any of the types in the <TypeInfoArray> submitted to this function.
<Node>GetChildReturns a pointer to the first child whose name matches the string submitted to this function. Returns nullptr if no match exist.
<Node>GetChildByTypeSearches a <Group> node object's child list for a <Node> of the specified type. If there are more than one <Node> objects of the specified type, only the first <Node> is found.
int32GetChildIndexReturns the index of a <Node> in its parent's child list.
<NodeList>GetChildListReturns a pointer to the <NodeList>> object that stores this <Group> node object's children. Please note that changes made to a <Node> via this direct accessor cannot be undone.
int32GetChildTraverseUsing the <Node> submitted to this function as the root, performs a breadth-first search and populates a <List> object with all the <Node> objects of the indicated type. Optionally, this function can clone the child <Node> objects and transfer ownership of them to the <List>.
int32GetDegreeByTypeReturns the child count of the specified type.
<Node>GetNodeByPathSearches a <Group> and its child hierarchy for a <Node> using a specified path.
<Vec>GetOrientationAllocates a <Vec> object via new and returns a pointer to the object. This object contains the group's orientation. The caller is responsible for the allocation.
<Vec>GetPositionAllocates a <Vec> object via new and returns a pointer to the object. This object contains the group's position. The caller is responsible for the allocation.
<Vec>GetScaleAllocates a <Vec> object via new and returns a pointer to the object. This object contains the group's scale. The caller is responsible for the allocation.
<Matrix>GetTransformReturns a pointer to a matrix object containing the <Group> node object's transformation parameters.
<Matrix>GetTransformToGroupFills a matrix with the values required to transform a coordinate from the source <Group> to the destination <Group>.
<Node>GetTypedNodeByPathSearches a <Group> and its child hierarchy for a <Node> using a specified path.
<NodeBuffer>GetViewOfDerivedTypeReturns a pointer to a <NodeBuffer> object that contains all the child nodes that are derived from the specified type, or, optionally, any child nodes derived from the specified type, and that are reachable by traversing any hierarchy below the node.
<NodeBuffer>GetViewOfTypeReturns a pointer to a <NodeBuffer> object that contains all the child nodes that exactly match the specified type, or, optionally, any child nodes that exactly match the specified type, and that are reachable by traversing any hierarchy below the node.
int32InsertChildInserts a <Node> into a <Group> at the specified child index.
int32InvalidateExtentInvalidates the extent data stored in the <Group>. The <Group> recalculates the extent on demand.
int32IsomorphicByTypeReturns true if GroupB is isomorphic to this <Group> node with respect to child count and child type.
<Node>LastChildReturns a pointer to the last child of a <Group>, or nullptr if the <Group> node object's child list is empty.
int32PopulateBufferPopulates a <NodeBuffer> with non-owning pointers to the <Group> node object's children of the specified type.
int32SetOrientationSets the <Group> node object's orientation to the values in the specified <Vec> object.
int32SetPOSSets the <Group> node object's position, orientation, and scale transformation.
int32SetPositionSets the <Group> node object's position to the values in the specified <Vec> object.
int32SetScaleSets the <Group> node object's position to the values in the specified <Vec> object.
int32SetTransformSets the position, orientation, and scale for a <Group>.
int32SizeOfReturns the size in bytes of this <Group>.
int32SortChildrenThis option is undocumented at present.
<Node>TransferFromListPopulates a <Group> with any <Node> objects resident in the <List> object. The <List> must be the sole owner of these <Node> objects or the application will crash.
<Matrix>TransformPointToGroupTransforms a coordinate from one <Group> to another.
int32TypeAtIndexReturns true if the type at the specified index matches the specified type information.

Object Members

Object members are as follows:

Type Name Accessor Name Documentation
int32BillboardSets the Billboard flag for a <Group>.
int32BoundFrozenGets or sets the Freeze flag for a <Group>.
double[]BoundMax[ index ]Gets or sets the maximum values on X, Y, and Z for the bounding box extents.
double[]BoundMin[ index ]Gets or sets the minimum values on X, Y, and Z for the bounding box extents.
int32ChildCountReturns the child count for a <Group>.
Node[]Children[ index ]This member is an array of the <Group> node object's children. Accessor syntax: <Group>.Children[ n ].
int32CollisionsGets or sets the Collisions flag for a <Group>.
int32CullGets or sets the Cull flag for a <Group>.
int32HiddenGets or sets the Hidden flag for a <Group>.
int32LockedGets or sets the Locked flag for a <Group>.
<Node>ParameterGroupGets or sets the <Group> node object's ParameterGroup, which can be any <Node> in the local document. This allows you to form relationships between a <Group> and any other <Node> in the document in a way that suits your purpose.
int32VisibleGets or sets the Visible flag for a <Group>.