Animation Groups

Create an Animation Group

Create a more complex animated sequence in a scene with Animation Groups. Multiple animations are grouped and can run simultaneously.

Create a new animation group using the menu item "New Animation Group" from the Animation menu.

Created animation groups are displayed in the Solution Explorer panel like that:

Edited an animation group in the Animation Design view, with the Animation Timeline Editor. Drag animations from the Solution Explorer and drop them to the AnimationGroup in the Animation Timeline Editor. Another possibility is to use the "Add to Animation Group" option which is available in the context menu of every existing animation.

It is possible to select and drag simultaneously many animations into an animation group. When doing this operation, the user will be asked through the "Drop Animations" dialog if an animation chain has to be created.

You can also add both animations and animation groups to a specific animation group.

The main animation group is considered as the "root" and the group included inside as the "node".

It is not possible to include an animation group into another group, if it contains same animations as the root group.

Control Node Animations

TheseControl animations are displayed in "LocalControl animations" category in the Animation combo box (in the toolbar).

In the Solution Explorer there are two available commands to add items to an animation group. InRight-click thison wayan anyanimation confusionsgroup isoffers avoided.the following possibilities in the context menu. The name of these command are self-explanatory:

When adding animations to the selected Animation Group, "Choose Item" dialog also displays control animations, for each control. It may display also nested control animations that are made available.

The following types of animations can be included in an Animation Group:

• animations on nodes included in solution scenes; 
  
• animations from folders; 
  
• animations of controls which belong to at least one scene (if the control contains other controls, then the animations of the child control are also available). 
  

It does not allow selection of : FBX animations, animations already included, groups containing already included animations, animations of controls which do not belong to any scene.

The functionality of adding animations to an animation group allows multiple selection of: animations & animation groups

After a control animation is added, it behaves aslike any animation node. It inherits the "Delay" property and the "Startup"StartType" propertiesproperty (startupif applicable.

The AnimationGroup panel displays the full name of the animations and short version of the control animations:

Categories 

Animation Section in the Properties Panel

For animations specific properties, an Animation section is available directly after the General section in the Properties panel.

The Animation properties for a normalregular animation (inside an animation group) areis organizedasorganized as follows:

• "Delay"Delay: If a component has a delay defined and "Startup"its arepredecessor movedis started/finished, it will not be automatically started, but prepared for start.

StartType: A component with a predecessor can be configured to astart separatewith categoryits calledpredecessor "Animation",or whichafter it is displayedfinished. after "General"; 
A read-onlyThis property is available,only "Animation"available whichif a predecessor (parent animation) is defined (this means, if the animation is a child animation). Animation: displays the name of the node animation.animation
(read-only property).

Categories

The Animation properties for a control animationsanimation (inside an animation group) are similar to the one above. Other read-only properties are available:

• Control AnimationAnimation: – theThe template animation; 
  
• Animated control nodenode: – theThe control node that is animated by this animation node; 
  
• ChainChain. – theThe template items for the animated control nodes, the nested control nodes and the control animations. 

---

Simultaneous or Consecutive Animations

When a group with multiple animations is addedAnimations inside an animation group, can be arranged hierarchically: An animation can be configured to be the "child" of another animation group,simply anyby dragging the "child" animation fromonto the former"parent" oneanimation in the Animation Timeline panel. The relation (child or parent) will be reflected by proper indeting of the animation titles in the Animation Timeline panel. A "parent" animation is the predecessor of its "child" animation.

Every animation that has a "parent" animation, has a property StartType in the Properties panel (Animation part).
The StartType property can be setconfigured for animations with a predecessor, defining the animation to start simultaneously with its predecessor or not withafter the previouspredecessing node.animation is finished.

The optionpossible which allows this setting is called "Start Type". Select it from the context menuvalues of theStartType specific animation or in the Properties panel.are

By

selectingWithPrevious: "With previous" option theThe animation will start simultaneously with the node.predecessing Byanimation. selectingAfterPrevious: "After previous" option theThe animation will start after the nodepredecessing animation is done.

StartType Toggle Button Indicator

In the animation timeline in the left in the following picture, you can see that "Animation1" is the child animation of "PreceedingAnimation". In the Properties panel on the right, you can see the StartType property highlighted.

To easily toggle the StartType for the animation, the Animation Timeline provides a button, that also indicates the current configuration. It is highlighted in orange in the picture above.

  WithPrevious

  AfterPrevious

Limitations of Animation Groups

Compared to AnimationPlayer, AnimationGroupPlayer does not have the following functions

• Specify the start time of the animation and the length of the animation
• Loop playback
• Reverse playback
• Speedup animation(a new feature available in CGI-Studio 3.9 or later)
• Jump to a specific point