Softimage/html/animation.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta http-equiv="Content-Style-Type" content="text/css">
<link rel="stylesheet" href="css/manpage.css" type="text/css">
<title>Animation</title>
</head>
<body>

<h1>Animation</h1>

<p>This chapter describes procedures and precautions for creating animations using NintendoWare in Softimage.</p>
<p>
<a href="#common">Animation Overview</a><br> <a href="#chara_anim">Character Animation</a><br> <a href="#vis_anim">Visibility Animation</a><br> <a href="#color_anim">Color Animation</a><br> <a href="#tex_pat_anim">Texture Pattern Animation</a><br> <a href="#tex_srt_anim">Texture SRT Animation</a><br>

<a href="#scene_anim">Scene Animation</a><br>
</p>

<h2><a name="common">Animation Overview</a></h2>

<h3><a name="make_curve">Automatically Creating Animation Data</a></h3>
<p>If the Export option <strong>Bake All Animation</strong> is ON or if the animation curve in Softimage cannot be output as-is, animation curve data will be automatically created from the data baked from all frames.<BR> Animation data is always automatically created and output from baked data in the following cases.</p>
<ul>
<li>When the horizontal axis of the animation curve does not represent the time axis (such as with pass line animations and link animations).</li>
<li>Animation curves are partially disabled on the dope sheet.</li>
<li>When the animation is expression-dependent.</li>
<li>The animation uses animation mixers.</li>
</ul>
<p>The rotational value automatically generates animation curve data after adjusting the baked data so that it is continuous and has a small absolute value.</p>
<p>All values in the output range are output for baked animations.<BR> All animations using extrapolation are also baked, but not reflected in the animation curve repeat type.<BR> Plans call for providing support for the repeat type of baked animations.
</p>


<h3><a name="cmdl_attr">About Animation Curve Extrapolation Mode</a></h3>
<p>If the Export option <strong>Bake All Animation</strong> is OFF, the animation curve extrapolation mode is referenced and repeat mode is output.  Repeat is output and other cases are ignored only when the extrapolation mode is Cycle.</p>


<h3 id="loop_anim">Loop Animation</h3>
<p>When Loop is set ON in the <a href="export.html#options_anim">Export option</a><!--や <a href="set_action.html">NW4R Set Action プラグイン</a>-->, specify <B>the End Frame so the conditions are the same as for the Start Frame</B>.

For instance, if animation is being looped under Softimage and frame 1 and frame 10 are the same, specify 1 for the start frame and 10 for the end frame.</p>
<p><img src="images/LoopAnimCurve1.gif" alt="LoopAnimCurve1" border="0" /></p>
<p>Whether looping is set on or off, the <strong>FrameSize</strong> in the intermediate file is = (EndFrame - StartFrame).</p>

<h3><a name="cmdl_attr">Values Output to CMDL Files</a></h3>
<p>If attributes are being animated, values for the start frame specified with the Export option are output to the CMDL file. Note, however, that bind pose values will be output for the translate, rotate and scale nodes, which are affected by skinning.<br> Note: Be aware that the values of the current frame in Softimage are not the values being output.</p>


<h2><a name="vis_anim">Visibility animation</a></h2>

<p>
This type of animation controls the <B>Visibility</B> attribute of a node to make it displayed or hidden.<br> Visibility animation data is output to the intermediate file as an CMDLA file.
</p>
<p>
To configure a visibility animation, set the animation curve to <B>View Visibility</B>.
</p>
<p><img src="images/vis_anim1.gif" border="0"></p>

<table border="1" class="arguments"><tbody><tr><td>
When the Export option <a href="export.html#options_compress_node">Compress Node</a> has been set to <B>Cull Useless Node</B> or <B>Cull Uninfluential Node</B>, make sure nodes which have visibility animations configured are not compressed, since visibility animation is set on a node basis. (You can set the compression disable flag using the <a href="data_plugins.html#no_compress_node">NW4C Set No Compress Node Plug-in</a>).<br> When using shape animation, do not set the <CODE>Compress Node</CODE> Export option to <strong>Unite Compressible Node</strong> or <strong>Unite All Node</strong>.<br>
</td></tr></tbody></table>


<h2><a name="color_anim">Color Animation</a></h2>

<h3><a name="diffuse_color">Diffuse, Specular, Incandescence Color</a></h3>

<p>
Color animations are set by animating the <CODE>Color</CODE>, <CODE>Transparency (R value)</CODE>, <CODE>Specular Color</CODE> and <CODE>Incandescence Color </CODE>of material nodes.<br> When Enable is used to configure ON/OFF animations, in the OFF state these colors are output as black. Animation data is always automatically created and output from baked data in the following cases.
<ul>
<li>If an animation has been set for enable.
<li>Incandescene Color animation.
</ul>
</p>

<h3><a name="polgon_alfha">Polygon Alpha</a></h3>
<p>
This configures animation for <CODE>Transparency</CODE>.<br> If <B>Enable </B>is turned OFF, the object is treated as opaque. If <B>Enable</B> is on and <B>UseAlpha</B> is also  turned on, an animation configured for the Alpha values is output to the intermediate file as the <CODE>diffuse</CODE> alpha value.<br> If <B>UseAlpha</B> is OFF, an animation configured for the Red Color values is output to an intermediate file. (Green and Blue values are ignored.)
</p>

<table border="1" class="arguments"><tbody><tr><td>
If the Export option for material compression is enabled, even materials for which color animation is not set sometimes get animated as a result of material collecting. If this happens, use the <a href="data_plugins.html#mat_attr">NW4C Set Material Attribute</a> plug-in to change settings so that materials for which color animation is set are not compressed.
</td></tr></tbody></table>


<h2><a name="tex_pat_anim">Texture Pattern Animation</a></h2>

<p>
This type of animation swaps textures.<br> Texture pattern animation data can be output to the intermediate file as a material animation (.cmata file).
</p>

<h3><a name="tex_set">Setting Attributes</a></h3>

<p>
Texture pattern animation settings use either sequential textures or SCR files supported as standard by Softimage.<br>
<ol>
An SCR file is a text-format file with file extension <CODE>.scr</CODE>.<br> In an SCR file, the absolute path to the texture image file to be displayed in the nth frame (where n is an integer greater than or equal to 1) under Softimage is written on the SCR file's nth line. This allows you to animate displays by swapping texture patterns by frame number by specifying an SCR file, rather than specifying a texture image file for each Image node in Softimage as is commonly done. These cannot be specified for negative frames having a value equal to or less than 0.
</ol>

<p>

Sequential textures are textures that have been given sequential numbers, such as <CODE>p.1.tga</CODE>, <CODE>p.2.tga</CODE>, and <CODE>p.3.tga</CODE>.<br><br> Whether you use SCR files or sequential textures, edits made using the Warp feature of Softimage (a feature for editing the correspondence between frames and textures using a graph) are not applied.
</p>


<h2><a name="tex_srt_anim">Texture SRT Animation</a></h2>

<p>
This type of animation varies the SRT of a texture by manipulating a texture matrix.<br> Texture SRT animation data can be output to the intermediate file as an CMATA file.
</p>
<p>
For texture animation, animation curve data is always automatically created and output from baked data.
</p>

<h3><a name="tex_set">Setting Attributes</a></h3>

<p>
Texture SRT animations are configured according to the procedure below.<br> Apply textures in Softimage,and open the <B>Texture Projection</B> property editor. Move to the frame you want to configure, and set animation keys for <B>ScalingU</B>, <B>ScalingV</B>, <B>RotationW</B>, <B>Translation U</B>, and <B>Translation V</B>.
</p>

<table border="1" class="arguments"><tbody><tr><td>
If the Export option for material compression is enabled, even materials for which texture SRT animation is not set are sometimes animated as a result of materials collecting. If this happens, use the <a href="data_plugins.html#mat_attr">NW4C Set Material Attribute plug-in</a> to change the settings so materials are not compressed if texture SRT animation has been set for them.
</td></tr></tbody></table>


<h2><a name="scene_anim">Scene Animation</a></h2>
<p>
Scene animations are configured by animating the camera and light attributes.<br>
</p>
<h3><a name="camera">Camera</a></h3>
<p>
<ul>
<li>Camera Types
	<p>Supported camera types are: Perspective, Telephoto, Wide Angle, and Orthographic.
	</p></li>
<li>Cameras that are not output
	<p>A camera will not be output if its Visibility property <B>View Visibility</B> is OFF.
	</p></li>

<li>Aspect Ratio
	<p>The aspect ratio is set by selecting <B>Primitive</B> &gt; <B>Pict. Ratio</B> under Camera Properties, or <B>Projection Plane</B> &gt; <B>Film Aperture (Fixed Aspect Ratio OFF)</B>.<br>
	</p></li>
<li>Angle of View
	<p>Angle of view is set by selecting <B>Primitive</B> &gt; <B>Field Of View</B> &gt; <B>Angle</B> under Camera Properties or <B>Projection Plane</B> &gt; <B>Film Aperture (Fix Aspect Ratio ON)</B>. Since vertical Field of View (Fovy) is output to the intermediate file, if <B>Primitive</B> &gt; <B>Field Of View</B> is set to <B>Horizontal</B>, convert it to <B>Vertical Field of View</B> before exporting. The relationship between Horizontal Angle of View and Vertical Angle of View is determined by the Aspect Ratio.<BR> The relationship between the Vertical Field of View (Fovy) and the Horizontal Field of View (Fovx) is given by the following formula:
	<pre>Fovy = 2 * atan( tan( Fovx * 0.5 ) / aspect )</pre>
	<p></p></li>

<li>Attributes For Which Animation Can be Set
	<p>The following is a list of attributes that can be configured with animation:</p>
<ul>
<li>  The camera kinematics <B>Translate</B> and <B>Rotate</B> (Rotate is only supported by Rotate type cameras) (Global coordinates)</li>
<li>  The kinematics <B>Translate</B> of the camera-direction constraint destination (Camera_Interest) (for Aim type cameras) (Global coordinates)</li>
<li>  The kinematics <B>Translate</B> of up-vector control objects (when using up-vector control objects) (Global coordinates)</li>
<li>  Up-vector Roll (when the up-vector is active)</li>
<li>  The camera properties Picture Ratio (controlled by Film Aperture X/Y), Field of View - Angle, Clipping Plane (Forward/Reverse), Focal Distance, and Ortho Height.</li>
</ul>
<p></p></li>
<br/> <br/>

</ul>
<p></p>

<h3><a name="light">Lights</a></h3>
<p>
<ul>
<li>Light Types
	<p>Supported light types are: Infinite, Point, and Spot.<br> <B>Render</B> &gt; <B>Edit</B> &gt; <B>Ambience</B> converts light into ambient light. However, there can only be one ambient light.
	</p></li>
<li>Lights that are not output
	<p>A light is not output if the Visibility property <B>View Visibility</B> is not animated and is OFF.
	</p></li>
<li>The Spotlight's <CODE>Visibility</CODE> property
	<p>A spotlight is not output if either its own <CODE>Visibility</CODE> or the <CODE>Visibility</CODE> of <CODE>Spot_Root</CODE> is OFF.</p></li>
<li>Light Contribution
	<p>If the light property <B>Light Contribution</B> &gt; <B>Specular</B> is ON, then the <CODE>color </CODE>value is output as specular color.<br/> If it is OFF, then black is output to the specular color.
	<p>If the light property <B>Light Contribution</B> &gt; <B>Diffuse</B> is ON, then the <CODE>color </CODE>value is output as diffuse color.<br/> If it is OFF, then black is output to the diffuse color.
	</p></li>
<li>Ambient color
<p>Black is always exported for the ambient color of Infinite, Point, and Spot light types.</p></li>

<li>Specular Color 0, Specular Color 1
	<p>The intermediate file can have two settings for specular color, but the same value is output for both from Softimage.
	</p></li>

<li>Attributes For Which Animation Can be Set
	<p>The following is a list of attributes that can be configured with animation:</p>
<ul>
<li>  The light kinematics <B>Translate </B>and <B>Rotate</B> (Global Coordinates)</li>
<li>  The light Visibility property <B>View Visibility</B> (except for Ambient Lights)</li>
<li>  The light <B>Color</B> and <B>Intensity</B></li>
<li>  Ambient Light <B>Color</B></li>
<li>  <B>Intensity </B>is output as the alpha component of the light color. (Valid values range between 0.0 and 1.0. (Valid values are 0.0 through 1.0 and correspond to alpha values ranging from 0 to 255 in the intermediate file.)<br/>However, 1 is always exported for the alpha value of the ambient color of Ambient Lights and Lights. </li>
<li>  The kinematics <strong>Translate</strong> of the spot light <CODE>Interest</CODE> node (Global Coordinates).</li>
</ul>
	<p></p></li>

<p></p>
<p><br></p>
</ul>

<h2 id="limitation_anim">Animation Limitations</h2>
<p>Currently <strong>shape animations (moprhing)</strong> cannot be used.</p>

<hr><p>CONFIDENTIAL</p></body>
</html>