Code34/Sandbox – User

From Bohemia Interactive Community
Jump to navigation Jump to search
No edit summary
(Replaced content with "== Todo ==")
Tag: Replaced
 
(6 intermediate revisions by the same user not shown)
Line 1: Line 1:
== General cases ==
== Todo ==
 
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_%28Animation%29_File_Format | RTM]] file. Both methods must be declared in an adddon file.
 
[[Image:AnimatedDoors.jpg|right|thumb|200px|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:
# Create the movable object in the [[LOD#.3CResolution.3E | ResolutionLOD]] and give it a name.<br>
# If the animation would affect the ([[LOD#Fire_Geometry | Fire]])[[LOD#Geometry | GeometryLOD]], copy the selection into those LODs as well.<br>
# In the [[LOD#Memory | MemoryLOD]] define the rotational axis via two vertexes. Select both of those points and give them a name.<br>
# Still in the [[LOD#Memory | 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 ====
<syntaxhighlight lang="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;
};
};
};
};
</syntaxhighlight>
 
== 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:
# Create your animation file with an external tool like Blender
# Export it to RTM file format
# 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 ====
<syntaxhighlight lang="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";
canBlendStep = 0;
minPlayTime= 0.95;
InterpolateTo[] =
{
"AmovPercMstpSrasWrflDnon", 0.5 
};
};
};
}; 
</syntaxhighlight>
 
{{GameCategory|ofp|Modelling}}
{{GameCategory|ofpe|Modelling}}
{{GameCategory|arma1|Addon Editing}}

Latest revision as of 20:53, 22 February 2021

Todo

Retrieved from "https://community.bistudio.com/wiki?title=User:Code34/Sandbox&oldid=249395"