====== Part 11 - Running and Standing ======

Our little hero keeps running and facing the same direction.

He needs to be able to stand still when not running. To do this, we need to add an idle animation.

An idle animation would be simply playing hero frame 1 from the spritesheet over and over. Let's create a ''HeroIdle'' animation  in the ''HeroAnimationSet'' and set it as the starting animation:

<code=ini [highlight_lines_extra="4,5,6"]>
[HeroAnimationSet]
Texture = soldier_full.png
FrameSize = (32, 32, 0)
HeroRun = 6
HeroIdle = 1
StartAnim = HeroIdle
</code>

Like the run animation, we will give the idle animation a slow keyframe speed as it doesn't really need to update often:

<code ini>
[HeroIdle]
KeyDuration = 1.0
</code>

Some links are now needed. From here on, you are actually starting to build a graph of animations. Now that you have two animations, they can link in several ways:

  * Idle to Run
  * Run to Idle
  * Idle to Idle
  * Run to Run

Add all the possible links to ''HeroAnimationSet'':

<code=ini [highlight_lines_extra="5,7,8"]>
[HeroAnimationSet]
Texture = soldier_full.png
FrameSize = (32, 32, 0)
HeroRun = 6
HeroIdle = 1
StartAnim = HeroIdle
HeroIdle-> = HeroIdle # HeroRun
HeroRun-> = HeroRun # HeroIdle
</code>

The syntax above is a little strange. For example:


<code=ini>
HeroRun-> = HeroRun # HeroIdle
</code>

...means that when the ''HeroRun'' animation finishes, it could branch off to ''HeroRun'' again or ''HeroIdle'', depending what the current target animation is set to.

When the right key is pressed, the run animation,''HeroRun'', needs to play by setting it as the target animation. And when right is released, the target is set to ''HeroIdle'', and the graph must calculate it's way back to "Idle" as the animation to play:

<code=cpp [highlight_lines_extra="3,4,5,6"]>
if (orxInput_IsActive("GoRight"))
{
    orxObject_ApplyImpulse(hero, &rightSpeed, orxNULL);
    orxObject_SetTargetAnim(hero, "HeroRun");
} else {
    orxObject_SetTargetAnim(hero, "HeroIdle");
}
</code>

Compile and run. Pressing and holding right will start the run animation, and letting go will revert back to the idle animation. But notice it takes about a second for the animation to start.

This is because of the 1.0 set as the default duration on the [HeroIdle] section. We could reduce this duration value to something smaller, but a more correct way would be to ensure that any request to play the run animation is delivered immediately. Change the ''HeroIdle'' link from:

<code=ini>
HeroIdle-> = HeroIdle # HeroRun
</code>

to:

<code=ini>
HeroIdle-> = HeroIdle # .HeroRun
</code>

The introduction of the ''.'' symbol in front of the ''HeroRun'' means to stop executing the ''HeroIdle'' animation, and to skip immediately to the ''HeroRun'' animation.

Run that. Much better isn't it?

That takes care of running and stopping while facing right. But what about left?

Let's try that now.

----

Next: [[en:guides:beginners:changing_direction|Part 12 – Changing Direction]].

{{section>en:guides:beginners:toc&noheader&nofooter&noeditbutton}}