switchGesture: Difference between revisions

From Bohemia Interactive Community
(mass edit: removing obsolete </dt> and </dd> tags)
m (Some wiki formatting)
 
(55 intermediate revisions by 7 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________________________


| arma2 |= Game name
|arg= Local
|eff= Global


|1.00|= Game version
|game1= arma2
____________________________________________________________________________________________
|version1= 1.00


| When used on a person,the given move is started immediately (there is no transition). |= Description
|game2= arma2oa
____________________________________________________________________________________________
|version2= 1.50


| soldier '''switchGesture''' moveName |= Syntax
|game3= tkoh
|version3= 1.00


|p1= soldier:  -  |= PARAMETER1
|game4= arma3
|version4= 0.50


|p2= Object,moveName:  -  |= PARAMETER2
|gr1= Animations


|p3= |= PARAMETER3
|descr= When used on a person,the given move is started immediately (without transition).
{{Feature|arma3|
Since {{GVI|arma3|2.18|size= 0.75}} it is possible to play [[gestureState|gesture states]] (define in config under <sqf inline>"CfgGesturesMale" >> "states"</sqf> for male soldiers).
In addition, it is also possible to play [[animationState|move states]] (define in config under <sqf inline>"CfgMovesMaleSdr" >> "states"</sqf> for male soldiers) as gestures if they have a valid mask defined in their configs (for example, weapon switching animations have a "WeaponSwitching" mask that only affects the upper body, so they work correctly with this command).
}}
 
|s1= soldier [[switchGesture]] moveName
 
|p1= soldier: [[Object]]
 
|p2= moveName: [[String]]


| [[Nothing]] |= RETURNVALUE
|r1= [[Nothing]]


|s2= soldier [[switchGesture]] [moveName, time, blendFactor, resetAim]
|s2since= arma3 2.18


|x1= <code>soldierOne switchGesture "Wave"</code>|= EXAMPLE1
|p21= soldier: [[Object]]


____________________________________________________________________________________________
|p22= moveName: [[String]] - entry from <sqf inline>"CfgMovesMaleSdr" >> "states"</sqf> or <sqf inline>"CfgGesturesMale" >> "states"</sqf>


| |= SEEALSO
|p23= time: [[Number]] - (Optional, default 0) normalised time, in range 0..1, where 0 = beginning of the animation, and 1 = end of the animation


|  |= MPBEHAVIOUR
|p24= blendFactor: [[Number]] - (Optional, default 1) how much to blend the current animation with the new animation, in range 0..1, where 0 = current animation, and 1 = new animation. When 1 is used, the switching is instant (not smooth).
____________________________________________________________________________________________
 
}}
|p25= resetAim: [[Boolean]] - (Optional, default true) whether the aim/head direction should be reset after switching
 
|r2= [[Nothing]]
 
|x1= <sqf>soldierOne switchGesture "Wave";</sqf>


<h3 style='display:none'>Notes</h3>
|x2= <sqf>
<dl class='command_description'>
// Create a dummy agent that copies your moves
<!-- Note Section BEGIN -->
ai1 = createAgent [typeOf player, getPosATL player, [], 0, "NONE"];
ai1 disableAI "ALL";


<dd class="notedate">Posted on August 31, 2010
onEachFrame
<dt class="note">'''[[User:kju|kju]]'''
{
<dd class="note">
ai1 setAnimSpeedCoef getAnimSpeedCoef player;
Rpt says "Not implemented" as of OA 1.54.
ai1 setVectorDir vectorDir player;
private _m = animationState player;
private _g = gestureState player;
private _i = getUnitMovesInfo player;
private _a = getUnitMovesInfo ai1;


if (animationState ai1 != _m || abs(_i # 1 - _a # 1) > 0.1) then
{
ai1 switchMove [_m, _i # 0, _i # 3, false];
};


<!-- Note Section END -->
if ((gestureState ai1 != _g || abs(_i # 6 - _a # 6) > 0.1) && (_g != "<none>" && _g find "_player" < 0)) then
</dl>
{
ai1 switchGesture [_g, _i # 5, _i # 8, false];
};
}
</sqf>


<h3 style='display:none'>Bottom Section</h3>
|seealso= [[playGesture]] [[getUnitMovesInfo]] [[switchMove]]
[[Category:ArmA 2: New Scripting Commands List|{{uc:{{PAGENAME}}}}]]
}}
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
 
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
{{Note
|user= .kju
|timestamp= 20100831184200
|text= Rpt says "Not implemented" as of OA 1.54.
}}

Latest revision as of 13:08, 29 December 2025

Logo A2.png 1.00A2 OA Logo.png 1.50tkoh logo small.png 1.00Arma 3 logo black.png 0.50
LALocalGEGlobal
Hover & click on the images for description

Description

Description:
When used on a person,the given move is started immediately (without transition).
Arma 3
Since Arma 3 logo black.png 2.18 it is possible to play gesture states (define in config under "CfgGesturesMale" >> "states" for male soldiers). In addition, it is also possible to play move states (define in config under "CfgMovesMaleSdr" >> "states" for male soldiers) as gestures if they have a valid mask defined in their configs (for example, weapon switching animations have a "WeaponSwitching" mask that only affects the upper body, so they work correctly with this command).
Groups:
Animations

Syntax

Syntax:
soldier switchGesture moveName
Parameters:
soldier: Object
moveName: String
Return Value:
Nothing

Alternative Syntax

Syntax:
soldier switchGesture [moveName, time, blendFactor, resetAim]
Parameters:
soldier: Object
moveName: String - entry from "CfgMovesMaleSdr" >> "states" or "CfgGesturesMale" >> "states"
time: Number - (Optional, default 0) normalised time, in range 0..1, where 0 = beginning of the animation, and 1 = end of the animation
blendFactor: Number - (Optional, default 1) how much to blend the current animation with the new animation, in range 0..1, where 0 = current animation, and 1 = new animation. When 1 is used, the switching is instant (not smooth).
resetAim: Boolean - (Optional, default true) whether the aim/head direction should be reset after switching
Return Value:
Nothing

Examples

Example 1:
soldierOne switchGesture "Wave";
Example 2:
// Create a dummy agent that copies your moves ai1 = createAgent [typeOf player, getPosATL player, [], 0, "NONE"]; ai1 disableAI "ALL"; onEachFrame { ai1 setAnimSpeedCoef getAnimSpeedCoef player; ai1 setVectorDir vectorDir player; private _m = animationState player; private _g = gestureState player; private _i = getUnitMovesInfo player; private _a = getUnitMovesInfo ai1; if (animationState ai1 != _m || abs(_i # 1 - _a # 1) > 0.1) then { ai1 switchMove [_m, _i # 0, _i # 3, false]; }; if ((gestureState ai1 != _g || abs(_i # 6 - _a # 6) > 0.1) && (_g != "<none>" && _g find "_player" < 0)) then { ai1 switchGesture [_g, _i # 5, _i # 8, false]; }; }

Additional Information

See also:
playGesture getUnitMovesInfo switchMove

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord.
Only post proven facts here! Add Note
.kju - c
Posted on Aug 31, 2010 - 18:42 (UTC)
Rpt says "Not implemented" as of OA 1.54.
Retrieved from "https://community.bistudio.com/wiki?title=switchGesture&oldid=376921"