Difference between revisions of "switchMove"

From Bohemia Interactive Community
Jump to navigation Jump to search
(CapItaLisaTION)
m (Replaced <code> with <sqf>)
 
(58 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Command|= Comments
+
{{RV|type=command
____________________________________________________________________________________________
 
  
| ofp |= Game name
+
|game1= ofp
 +
|version1= 1.00
  
|1.00|= Game version
+
|game2= ofpe
 +
|version2= 1.00
  
|arg= local |= Arguments in MP
+
|game3= arma1
 +
|version3= 1.00
  
|eff= global |= Effects in MP
+
|game4= arma2
____________________________________________________________________________________________
+
|version4= 1.00
  
| Applies given animation to a unit. When used on a person, the given move is started immediately (there is no transition). Use <tt>_unit [[switchMove]] "";</tt> to reset animation. For a smooth transition use [[playMove]].<br><br>
+
|game5= arma2oa
 +
|version5= 1.50
  
{{Informative | This command has global effect when executed locally to the unit and will sync for JIP. In this case the animation on the executing machine is immediate while on remote machines it will be transitional. In order for the animation to change immediately on every PC in multiplayer, use global remote execution (see example 2). When the argument is remote, the animation change on the executing PC is only temporary. }}<br>
+
|game6= tkoh
 +
|version6= 1.00
  
[[:ArmA2:_Moves|List of moves in ArmA 2]]<br />
+
|game7= arma3
[[:Armed_Assault:_Moves_List|List of moves in Armed Assault]]<br />
+
|version7= 0.50
[[:Operation_Flashpoint:_Moves_List|List of moves in Operation Flashpoint: Resistance]] |= Description
 
____________________________________________________________________________________________
 
  
| person '''switchMove''' movename |= Syntax
+
|arg= local
  
|p1= person: [[Object]] - unit  |= Parameter 1
+
|eff= global
  
|p2= movename: [[String]] - unit animation (see [[animationState]])|= Parameter 2
+
|gr1= Animations
  
| [[Nothing]] |= Return value
+
|descr= Immediately applies given animation to the unit. For a smooth transition from the current animation, use [[playMove]].
____________________________________________________________________________________________
+
{{Feature | Informative | see [[:Category:Moves]] for respective games animations.}}
 
+
This command first resets the unit's animation states (including aiming state, gesture state, etc.) then puts the unit in the first frame of the animation (therefore showing no transition).
|x1= Prone: <code>[[player]] [[switchMove]] "amovppnemstpsraswrfldnon";</code> |= Example 1
+
If an invalid animation is provided, the unit's animations will be reset but no new animation will be played (see {{HashLink|#Example 3}}).
|x2= Sit player immediately and globally: <code><nowiki>[</nowiki>[[player]], "amovpsitmstpslowwrfldnon"] [[remoteExec]] ["switchMove", 0];</code> |= Example 2
 
____________________________________________________________________________________________
 
  
| [[playMove]], [[playMoveNow]], [[switchAction]], [[playAction]], [[playActionNow]] |= See also
+
|mp= This command has global effect when executed locally to the unit and will sync for JIP. In this case the animation on the executing machine is immediate while on remote machines it will be transitional. In order for the animation to change immediately on every PC in multiplayer, use global remote execution (see {{HashLink|#Example 2}}). When the argument is remote, the animation change on the executing PC is only temporary.
  
 +
|s1= person [[switchMove]] moveName
 +
 +
|p1= person: [[Object]] - unit
 +
 +
|p2= moveName: [[String]] - animation state (see [[animationState]])
 +
 +
|r1= [[Nothing]]
 +
 +
|x1= Prone:
 +
<sqf>player switchMove "AmovPpneMstpSrasWrflDnon";</sqf>
 +
 +
|x2= Sit player immediately and globally:
 +
<sqf>[player, "AmovPsitMstpSlowWrflDnon"] remoteExec ["switchMove", 0];</sqf>
 +
 +
|x3= Resets unit's animation:
 +
<sqf>_unit switchMove "";</sqf>
 +
 +
|seealso= [[playMove]] [[playMoveNow]] [[switchAction]] [[playAction]] [[playActionNow]]
 
}}
 
}}
  
<h3 style="display:none">Notes</h3>
 
 
<dl class="command_description">
 
<dl class="command_description">
<!-- Note Section BEGIN -->
 
 
<dd class="notedate">Posted on March 25, 2007 - 23:48
 
<dt class="note">'''[[User:Hurricane|Hurricane]]'''<dd class="note">
 
  
 +
<dt><dt>
 +
<dd class="notedate">Posted on March 25, 2007 - 23:48</dd>
 +
<dt class="note">[[User:Hurricane|Hurricane]]</dt>
 +
<dd class="note">
 
In some cases the movement won't stay. I.e. AI hostages that put their hands behind their heads (_hostage [[switchMove]] "AmovPercMstpSsurWnonDnon") won't hold their hands up, unless you first use [[disableAI]] "autoTarget" on them. They mostly put their hands down because they 'noticed' unknown objects.
 
In some cases the movement won't stay. I.e. AI hostages that put their hands behind their heads (_hostage [[switchMove]] "AmovPercMstpSsurWnonDnon") won't hold their hands up, unless you first use [[disableAI]] "autoTarget" on them. They mostly put their hands down because they 'noticed' unknown objects.
 +
</dd>
  
<dd class="notedate">Posted on August 03, 2008 - 22:43
+
<dt><dt>
<dt class="note">'''[[User:Killswitch|Killswitch]]'''<dd class="note">
+
<dd class="notedate">Posted on August 03, 2008 - 22:43</dd>
 +
<dt class="note">[[User:Killswitch|Killswitch]]</dt>
 +
<dd class="note">
 
This command will not cause an [[ArmA:_Event_Handlers#AnimChanged|AnimChanged]] or [[ArmA:_Event_Handlers#AnimDone|AnimDone]] event. However, [[playMove]] will.
 
This command will not cause an [[ArmA:_Event_Handlers#AnimChanged|AnimChanged]] or [[ArmA:_Event_Handlers#AnimDone|AnimDone]] event. However, [[playMove]] will.
 +
</dd>
  
<!-- Note Section END -->
+
<dt><dt>
</dl>
 
 
 
<h3 style="display:none">Bottom Section</h3>
 
 
 
<!-- CONTINUE Notes -->
 
<dl class="command_description">
 
 
<dd class="notedate">Posted on November 12, 2016 - 20:11 (UTC)</dd>
 
<dd class="notedate">Posted on November 12, 2016 - 20:11 (UTC)</dd>
 
<dt class="note">[[User:AgentRevolution|AgentRev]]</dt>
 
<dt class="note">[[User:AgentRevolution|AgentRev]]</dt>
 
<dd class="note">
 
<dd class="note">
When using this command on the [[player]] unit outside [[Scheduler#Unscheduled_Environment|unscheduled]] UI contexts, it will cause a minor camera glitch for a single frame.<br/>
+
When using this command on the [[player]] unit outside [[Scheduler#Unscheduled_Environment|unscheduled]] UI contexts, it will cause a minor camera glitch for a single frame.<br>
For example,  [[Arma_3:_Event_Handlers/addMissionEventHandler#Draw3D|Draw3D]] and [[displayAddEventHandler|KeyDown]] are UI contexts and so are not affected by the glitch, but [[Arma_3:_Event_Handlers/addMissionEventHandler#EachFrame|EachFrame]] and [[Scheduler#Scheduled_Environment|scheduled]] scripts are not UI contexts and are affected by the glitch.
+
For example,  [[Arma 3: Mission Event Handlers#Draw3D|Draw3D]] and [[displayAddEventHandler|KeyDown]] are UI contexts and so are not affected by the glitch, but [[Arma 3: Mission Event Handlers#EachFrame|EachFrame]] and [[Scheduler#Scheduled_Environment|scheduled]] scripts are not UI contexts and are affected by the glitch.
 +
</dd>
 +
 
 +
<dt></dt>
 +
<dd class="notedate">Posted on August 8, 2021 - 15:59 (UTC)</dd>
 +
<dt class="note">[[User:Leopard20|Leopard20]]</dt>
 +
<dd class="note">
 +
If the animation you're trying to use with this command has no connection/interpolation to the unit's base animation (usually "AmovPercMstpSrasWrflDnon"), the move might not play using [[switchMove]] alone. In such cases you have to do this:
 +
<sqf>_unit switchMove _move; _unit playMoveNow _move;</sqf>
 +
This must run in the [[Scheduler|'''unscheduled environment''']] (see [[isNil]])
 
</dd>
 
</dd>
 
</dl>
 
</dl>
<!-- DISCONTINUE Notes -->
 
 
[[Category:Scripting Commands|SWITCHMOVE]]
 
[[Category:Scripting Commands OFP 1.99|{{uc:{{PAGENAME}}}}]]
 
[[Category:Scripting Commands OFP 1.96|SWITCHMOVE]]
 
[[Category:Scripting Commands OFP 1.46|SWITCHMOVE]]
 
[[Category:Scripting Commands ArmA|SWITCHMOVE]]
 
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
 
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
 
[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]
 

Latest revision as of 17:17, 14 May 2022

Hover & click on the images for description

Description

Description:
Immediately applies given animation to the unit. For a smooth transition from the current animation, use playMove.
see Moves for respective games animations.

This command first resets the unit's animation states (including aiming state, gesture state, etc.) then puts the unit in the first frame of the animation (therefore showing no transition).

If an invalid animation is provided, the unit's animations will be reset but no new animation will be played (see Example 3).
Multiplayer:
This command has global effect when executed locally to the unit and will sync for JIP. In this case the animation on the executing machine is immediate while on remote machines it will be transitional. In order for the animation to change immediately on every PC in multiplayer, use global remote execution (see Example 2). When the argument is remote, the animation change on the executing PC is only temporary.
Groups:
Animations

Syntax

Syntax:
person switchMove moveName
Parameters:
person: Object - unit
moveName: String - animation state (see animationState)
Return Value:
Nothing

Examples

Example 1:
Prone:
player switchMove "AmovPpneMstpSrasWrflDnon";
Example 2:
Sit player immediately and globally:
[player, "AmovPsitMstpSlowWrflDnon"] remoteExec ["switchMove", 0];
Example 3:
Resets unit's animation:
_unit switchMove "";

Additional Information

See also:
playMove playMoveNow switchAction playAction playActionNow

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note
Posted on March 25, 2007 - 23:48
Hurricane
In some cases the movement won't stay. I.e. AI hostages that put their hands behind their heads (_hostage switchMove "AmovPercMstpSsurWnonDnon") won't hold their hands up, unless you first use disableAI "autoTarget" on them. They mostly put their hands down because they 'noticed' unknown objects.
Posted on August 03, 2008 - 22:43
Killswitch
This command will not cause an AnimChanged or AnimDone event. However, playMove will.
Posted on November 12, 2016 - 20:11 (UTC)
AgentRev
When using this command on the player unit outside unscheduled UI contexts, it will cause a minor camera glitch for a single frame.
For example, Draw3D and KeyDown are UI contexts and so are not affected by the glitch, but EachFrame and scheduled scripts are not UI contexts and are affected by the glitch.
Posted on August 8, 2021 - 15:59 (UTC)
Leopard20
If the animation you're trying to use with this command has no connection/interpolation to the unit's base animation (usually "AmovPercMstpSrasWrflDnon"), the move might not play using switchMove alone. In such cases you have to do this:
_unit switchMove _move; _unit playMoveNow _move;
This must run in the unscheduled environment (see isNil)