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

ControlThese animations are displayed in "ControlLocal animations" category in the Animation combo box (in the toolbar).

In the Solution Explorer thereThere are two available commands to add items to an animation group. Right-clickIn onthis anway animationany groupconfusions offersis the following possibilities in the context menu.avoided. 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 likeas any animation node. It inherits the "Delay" property and the"Startup" "StartType"properties property if applicable.

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

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 propertiesCategories for a regularnormal animation (inside an animation group) isare organized asorganizedas follows:

• Delay:"Delay" Ifand "Startup" are moved to a componentseparate hascategory acalled delay"Animation", defined and its predecessorwhich is started/finished,displayed itafter will"General"; not be automatically started, but prepared for start.
  
• StartType: A component with a predecessor can be configured to start with its predecessor or after it is finished. Thisread-only property is onlyavailable, available"Animation" if a predecessor (parent animation) is defined (this means, if the animation is a child animation).

Animation:which displays the name of the node animationanimation. (read-only property).

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

• Control Animation:Animation The– the template animation; 
  
• Animated control node:node The– the control node that is animated by this animation node; 
  
• Chain.Chain The– the template items for the animated control nodes, the nested control nodes and the control animations. 

---

Simultaneous or Consecutive Animations

AnimationsWhen a group with multiple animations is added inside ananother animation group, can be arranged hierarchically: Anany animation from the former one can be configuredset to bestart simultaneously or not with the previous node.

The option which allows this setting is called "child"Start ofType". anotherSelect animationit simply by draggingfrom the "child"context animation onto the "parent" animation in the Animation Timeline panel. The relation (child or parent) will be reflected by proper indetingmenu of the animation titles in the Animation Timeline panel. A "parent"specific animation is the predecessor of its "child" animation.

Every animation that has a "parent" animation, has a property StartTypeor in the Properties panel (Animation part).
The StartType property can be configured for animations with a predecessor, defining the animation to start simultaneously with its predecessor or after the predecessing animation is finished.

The possible values of StartType arepanel.

By

WithPrevious:selecting The"With previous" option the animation will start simultaneously with the predecessingnode. animation.By AfterPrevious:selecting The"After previous" option the animation will start after the predecessingnode 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