Code34/Sandbox – User

General cases

There are two ways to create animations:

• about vehicles or objects, you will have to use Model Config.
• about characters, animals, then you have to use a CfgMoves Config Reference.

The difference between the two methods is that the config model permits simple animations (like rotations around axes), while the other method permits more complex animations (with states) described in a RTM file. Both methods must be declared in an adddon file.

Car with animated doors & trunk

Quick start: Model Config example

This example talks about simple, single-p3d animations, where parts of a model rotate around an axis (like a car door, or a tank turret).

To create a model animations, there are requirements:

1. Create the movable object in the ResolutionLOD and give it a name.
   
2. If the animation would affect the ( Fire) GeometryLOD, copy the selection into those LODs as well.
   
3. In the MemoryLOD define the rotational axis via two vertexes. Select both of those points and give them a name.
   
4. Still in the MemoryLOD create a single vertex (this will be the 'action point') and give it a name.

The following example is for an object that has been named 'door', which turns around an axis named 'door axis'. The 'action point' (the position the player has to be close to, in order to be able to activate this animation) is called 'doorbell'. In the Config.cpp for your model you need to define two classes: Animations & UserActions. The Animations class defines how the object moves, and the UserActions class defines when it moves.

config.cpp

class CfgModels {
	class door {
		class Animations
		{
			class MoveDoor
			{
				type = "rotation";	// always "rotation"
				animPeriod = 1;		// how long it takes for the movevement to finish
				selection = "door";	// the name of the moving object
				axis = "door axis";	// the name of the axis
				angle0 = 0;			// the start angle
				angle1 = -2.0;		// the end angle, in radians (= degrees/57.3 = degrees * 180/pi)
			};
		};

		class UserActions
		{
			class OpenDoor // action to open the door
			{
				displayName = "Open Door";	// string that's displayed in the action menu
				position = "doorbell";		// name of the 'action point'
				radius = 1.5;				// how close the player has to be see this action
				condition = "this animationPhase ""MoveDoor"" < 0.5";	// check whether the door has moved already
				statement = "this animate[""MoveDoor"", 1]";			// and if not, then start the animation
				onlyForPlayer = true;		// requirement by ArmA - presumably defines if AI can/cannot open doors etc
			};
			class CloseDoor // action to close the door
			{
				displayName = "Close Door";
				position = "doorbell";
				radius = 1.5;
				condition = "this animationPhase ""MoveDoor"" < 0.5";
				statement = "this animate[""MoveDoor"", 0]";
				onlyForPlayer = true; 
			};
		};
	};
};

Quick start: CfgMoves example

This example describes an anim of holding rifle with one hand with the other hanging on the side. You are able to shoot in this position. It lasts for 5 seconds and returns to default pose (Weapon Raised Standing position).

To create a CfgMoves animations, there are requirements:

1. Create your animation file with an external tool like Blender
2. Export it to RTM file format
3. Prepare an addon with your P3D file and RTM anim

The config file of your addon must describes the animations in the Cfgmoves section. In the case of our example, it is useless to use an RTM file because Arma's animation is used.

config.cpp

class CfgMovesBasic; // Reference CfgMovesBasic. 
class CfgMovesMaleSdr: CfgMovesBasic // Override CfgMovesMaleSdr
{
	skeletonName="OFP2_ManSkeleton"; 
	gestures="CfgGesturesMale"; 
	class States
	{
		class AmovPercMstpSrasWrflDnon;
		class MyAnimation : AmovPercMstpSrasWrflDnon
		{
			looped = 0;
			speed = -5;
			file = "myaddons\myanimation.rtm";
			canBlendStep = 0;
			minPlayTime= 0.95;
			InterpolateTo[] = {"AmovPercMstpSrasWrflDnon", 0.5};
		};
	};
};