1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> 2<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en-US" lang="en-US"> 3 <head> 4 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> 5 <meta http-equiv="Content-Style-Type" content="text/css" /> 6 <title>Animation</title> 7 <link rel="stylesheet" href="../css/mainpage.css" type="text/css" /> 8 </head> 9 10 <body> 11 12<h1>Animation</h1> 13 14<h2>Animation Group Descriptor</h2> 15<p>Each collection of one type of animation is called an <I>animation group</I>, and the setting information for that group takes the form of the animation descriptor. The animation target attributes and blend operation names are output to <CODE><GraphicsAnimationGroupDescription></CODE>.<br> Models and other animation targets possess sets of groups. <br> Animations are stored as individual resources by saving them as separate groups in the file.</p> 16 17<h2>Animation descriptors listed under <Model> and <SkeletalModel> elements</h2> 18<h3>Skeletal animation</h3> 19<p>The following is a model with skeletal animation targeting all bones.</p> 20<pre> 21<GraphicsAnimationGroupDescription Name="SkeletalAnimation" EvaluationTiming="AfterSceneCulling"><br> 22 <MemberInformationSet><br> 23 <AnimationMemberDescription BlendOperationName="CalculatedTransform"><br> 24 <Path>Skeleton.Bones["*"].AnimatedTransform</Path><br> 25 </AnimationMemberDescription><br> 26 </MemberInformationSet><br> 27</GraphicsAnimationGroupDescription><br> 28</pre> 29<p>If the animation target was only the one bone named <I>Bone1</I>, the <CODE><Path></CODE> would look like this:</p> 30<pre><Path>Skeleton.Bones["Bone1"].AnimatedTransform</Path></pre> 31<p>For now, please configure your settings for all bones, as was done in the example above.</p> 32 33<h3>Model (visibility) animation</h3> 34<p>Models that include model (visibility) animations are handled as follows.</p> 35 36<pre> 37<GraphicsAnimationGroupDescription Name="VisibilityAnimation" EvaluationTiming="BeforeWorldUpdate"><br> 38 <MemberInformationSet><br> 39 <AnimationMemberDescription BlendOperationName="Bool"><br> 40 <Path>IsVisible</Path><br> 41 </AnimationMemberDescription><br> 42 <AnimationMemberDescription BlendOperationName="Bool"><br> 43 <Path>Meshes["*"].IsVisible</Path><br> 44 </AnimationMemberDescription><br> 45 <AnimationMemberDescription BlendOperationName="Bool"><br> 46 <Path>IsBranchVisible</Path><br> 47 </AnimationMemberDescription><br> 48 <AnimationMemberDescription BlendOperationName="Bool"><br> 49 <Path>MeshNodeVisibilities["*"].IsVisible</Path><br> 50 </AnimationMemberDescription><br> 51 </MemberInformationSet><br> 52</GraphicsAnimationGroupDescription><br> 53</pre> 54<h3>Material Animation</h3> 55<p>The following is a model with material animation targeting all materials.</p> 56<pre> 57<GraphicsAnimationGroupDescription Name="MaterialAnimation" EvaluationTiming="AfterSceneCulling"><br> 58 <MemberInformationSet><br> 59 <AnimationMemberDescription BlendOperationName="RgbaColor"><br> 60 <Path>Materials["*"].MaterialColor.Emission</Path><br> 61 </AnimationMemberDescription><br> 62 <AnimationMemberDescription BlendOperationName="RgbaColor"><br> 63 <Path>Materials["*"].MaterialColor.Ambient</Path><br> 64 </AnimationMemberDescription><br> 65 <AnimationMemberDescription BlendOperationName="RgbaColor"><br> 66 <Path>Materials["*"].MaterialColor.Diffuse</Path><br> 67 </AnimationMemberDescription><br> 68 <AnimationMemberDescription BlendOperationName="RgbaColor"><br> 69 <Path>Materials["*"].MaterialColor.Specular0</Path><br> 70 </AnimationMemberDescription><br> 71 <AnimationMemberDescription BlendOperationName="RgbaColor"><br> 72 <Path>Materials["*"].MaterialColor.Specular1</Path><br> 73 </AnimationMemberDescription><br> 74 <AnimationMemberDescription BlendOperationName="RgbaColor"><br> 75 <Path>Materials["*"].MaterialColor.Constant0</Path><br> 76 </AnimationMemberDescription><br> 77 <AnimationMemberDescription BlendOperationName="RgbaColor"><br> 78 <Path>Materials["*"].MaterialColor.Constant1</Path><br> 79 </AnimationMemberDescription><br> 80 <AnimationMemberDescription BlendOperationName="RgbaColor"><br> 81 <Path>Materials["*"].MaterialColor.Constant2</Path><br> 82 </AnimationMemberDescription><br> 83 <AnimationMemberDescription BlendOperationName="RgbaColor"><br> 84 <Path>Materials["*"].MaterialColor.Constant3</Path><br> 85 </AnimationMemberDescription><br> 86 <AnimationMemberDescription BlendOperationName="RgbaColor"><br> 87 <Path>Materials["*"].MaterialColor.Constant4</Path><br> 88 </AnimationMemberDescription><br> 89 <AnimationMemberDescription BlendOperationName="RgbaColor"><br> 90 <Path>Materials["*"].MaterialColor.Constant5</Path><br> 91 </AnimationMemberDescription><br> 92 <AnimationMemberDescription BlendOperationName="RgbaColor"><br> 93 <Path>Materials["*"].TextureMappers["*"].Sampler.BorderColor</Path><br> 94 </AnimationMemberDescription><br> 95 <AnimationMemberDescription BlendOperationName="Int"><br> 96 <Path>Materials["*"].TextureMappers["*"].Texture</Path><br> 97 </AnimationMemberDescription><br> 98 <AnimationMemberDescription BlendOperationName="RgbaColor"><br> 99 <Path>Materials["*"].FragmentOperation.BlendOperation.BlendColor</Path><br> 100 </AnimationMemberDescription><br> 101 <AnimationMemberDescription BlendOperationName="Vector2"><br> 102 <Path>Materials["*"].TextureCoordinators["*"].Scale</Path><br> 103 </AnimationMemberDescription><br> 104 <AnimationMemberDescription BlendOperationName="Float"><br> 105 <Path>Materials["*"].TextureCoordinators["*"].Rotate</Path><br> 106 </AnimationMemberDescription><br> 107 <AnimationMemberDescription BlendOperationName="Vector2"><br> 108 <Path>Materials["*"].TextureCoordinators["*"].Translate</Path><br> 109 </AnimationMemberDescription><br> 110 </MemberInformationSet><br> 111</GraphicsAnimationGroupDescription><br> 112</pre> 113 114<h2>Animation descriptors listed under the <Camera> element</h2> 115<h3>Camera animation</h3> 116<pre> 117<GraphicsAnimationGroupDescription Name="CameraAnimation" EvaluationTiming="BeforeWorldUpdate"><br> 118 <MemberInformationSet><br> 119 <AnimationMemberDescription BlendOperationName="Transform" IsBinarized="true"><br> 120 <Path>Transform</Path><br> 121 </AnimationMemberDescription><br> 122 <AnimationMemberDescription BlendOperationName="Vector3" IsBinarized="true"><br> 123 <Path>ViewUpdater.TargetPosition</Path><br> 124 </AnimationMemberDescription><br> 125 <AnimationMemberDescription BlendOperationName="Float" IsBinarized="true"><br> 126 <Path>ViewUpdater.Twist</Path><br> 127 </AnimationMemberDescription><br> 128 <AnimationMemberDescription BlendOperationName="Vector3" IsBinarized="true"><br> 129 <Path>ViewUpdater.UpwardVector</Path><br> 130 </AnimationMemberDescription><br> 131 <AnimationMemberDescription BlendOperationName="Vector3" IsBinarized="true"><br> 132 <Path>ViewUpdater.ViewRotate</Path><br> 133 </AnimationMemberDescription><br> 134 <AnimationMemberDescription BlendOperationName="Float" IsBinarized="true"><br> 135 <Path>ProjectionUpdater.Near</Path><br> 136 </AnimationMemberDescription><br> 137 <AnimationMemberDescription BlendOperationName="Float" IsBinarized="true"><br> 138 <Path>ProjectionUpdater.Far</Path><br> 139 </AnimationMemberDescription><br> 140 <AnimationMemberDescription BlendOperationName="Float" IsBinarized="true"><br> 141 <Path>ProjectionUpdater.Fovy</Path><br> 142 </AnimationMemberDescription><br> 143 <AnimationMemberDescription BlendOperationName="Float" IsBinarized="true"><br> 144 <Path>ProjectionUpdater.AspectRatio</Path><br> 145 </AnimationMemberDescription><br> 146 <AnimationMemberDescription BlendOperationName="Float" IsBinarized="true"><br> 147 <Path>ProjectionUpdater.Height</Path><br> 148 </AnimationMemberDescription><br> 149 </MemberInformationSet><br> 150</GraphicsAnimationGroupDescription><br> 151</pre> 152 153<h2>Animation descriptors listed under the <Light> element</h2> 154<h3><FragmentLightCtr> (Fragment Light) Animation Descriptors</h3> 155<pre> 156<AnimationGroupDescriptions><br> 157 <GraphicsAnimationGroupDescription Name="LightAnimation" EvaluationTiming="BeforeWorldUpdate"><br> 158 <MemberInformationSet><br> 159 <AnimationMemberDescription BlendOperationName="Transform" IsBinarized="true"><br> 160 <Path>Transform</Path><br> 161 </AnimationMemberDescription><br> 162 <AnimationMemberDescription BlendOperationName="RgbaColor" IsBinarized="true"><br> 163 <Path>Ambient</Path><br> 164 </AnimationMemberDescription><br> 165 <AnimationMemberDescription BlendOperationName="RgbaColor" IsBinarized="true"><br> 166 <Path>Diffuse</Path><br> 167 </AnimationMemberDescription><br> 168 <AnimationMemberDescription BlendOperationName="RgbaColor" IsBinarized="true"><br> 169 <Path>Specular0</Path><br> 170 </AnimationMemberDescription><br> 171 <AnimationMemberDescription BlendOperationName="RgbaColor" IsBinarized="true"><br> 172 <Path>Specular1</Path><br> 173 </AnimationMemberDescription><br> 174 <AnimationMemberDescription BlendOperationName="Vector3" IsBinarized="true"><br> 175 <Path>Direction</Path><br> 176 </AnimationMemberDescription><br> 177 <AnimationMemberDescription BlendOperationName="Float" IsBinarized="true"><br> 178 <Path>DistanceAttenuationStart</Path><br> 179 </AnimationMemberDescription><br> 180 <AnimationMemberDescription BlendOperationName="Float" IsBinarized="true"><br> 181 <Path>DistanceAttenuationEnd</Path><br> 182 </AnimationMemberDescription><br> 183 <AnimationMemberDescription BlendOperationName="Bool" IsBinarized="true"><br> 184 <Path>IsLightEnabled</Path><br> 185 </AnimationMemberDescription><br> 186 </MemberInformationSet><br> 187 </GraphicsAnimationGroupDescription><br> 188</AnimationGroupDescriptions><br> 189</pre> 190 191<h3><AmbientLightCtr> (Ambient Light) Animation Descriptors</h3> 192<pre> 193<AnimationGroupDescriptions><br> 194 <GraphicsAnimationGroupDescription Name="LightAnimation" EvaluationTiming="BeforeWorldUpdate"><br> 195 <MemberInformationSet><br> 196 <AnimationMemberDescription BlendOperationName="Transform" IsBinarized="true"><br> 197 <Path>Transform</Path><br> 198 </AnimationMemberDescription><br> 199 <AnimationMemberDescription BlendOperationName="RgbaColor" IsBinarized="true"><br> 200 <Path>Ambient</Path><br> 201 </AnimationMemberDescription><br> 202 <AnimationMemberDescription BlendOperationName="Bool" IsBinarized="true"><br> 203 <Path>IsLightEnabled</Path><br> 204 </AnimationMemberDescription><br> 205 </MemberInformationSet><br> 206 </GraphicsAnimationGroupDescription><br> 207</AnimationGroupDescriptions><br> 208</pre> 209 210<h3><VertexLightCtr> (VertexLight) Animation Descriptors</h3> 211<pre> 212<AnimationGroupDescriptions><br> 213 <GraphicsAnimationGroupDescription Name="LightAnimation" EvaluationTiming="BeforeWorldUpdate"><br> 214 <MemberInformationSet><br> 215 <AnimationMemberDescription BlendOperationName="Transform" IsBinarized="true"><br> 216 <Path>Transform</Path><br> 217 </AnimationMemberDescription><br> 218 <AnimationMemberDescription BlendOperationName="RgbaColor" IsBinarized="true"><br> 219 <Path>Ambient</Path><br> 220 </AnimationMemberDescription><br> 221 <AnimationMemberDescription BlendOperationName="RgbaColor" IsBinarized="true"><br> 222 <Path>Diffuse</Path><br> 223 </AnimationMemberDescription><br> 224 <AnimationMemberDescription BlendOperationName="Vector3" IsBinarized="true"><br> 225 <Path>Direction</Path><br> 226 </AnimationMemberDescription><br> 227 <AnimationMemberDescription BlendOperationName="Float" IsBinarized="true"><br> 228 <Path>DistanceAttenuationConstant</Path><br> 229 </AnimationMemberDescription><br> 230 <AnimationMemberDescription BlendOperationName="Float" IsBinarized="true"><br> 231 <Path>DistanceAttenuationLinear</Path><br> 232 </AnimationMemberDescription><br> 233 <AnimationMemberDescription BlendOperationName="Float" IsBinarized="true"><br> 234 <Path>DistanceAttenuationQuadratic</Path><br> 235 </AnimationMemberDescription><br> 236 <AnimationMemberDescription BlendOperationName="Float" IsBinarized="true"><br> 237 <Path>SpotExponent</Path><br> 238 </AnimationMemberDescription><br> 239 <AnimationMemberDescription BlendOperationName="Float" IsBinarized="true"><br> 240 <Path>SpotCutoffAngle</Path><br> 241 </AnimationMemberDescription><br> 242 <AnimationMemberDescription BlendOperationName="Bool" IsBinarized="true"><br> 243 <Path>IsLightEnabled</Path><br> 244 </AnimationMemberDescription><br> 245 </MemberInformationSet><br> 246 </GraphicsAnimationGroupDescription><br> 247</AnimationGroupDescriptions><br> 248</pre> 249 250<h3><HemiSphereLightCtr> (Hemispherical Light) Animation Descriptors</h3> 251<pre> 252<AnimationGroupDescriptions><br> 253 <GraphicsAnimationGroupDescription Name="LightAnimation" EvaluationTiming="BeforeWorldUpdate"><br> 254 <MemberInformationSet><br> 255 <AnimationMemberDescription BlendOperationName="Transform" IsBinarized="true"><br> 256 <Path>Transform</Path><br> 257 </AnimationMemberDescription><br> 258 <AnimationMemberDescription BlendOperationName="RgbaColor" IsBinarized="true"><br> 259 <Path>GroundColor</Path><br> 260 </AnimationMemberDescription><br> 261 <AnimationMemberDescription BlendOperationName="RgbaColor" IsBinarized="true"><br> 262 <Path>SkyColor</Path><br> 263 </AnimationMemberDescription><br> 264 <AnimationMemberDescription BlendOperationName="Vector3" IsBinarized="true"><br> 265 <Path>Direction</Path><br> 266 </AnimationMemberDescription><br> 267 <AnimationMemberDescription BlendOperationName="Float" IsBinarized="true"><br> 268 <Path>LerpFactor</Path><br> 269 </AnimationMemberDescription><br> 270 <AnimationMemberDescription BlendOperationName="Bool" IsBinarized="true"><br> 271 <Path>IsLightEnabled</Path><br> 272 </AnimationMemberDescription><br> 273 </MemberInformationSet><br> 274 </GraphicsAnimationGroupDescription><br> 275</AnimationGroupDescriptions><br> 276</pre> 277 278<h2>Rules for Outputting Animation Curves</h2> 279<p>For bones influenced by skinning, an animation curve whose value does not change is not output if the value is the same as in the <CODE>.cmdl</CODE> file (i.e., the value is the same as the bind pose). </p> 280<p>For bones which are not influenced by skinning, even animation curves with values that do not change are output if settings have been configured for items like keys, IKs and constraints.</p> 281<p>For an animation curve with unchanging value, data are only output for one <CODE><LinearFloatKey></CODE>, as shown below:</p> 282<pre> 283<XSegmentsFloatCurve PreRepeatMethod="None" PostRepeatMethod="None" StartFrame="0" EndFrame="0"><br> 284 <Segments><br> 285 <LinearFloatSegment><br> 286 <Keys><br> 287 <LinearFloatKey Frame="0" Value="0" /><br> 288 </Keys><br> 289 </LinearFloatSegment><br> 290 </Segments><br> 291</XSegmentsFloatCurve><br> 292</pre> 293<p>In the case of skeletal animation, <CODE><MemberAnimationData></CODE> is not output for bones for which animation curves for Translate, Rotate and Scale are not all output.<br> However, for bones influenced by skinning, if settings have been configured for items like keys, IKs and constraints, then <CODE><MemberAnimationData></CODE> without animation curves is output, as shown below. In this state, the values in the <CODE>.cmdl</CODE> file are used for all translations, rotations and scaling.</p> 294<pre> 295<MemberAnimationData><br> 296 <Path>Skeleton.Bones["Bone1"].AnimatedTransform</Path><br> 297 <TransformAnimation /><br> 298</MemberAnimationData><br> 299</pre> 300 301<p><br><br><br><br></p> 302 303 <hr><p>CONFIDENTIAL</p></body> 304</html> 305