<?xml version='1.0' encoding='UTF-8' ?>
<!DOCTYPE html
  SYSTEM "about:legacy-compat">
<html xmlns:mml = "http://www.w3.org/1998/Math/MathML" lang = "en"><head><meta charset = "UTF-8"/><meta name = "copyright" content = "(C) Copyright 2020"/><meta name = "DC.rights.owner" content = "(C) Copyright 2020"/><meta name = "DC.type" content = "reference"/><meta name = "abstract" content = "The Animation Library workshop lets you create simple animations quickly, using a library of pre-defined, generic animations."/><meta name = "description" content = "The Animation Library workshop lets you create simple animations quickly, using a library of pre-defined, generic animations."/><meta name = "DC.relation" scheme = "URI" content = "cps-c-Animations.htm#cps-c-Animations"/><meta name = "DC.relation" scheme = "URI" content = "cps-t-Animations.htm#cps-t-Animations"/><meta name = "DC.format" content = "HTML5"/><meta name = "DC.identifier" content = "cps-r-Workshops-AnimationLibrary"/><meta name = "DC.language" content = "en"/><link rel = "stylesheet" type = "text/css" href = "../DSDocUI_XML34.css"/><title>Animation Library Workshop</title>
<script type = "text/javascript" src = "../DSDocUI_Highlight34.js">
  	/* */
  	</script></head><body onLoad = "highlightSearchTerms();" id = "cps-r-Workshops-AnimationLibrary">
<a name = "hj-top"> </a><table class = "table1" id = "table11"><tr><td><table class = "DocHeader"><tr><td class = "DocHeader1" colspan = "2"><h1>Animation Library Workshop</h1></td></tr><tr><td class = "DocHeader4" colspan = "2"/></tr><tr><td class = "DocHeader3"><table class = "DocHeaderIntro" id = "table12"><tr><td class = "Intro1Only"><p class = "header"><p class = "abstract"><span class = "shortdesc">The Animation Library workshop lets you create simple animations quickly, 
    using a library of pre-defined, generic animations.</span>
<p>Animations you create in the Animation Library are captured on the timeline.</p><p>
To display this workshop, click 
<span class = "ph menucascade"><span class = "ph uicontrol">Workshops</span><abbr title = "and then"> &gt; </abbr><span class = "ph uicontrol">Publishing</span><abbr title = "and then"> &gt; </abbr><span class = "ph uicontrol">Animation Library</span><abbr title = "and then"> &gt; </abbr><span class = "ph uicontrol">  <img class = "image" src = "../Icons3DVIA/I_CPSWorkshopsRibbon-AnimationLibrary.png"/> </span></span>.</p>
    
  <p>Select an actor, then the animation to apply to it, and then click <span class = "ph uicontrol">Create</span>.</p></p>
<p>This page discusses: </p><ul><li><a href = "#r-Templates" id = "toc_rg" title = "This area lets you specify which animation template to use for the selected actor or actors.">Templates</a></li><li><a href = "#r-Properties" id = "toc_rg" title = "For each motion of the animation, you can define camera properties, and customize motion properties.">Properties</a></li><li><a href = "#r-Overview" id = "toc_rg" title = "Provides a graphical overview of the chronology of motions in the animation, and of the global duration of the animation.">Overview</a></li></ul>
</p></td></tr></table></td><td class = "DocHeader2"><table class = "DocTopicsSeeAlso" id = "table13"><tr><td class = "TopicsTitle">See Also</td></tr><tr><td><a title = "Composer uses key-frame based animation, which lets you build animations by arranging actors and taking snapshots at moments in time, called key frames. A set of pre-defined, generic animations is provided with Composer to let you create simple animations quickly, via the Animation Library workshop. Users proficient in XML can create their own custom animations." href = "cps-c-Animations.htm#cps-c-Animations">About the Animation Library</a></td></tr><tr><td><a title = "You can create simple animations quickly, using a library of pre-defined animations. Once you have added several animations to your timeline, you can easily manage animation blocks." href = "cps-t-Animations.htm#cps-t-Animations">Creating Pre-defined Animations</a></td></tr></table></td></tr></table>
  

  

  <div class = "related-links"/>

  <article class = "topic reference nested1" aria-labelledby = "ariaid-title2" id = "r-Templates">
    <h2 class = "title topictitle2">Templates</h2>

    
    
    <div class = "body refbody"><p class = "abstract"><span class = "shortdesc">This area lets you specify which animation template to use for the selected actor or actors.
      </span>

      
    </p>

      <table class = "table frame-none"><caption/><colgroup><col style = "width:50%"/><col style = "width:50%"/></colgroup><thead class = "thead">
            <tr class = "row">
              <th class = "entry" id = "r-Templates__entry__1">
                Command Name
              </th>
              <th class = "entry" id = "r-Templates__entry__2">Description
              </th>
            </tr>
          </thead><tbody class = "tbody">
            <tr class = "row">
              <td class = "entry" headers = "r-Templates__entry__1">
                <span class = "ph uicontrol">Group
              </span></td>
              <td class = "entry" headers = "r-Templates__entry__2">Specifies the group of animation templates in which to select an animation. Pre-defined groups are <span class = "ph uicontrol">Highlight</span> and <span class = "ph uicontrol">Motion</span>. If some custom groups of animation templates are available in your animation library (on your Composer user profile), they are  listed here. See <a class = "xref" href = "cps-c-Animations.htm#c-CustomAnimations" title = "You can consider creating your own custom animation groups and animations, provided that you are proficient in XML.">Custom Animations</a>.</td>
            </tr>
            <tr class = "row">
              <td class = "entry" headers = "r-Templates__entry__1"><span class = "ph uicontrol">Animation</span></td>
              <td class = "entry" headers = "r-Templates__entry__2">Specifies the animation to use (from the selected group of animation templates). For pre-defined groups, available animations are:<ul class = "ul"><li class = "li">For the <span class = "ph uicontrol">Highlight</span> group: <span class = "ph uicontrol">Enhance</span>, <span class = "ph uicontrol">Focus</span>, <span class = "ph uicontrol">Validated</span>, <span class = "ph uicontrol">Warning</span>.</li><li class = "li">For the <span class = "ph uicontrol">Motion</span> group: <span class = "ph uicontrol">Install</span>, <span class = "ph uicontrol">Remove</span>, <span class = "ph uicontrol">Roll</span>, <span class = "ph uicontrol">Screw</span>,
<span class = "ph uicontrol">Unscrew</span>, <span class = "ph uicontrol">Untighten</span>.</li></ul></td>
            </tr><tr class = "row"><td class = "entry" headers = "r-Templates__entry__1"><span class = "ph uicontrol">Create</span></td><td class = "entry" headers = "r-Templates__entry__2">Creates the animation for the selected actors. Make sure that you have edited the animation properties, if required, before clicking this button.</td></tr><tr class = "row"><td class = "entry" headers = "r-Templates__entry__1"><span class = "ph uicontrol">Update Motion</span></td><td class = "entry" headers = "r-Templates__entry__2">Updates the properties of a single animation block currently selected in the timeline.  </td></tr><tr class = "row"><td class = "entry" headers = "r-Templates__entry__1"><span class = "ph uicontrol">Update Selection</span></td><td class = "entry" headers = "r-Templates__entry__2">Updates the properties of a single animation block currently selected in the timeline. Use this command to add actors to, delete actors from, or replace actors in the step/pre-defined motion.</td></tr>
            
          </tbody></table>
      
      
      
      
    </div>

  </article>

  <article class = "topic reference nested1" aria-labelledby = "ariaid-title3" id = "r-Properties">
    <p><map name = "FPMap1"><area href = "#hj-top" title = "Back to Top" shape = "rect" coords = "416, 0, 435, 10"/></map><span class = "itemsprite"/></p><h2 class = "title topictitle2">Properties</h2>

    
    
    <div class = "body refbody"><p class = "abstract"><span class = "shortdesc">For each motion of the animation, you can define camera properties, and customize motion properties.</span>

      
    </p>

      <div class = "section" id = "r-Properties__rs-CameraProperties"><h3 class = "title sectiontitle">Camera Properties</h3><p>You can  create camera keys in animation blocks, at the start and end of the step. This is helpful to define the behavior of the camera throughout the step.<div class = "notes collapse"><span class = "run-in.notes">Notes:
    		</span><span class = "notecontent"><ul class = "ul"><li class = "li">You can update the camera properties of an existing animation block that has no camera keys, after selecting the corresponding step on the timeline.</li><li class = "li">Camera properties can be only be applied to a single animation block at once. These options are disabled when several steps are selected in the timeline.</li></ul></span></div>
</p><table class = "table"><caption/><colgroup><col style = "width:50%"/><col style = "width:50%"/></colgroup><thead class = "thead"><tr class = "row"><th class = "entry" id = "r-Properties__rs-CameraProperties__entry__1">Camera Centering Mode</th><th class = "entry" id = "r-Properties__rs-CameraProperties__entry__2">Description</th></tr></thead><tbody class = "tbody"><tr class = "row"><td class = "entry" headers = "r-Properties__rs-CameraProperties__entry__1"><span class = "ph uicontrol">Auto Centering</span></td><td class = "entry" headers = "r-Properties__rs-CameraProperties__entry__2">Inserts camera keys at the start and at the end of the step. Throughout the step, the camera remains centered according to the actors involved in the step, zooming in or out to take into account the entire motion. This ensures that the entire motion remains visible at all times throughout the step.<p>If you later modify the step in such a way that it has an impact on the camera, the camera keys will be updated accordingly.</p><div class = "note"><span class = "run-in.note">Note:
			</span><span class = "notecontent">This mode only influences the zoom factor. The camera orientation does not change.</span></div>
</td></tr><tr class = "row"><td class = "entry" headers = "r-Properties__rs-CameraProperties__entry__1"><span class = "ph uicontrol">Manual Centering</span></td><td class = "entry" headers = "r-Properties__rs-CameraProperties__entry__2">Inserts camera keys at the start and at the end of the step, based on the orientation and zoom factor of the camera on the viewport. Throughout the step, you are free to change this orientation and zoom factor.</td></tr><tr class = "row"><td class = "entry" headers = "r-Properties__rs-CameraProperties__entry__1"><span class = "ph uicontrol">None (No Centering)</span></td><td class = "entry" headers = "r-Properties__rs-CameraProperties__entry__2">No camera keys are created. <div class = "note"><span class = "run-in.note">Note:
			</span><span class = "notecontent">If you select this mode for a step with existing camera keys, they are removed.</span></div>
</td></tr></tbody></table></div>
<div class = "section" id = "r-Properties__rs-MotionProperties"><h3 class = "title sectiontitle">Motion Properties</h3><p>An animation is composed of different motions. This area lets you customize the properties of each motion of the selected animation. All motion properties have a start time, an end-time, and other parameters.<div class = "note"><span class = "run-in.note">Note:
			</span><span class = "notecontent">The properties listed below are all existing properties. All motions have different properties, and therefore, the available properties depend on the animation you selected.</span></div>
</p><table class = "table frame-none"><caption/><colgroup><col style = "width:50%"/><col style = "width:50%"/></colgroup><thead class = "thead">
            <tr class = "row">
              <th class = "entry" id = "r-Properties__rs-MotionProperties__entry__1">
                Motion Property Category
              </th>
              <th class = "entry" id = "r-Properties__rs-MotionProperties__entry__2">
                Parameters
               (other than Start Time and End Time)</th>
            </tr>
          </thead><tbody class = "tbody">
            <tr class = "row">
              <td class = "entry" headers = "r-Properties__rs-MotionProperties__entry__1">
                <span class = "ph uicontrol">DisplayImage</span>: Displays an image in the viewport, at a specified location.
              </td>
              <td class = "entry" headers = "r-Properties__rs-MotionProperties__entry__2"><ul class = "ul"><li class = "li"><span class = "ph uicontrol">Top</span>: Distance of image from the top of the viewport</li><li class = "li"><span class = "ph uicontrol">Left</span>: Distance of image from the left of the viewport</li><li class = "li"><span class = "ph uicontrol">Size</span>: Image size (with locked aspect ratio)</li><li class = "li"><span class = "ph uicontrol">Picture</span>: Image path</li></ul></td>
            </tr>
            <tr class = "row">
              <td class = "entry" headers = "r-Properties__rs-MotionProperties__entry__1"><span class = "ph uicontrol">DisplayText</span>: Displays a text panel in the viewport, at a specified location.</td>
              <td class = "entry" headers = "r-Properties__rs-MotionProperties__entry__2"><ul class = "ul"><li class = "li"><span class = "ph uicontrol">Top</span>: Distance of image from the top of the viewport</li><li class = "li"><span class = "ph uicontrol">Left</span>: Distance of image from the left of the viewport</li><li class = "li"><span class = "ph uicontrol">Text</span>: Text to display</li><li class = "li"><span class = "ph uicontrol">Font Size</span>: Size of the font to use for the text</li><li class = "li"><span class = "ph uicontrol">Font Family</span>: Family of the font to use for the text</li><li class = "li"><span class = "ph uicontrol">Font Color</span>: Color of the font to use for the text</li><li class = "li"><span class = "ph uicontrol">Background Color</span>: Color to use in the text background</li></ul></td>
            </tr>
            <tr class = "row">
              <td class = "entry" headers = "r-Properties__rs-MotionProperties__entry__1"><span class = "ph uicontrol">Flash</span>: Highlights selected actors.</td>
              <td class = "entry" headers = "r-Properties__rs-MotionProperties__entry__2"><ul class = "ul"><li class = "li"><span class = "ph uicontrol">Color</span>: Color to use when flashing (can be set to Undefined)</li><li class = "li"><span class = "ph uicontrol">Intensity</span>: Intensity of the emission</li><li class = "li"><span class = "ph uicontrol">Repetition</span>: Number of times to flash</li></ul></td>
            </tr><tr class = "row"><td class = "entry" headers = "r-Properties__rs-MotionProperties__entry__1"><span class = "ph uicontrol">Rotate</span>: Rotates selected actors.</td><td class = "entry" headers = "r-Properties__rs-MotionProperties__entry__2"><ul class = "ul"><li class = "li"><span class = "ph uicontrol">Axis (X, Y, Z)</span>: Rotation axis. <span class = "ph">Instead of entering the values, you can click <span class = "ph uicontrol">Pick</span> to select the position in the viewport. You can use Alt to pick the center of an axis, and Shift to revert the picked axis.</span></li><li class = "li"><span class = "ph uicontrol">Angle</span>: Rotation angle</li></ul></td></tr><tr class = "row"><td class = "entry" headers = "r-Properties__rs-MotionProperties__entry__1"><span class = "ph uicontrol">Scale</span>: Re-scales selected actors from the pivot origin.</td><td class = "entry" headers = "r-Properties__rs-MotionProperties__entry__2"><ul class = "ul"><li class = "li"><span class = "ph uicontrol">Scale Ratio</span>: Scale ratio of selected actor</li><li class = "li"><span class = "ph uicontrol">Repetition</span>: Number of times to apply scale ratio to selected actor</li></ul><div class = "notes collapse"><span class = "run-in.notes">Notes:
    		</span><span class = "notecontent"><p>- The pivot definition must not be animated in the time. Define the pivot of the object at time 0, before the step.</p><p>- The step can be applied on a
  selection of actors. The selected actors must not have any parenting relation
  (otherwise, if a child actor and its parent actor are both animated by a Scale
  or Translate motion, the child actor will move twice, once throught its
  parent's motion, once through its own motion).
</p></span></div>
</td></tr><tr class = "row"><td class = "entry" headers = "r-Properties__rs-MotionProperties__entry__1"><span class = "ph uicontrol">SetColor</span>: Changes the color of the selected actors.</td><td class = "entry" headers = "r-Properties__rs-MotionProperties__entry__2"><ul class = "ul"><li class = "li"><span class = "ph uicontrol">Color</span>: Color of selected actor during animation (can be set to Undefined)</li></ul></td></tr><tr class = "row"><td class = "entry" headers = "r-Properties__rs-MotionProperties__entry__1"><span class = "ph uicontrol">SetTransparency</span>: Changes the opacity of the selected actors.</td><td class = "entry" headers = "r-Properties__rs-MotionProperties__entry__2"><ul class = "ul"><li class = "li"><span class = "ph uicontrol">Transparency</span>: Opacity of selected actor during animation</li></ul></td></tr><tr class = "row"><td class = "entry" headers = "r-Properties__rs-MotionProperties__entry__1"><span class = "ph uicontrol">Transform</span>: Moves the selected actors freely.</td><td class = "entry" headers = "r-Properties__rs-MotionProperties__entry__2"><ul class = "ul"><li class = "li"><span class = "ph uicontrol">Position (X, Y, Z)</span>: Final position of selected actor. <span class = "ph">Instead of entering the values, you can click <span class = "ph uicontrol">Pick</span> to select the position in the viewport. You can use Alt to pick the center of an axis, and Shift to revert the picked axis.</span></li></ul></td></tr><tr class = "row"><td class = "entry" headers = "r-Properties__rs-MotionProperties__entry__1"><span class = "ph uicontrol">Translate</span>: Translates the selected actors.</td><td class = "entry" headers = "r-Properties__rs-MotionProperties__entry__2"><ul class = "ul"><li class = "li"><span class = "ph uicontrol">Axis (X, Y, Z)</span>: Translation axis, that is the normalized vector along which the translation is applied. <p>Click <span class = "ph uicontrol">Pick Axis</span> to select the axis in the 3D. </p><p>Click <span class = "ph uicontrol">Pick Point</span> to select a  point in the 3D. This calculates a vector in the world coordinate system, between this point and the origin of the pivot of the selected actor or actors.<div class = "notes collapse"><span class = "run-in.notes">Notes:
    		</span><span class = "notecontent"><p> - If several actors are selected, and if all actors have the same origin, then the common pivot  origin is used. Otherwise, the center of the bounding box is used.</p><p>- The pivot definition must not be animated in the time. Define the pivot of the object at time 0, before the step.</p><p>- The step can be applied on a
  selection of actors. The selected actors must not have any parenting relation
  (otherwise, if a child actor and its parent actor are both animated by a Scale
  or Translate motion, the child actor will move twice, once throught its
  parent's motion, once through its own motion).
</p></span></div>
</p></li><li class = "li"><span class = "ph uicontrol">Distance</span>: Translation distance</li></ul></td></tr>
          </tbody></table></div>

    </div>

  </article>
<article class = "topic reference nested1" aria-labelledby = "ariaid-title4" id = "r-Overview"><p><map name = "FPMap1"><area href = "#hj-top" title = "Back to Top" shape = "rect" coords = "416, 0, 435, 10"/></map><span class = "itemsprite"/></p><h2 class = "title topictitle2">Overview</h2>

<div class = "body refbody"><p class = "abstract"><span class = "shortdesc">Provides a graphical overview of the chronology of motions in the animation, and of the global duration of the animation.</span>
<br/><img class = "image" src = "../CpsUserImages/Animations-Overview.png"/><br/></p>
</div>
</article></td></tr></table><script type = "text/javascript" src = "../DSDocUI_Bottom34.js">/* */</script></body>
</html>
